REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

{
  "channelId": string,
  "negative": boolean
}

string (int64 format)

חובה. המזהה של הערוץ. צריך להפנות לשדה מזהה הערוץ במשאב ערוץ בבעלות שותף או ערוץ בבעלות המפרסם.

boolean

מציין אם האפשרות הזו מטורגטת באופן שלילי. באפשרות הטירגוט שהוקצתה ברמת המפרסם, השדה הזה חייב להיות True.

{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}

string

פלט בלבד. השם המוצג של קטגוריית האפליקציה.

string

חובה. השדה targetingOptionId כאשר הערך של targetingType הוא TARGETING_TYPE_APP_CATEGORY.

boolean

מציין אם האפשרות הזו מטורגטת באופן שלילי.

{
  "appId": string,
  "displayName": string,
  "negative": boolean,
  "appPlatform": enum (AppPlatform)
}

string

חובה. מזהה האפליקציה.

באפליקציית חנות Play ל-Android נעשה שימוש במזהה החבילה, לדוגמה com.google.android.gm. מזהה האפליקציה של Apple ב-App Store כולל מחרוזת באורך 9 ספרות, לדוגמה 422689480.

string

פלט בלבד. השם המוצג של האפליקציה.

boolean

מראה אם האפשרות הזו מטרגטת באופן שלילי.

enum (AppPlatform)

מציין את הפלטפורמה של האפליקציה המטורגטת. אם לא מציינים את השדה הזה, ההנחה היא שפלטפורמת האפליקציה היא ניידת (כלומר, Android או iOS), ונגזר את הפלטפורמה המתאימה לנייד ממזהה האפליקציה.

{
  "url": string,
  "negative": boolean
}

string

חובה. כתובת ה-URL, לדוגמה example.com.

ב-DV360 יש תמיכה בשתי רמות טירגוט לפי ספריות משנה, לדוגמה www.example.com/one-subdirectory-level/second-level, וב-5 רמות של טירגוט לתת-דומיין, לדוגמה five.four.three.two.one.example.com.

boolean

מציין אם האפשרות הזו מטורגטת באופן שלילי.

{
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer,
  "timeZoneResolution": enum (TimeZoneResolution)
}

enum (DayOfWeek)

חובה. היום בשבוע בהגדרה הזו של טירגוט לפי יום ושעה.

integer

חובה. שעת ההתחלה לטירגוט לפי יום ושעה. הערך חייב להיות בין 0 (תחילת היום) ל-23 (שעה לפני סוף היום).

integer

חובה. שעת הסיום של הטירגוט לפי יום ושעה. הערך צריך להיות בין 1 (שעה אחת אחרי תחילת היום) ל-24 (סוף היום).

enum (TimeZoneResolution)

חובה. המנגנון ששימש כדי לקבוע באיזה אזור זמן להשתמש בהגדרת הטירגוט של היום והשעה האלה.

{
  "ageRange": enum (AgeRange)
}

enum (AgeRange)

חובה. טווח הגילאים של קהל. אנחנו תומכים רק בטירגוט לטווח גילאים מתמשך של קהל מסוים. לכן, טווח הגילאים שמוצג בשדה הזה יכול להיות 1) יעד טירגוט בלבד, או 2) חלק מטווח גילאים רציף גדול יותר. אפשר להרחיב את פוטנציאל החשיפה של טירגוט מתמשך לפי טווח גילאים על ידי טירגוט גם לקהל שגילו לא ידוע.

{
  "regionalLocationListId": string,
  "negative": boolean
}

string (int64 format)

חובה. המזהה של רשימת המיקומים האזוריים. צריך להפנות לשדה locationListId של משאב LocationList שהסוג שלו הוא TARGETING_LOCATION_TYPE_REGIONAL.

boolean

מראה אם האפשרות הזו מטרגטת באופן שלילי.

{
  "proximityLocationListId": string,
  "proximityRadius": number,
  "proximityRadiusUnit": enum (ProximityRadiusUnit)
}

string (int64 format)

חובה. מזהה של רשימת המיקומים הגיאוגרפיים הקרובים. צריך להפנות לשדה locationListId של משאב LocationList שהסוג שלו הוא TARGETING_LOCATION_TYPE_PROXIMITY.

number

חובה. רדיוס שמבוטא ביחידות המרחק שהוגדרו ב-proximityRadiusUnit. הנתון הזה מייצג את גודל האזור שמסביב למיקום שנבחר שצריך לטרגט. הרדיוס צריך להיות בין 1 ל-500 מיילים או 800 קילומטרים.

enum (ProximityRadiusUnit)

חובה. יחידות מרחק מסוג רדיוס.

{
  "gender": enum (Gender)
}

enum (Gender)

חובה. המגדר של הקהל.

{
  "videoPlayerSize": enum (VideoPlayerSize)
}

enum (VideoPlayerSize)

חובה. הגודל של נגן הווידאו.

{
  "targetingOptionId": string,
  "userRewardedContent": enum (UserRewardedContent)
}

string

חובה. השדה targetingOptionId כאשר הערך של targetingType הוא TARGETING_TYPE_USER_REWARDED_CONTENT.

enum (UserRewardedContent)

פלט בלבד. סטטוס התוכן שהמשתמשים קיבלו עליו תגמול במודעות וידאו.

{
  "parentalStatus": enum (ParentalStatus)
}

enum (ParentalStatus)

חובה. סטטוס ההורה של הקהל.

{
  "contentInstreamPosition": enum (ContentInstreamPosition),
  "adType": enum (AdType)
}

enum (ContentInstreamPosition)

חובה. מיקום מודעת הווידאו In-stream במודעות וידאו או במודעות אודיו.

enum (AdType)

פלט בלבד. סוג המודעה לטירגוט. האפשרות הזו רלוונטית רק לטירגוט של הזמנות להצגת מודעות, ופריטים חדשים שתומכים בסוג המודעה שצוין יירשו את אפשרות הטירגוט הזו כברירת מחדל. הערכים האפשריים הם:

• AD_TYPE_VIDEO, ההגדרה תעבור בירושה לפריט החדש כשהערך של lineItemType הוא LINE_ITEM_TYPE_VIDEO_DEFAULT.
• AD_TYPE_AUDIO, ההגדרה תעבור בירושה לפריט החדש כשהערך של lineItemType הוא LINE_ITEM_TYPE_AUDIO_DEFAULT.

{
  "contentOutstreamPosition": enum (ContentOutstreamPosition),
  "adType": enum (AdType)
}

enum (ContentOutstreamPosition)

חובה. מיקום ה-Outstream של התוכן.

enum (AdType)

פלט בלבד. סוג המודעה לטירגוט. כברירת מחדל, אפשרות הטירגוט הזו תעבור בירושה רק לטירגוט של הזמנת קמפיין ולפריטים חדשים שתומכים בסוג המודעה שצוין. הערכים האפשריים הם:

• AD_TYPE_DISPLAY, ההגדרה תועבר בירושה לפריט חדש כשהערך של lineItemType יהיה LINE_ITEM_TYPE_DISPLAY_DEFAULT.
• AD_TYPE_VIDEO, ההגדרה תעבור בירושה לפריט החדש כשהערך של lineItemType הוא LINE_ITEM_TYPE_VIDEO_DEFAULT.

{
  "deviceType": enum (DeviceType),
  "youtubeAndPartnersBidMultiplier": number
}

enum (DeviceType)

חובה. השם המוצג של סוג המכשיר.

number

פלט בלבד. מכפיל הצעות המחיר מאפשר להציג את המודעות בתדירות גבוהה או נמוכה יותר, בהתאם לסוג המכשיר. היא תחיל מכפיל על המחיר המקורי של הצעת המחיר. אם השדה הזה הוא 0, המשמעות היא שהשדה הזה לא רלוונטי, במקום הכפלת 0 במחיר הצעת המחיר המקורית.

לדוגמה, אם הצעת המחיר ללא המכפיל הוא 40 ש"ח והמכפיל הוא 1.5 לטאבלט, הצעת המחיר שתתקבל תהיה 60.0 ש"ח.

המבצע רלוונטי רק לפריטי YouTube ושותפים.

{
  "includedFirstAndThirdPartyAudienceGroups": [
    {
      object (FirstAndThirdPartyAudienceGroup)
    }
  ],
  "includedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  },
  "includedCustomListGroup": {
    object (CustomListGroup)
  },
  "includedCombinedAudienceGroup": {
    object (CombinedAudienceGroup)
  },
  "excludedFirstAndThirdPartyAudienceGroup": {
    object (FirstAndThirdPartyAudienceGroup)
  },
  "excludedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  }
}

object (FirstAndThirdPartyAudienceGroup)

המזהים של קהלים מאינטראקציה ישירה (first-party) ושל צד שלישי, והתאריכים האחרונים שבהם נעשה שימוש בקבוצות של קהלים מאינטראקציה ישירה ושל צד שלישי. כל קבוצת יעד של צד ראשון ושל צד שלישי מכילה מזהי קהלים מאינטראקציה ישירה ומצד שלישי בלבד. הקשר בין כל קבוצת קהלים של צד ראשון לבין קבוצת קהלים של צד שלישי הוא PLACEHOLDER, והתוצאה נוצרת על ידי UNION עם קבוצות קהל אחרות. המערכת תתעלם מקבוצות חוזרות עם הגדרות זהות.

object (GoogleAudienceGroup)

מזהי הקהלים של Google של קבוצת הקהלים של Google שכלולה. מכיל מזהי קהלים של Google בלבד.

object (CustomListGroup)

מזהי הרשימות בהתאמה אישית של קבוצת הרשימות בהתאמה אישית שכלולה. מכיל מזהי רשימות מותאמים אישית בלבד.

object (CombinedAudienceGroup)

מזהי הקהלים המשולבים של קבוצת הקהלים המשולבים הכלולה. מכיל רק מזהי קהלים משולבים.

object (FirstAndThirdPartyAudienceGroup)

המזהים של קהל היעד מאינטראקציה ישירה (First-Party) וקהל היעד מצד שלישי, וכן העדכונים האחרונים של קבוצת קהל היעד מאינטראקציה ישירה (First-Party) וקהל היעד מצד שלישי שהוחרגו. משמש לטירגוט שלילי. השילוב של UNION של הקבוצה הזו ושל קבוצות קהלים אחרות שהוחרגו משמש כגשר לכל טירגוט חיובי לפי קהל. כל הפריטים הם 'OR' לוגיים זה של זה.

object (GoogleAudienceGroup)

מזהי הקהלים ב-Google של קבוצת הקהלים ב-Google שהוחרגו. משמש לטירגוט שלילי. השילוב של UNION של הקבוצה הזו ושל קבוצות קהלים אחרות שהוחרגו משמש כגשר לכל טירגוט חיובי לפי קהל. מכילה רק קהלים עם תחום עניין משותף, קהלים עם כוונת רכישה ואפליקציות מותקנות באפליקציות מסוג 'Google'. כל הפריטים הם 'OR' לוגיים זה של זה.

{
  "settings": [
    {
      object (FirstAndThirdPartyAudienceTargetingSetting)
    }
  ]
}

object (FirstAndThirdPartyAudienceTargetingSetting)

חובה. כל הגדרות הטירגוט של קהלים מאינטראקציה ישירה (first-party) ושל צד שלישי בקבוצת קהלים מאינטראקציה ישירה (first-party) ובקבוצת קהלים של צד שלישי. אסור להזין הגדרות חוזרות עם אותו מזהה.

{
  "firstAndThirdPartyAudienceId": string,
  "recency": enum (Recency)
}

string (int64 format)

חובה. מזהה קהל מאינטראקציה ישירה ומצד שלישי בהגדרת הטירגוט לפי קהל של צד ראשון ושל צד שלישי. המזהה הזה הוא firstAndThirdPartyAudienceId.

enum (Recency)

עדכניות השימוש בהגדרת טירגוט לפי קהל של צד ראשון ושל צד שלישי. רלוונטי רק לקהלים מאינטראקציה ישירה. אחרת, המערכת תתעלם. מידע נוסף זמין בכתובת https://support.google.com/displayvideo/answer/2949947#recency. אם לא צויין ערך, לא ייעשה שימוש במגבלת עדכניות.

{
  "settings": [
    {
      object (GoogleAudienceTargetingSetting)
    }
  ]
}

object (GoogleAudienceTargetingSetting)

חובה. כל הגדרות הטירגוט לפי קהל של Google בקבוצת הקהלים ב-Google. המערכת תתעלם מהגדרות חוזרות עם אותו מזהה.

{
  "googleAudienceId": string
}

string (int64 format)

חובה. מזהה הקהל ב-Google של הגדרת הטירגוט לפי קהל ב-Google. המזהה הזה הוא googleAudienceId.

{
  "settings": [
    {
      object (CustomListTargetingSetting)
    }
  ]
}

object (CustomListTargetingSetting)

חובה. כל הגדרות הטירגוט של רשימות בהתאמה אישית בקבוצת רשימות בהתאמה אישית. המערכת תתעלם מהגדרות חוזרות עם אותו מזהה.

{
  "customListId": string
}

string (int64 format)

חובה. מזהה מותאם אישית של הגדרת הטירגוט לרשימות מותאמות אישית. המזהה הזה הוא customListId.

{
  "settings": [
    {
      object (CombinedAudienceTargetingSetting)
    }
  ]
}

object (CombinedAudienceTargetingSetting)

חובה. כל ההגדרות המשולבות של טירגוט לפי קהל בקבוצת קהלים משולבת. המערכת תתעלם מהגדרות חוזרות עם אותו מזהה. המספר של הגדרות הקהל המשולבות לא יכול להיות יותר מחמש. אחרת, תוצג שגיאה.

{
  "combinedAudienceId": string
}

string (int64 format)

חובה. מזהה קהל משולב של הגדרת הטירגוט לפי קהל משולבת. המזהה הזה הוא combinedAudienceId.

{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}

string

פלט בלבד. השם המוצג של הדפדפן.

string

חובה. targetingOptionId של TargetingOption מסוג TARGETING_TYPE_BROWSER.

boolean

מציין אם האפשרות הזו מטורגטת באופן שלילי. כל אפשרויות הטירגוט לדפדפן שמוקצות באותו משאב חייבות להיות עם אותו ערך בשדה הזה.

{
  "householdIncome": enum (HouseholdIncome)
}

enum (HouseholdIncome)

חובה. ההכנסה למשק בית של הקהל.

{
  "targetingOptionId": string,
  "onScreenPosition": enum (OnScreenPosition),
  "adType": enum (AdType)
}

string

חובה. השדה targetingOptionId כשהערך של targetingType הוא TARGETING_TYPE_ON_SCREEN_POSITION.

enum (OnScreenPosition)

פלט בלבד. המיקום במסך.

enum (AdType)

פלט בלבד. סוג המודעה לטירגוט. האפשרות הזו רלוונטית רק לטירגוט של הזמנות להצגת מודעות, ופריטים חדשים שתומכים בסוג המודעה שצוין יירשו את אפשרות הטירגוט הזו כברירת מחדל. הערכים האפשריים הם:

• AD_TYPE_DISPLAY, ההגדרה תועבר בירושה לפריט חדש כשהערך של lineItemType יהיה LINE_ITEM_TYPE_DISPLAY_DEFAULT.
• AD_TYPE_VIDEO, ההגדרה תועבר בירושה לפריט חדש כשהערך של lineItemType יהיה LINE_ITEM_TYPE_VIDEO_DEFAULT.

{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}

string

פלט בלבד. השם המוצג של הספק או ספק האינטרנט.

string

חובה. ה-targetingOptionId של TargetingOption מסוג TARGETING_TYPE_CARRIER_AND_ISP.

boolean

מציין אם האפשרות הזו מטורגטת באופן שלילי. כל אפשרויות הטירגוט לספקים ו-ISP שהוקצו באותו משאב חייבים להיות בעלי ערך זהה בשדה הזה.

{
  "keyword": string,
  "negative": boolean
}

string

חובה. מילת המפתח, לדוגמה car insurance.

מילת מפתח חיובית לא יכולה להיות מילה פוגענית. הקידוד חייב להיות UTF-8 והגודל המקסימלי הוא 255 בייטים. אפשר להזין עד 80 תווים. מספר המילים המקסימלי הוא 10.

boolean

מציין אם האפשרות הזו מטורגטת באופן שלילי.

{
  "negativeKeywordListId": string
}

string (int64 format)

חובה. המזהה של רשימת מילות המפתח השליליות. צריך להפנות לשדה negativeKeywordListId של משאב NegativeKeywordList.

{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}

string

פלט בלבד. השם המוצג של מערכת ההפעלה.

string

חובה. המזהה של אפשרות הטירגוט מאוכלס בשדה targetingOptionId כאשר targetingType הוא TARGETING_TYPE_OPERATING_SYSTEM.

boolean

מראה אם האפשרות הזו מטרגטת באופן שלילי.

{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}

string

פלט בלבד. השם המוצג של היצרן והדגם של המכשיר.

string

חובה. השדה targetingOptionId כשהערך של targetingType הוא TARGETING_TYPE_DEVICE_MAKE_MODEL.

boolean

מציין אם האפשרות הזו מטורגטת באופן שלילי.

{
  "environment": enum (Environment)
}

enum (Environment)

חובה. סביבת ההצגה.

{
  "inventorySourceId": string
}

string (int64 format)

חובה. המזהה של מקור מלאי שטחי הפרסום. צריך להפנות לשדה inventorySourceId של משאב InventorySource.

{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}

string

פלט בלבד. השם המוצג של הקטגוריה.

string

חובה. השדה targetingOptionId כאשר הערך של targetingType הוא TARGETING_TYPE_CATEGORY.

boolean

מראה אם האפשרות הזו מטרגטת באופן שלילי.

{
  "viewability": enum (Viewability)
}

enum (Viewability)

חובה. אחוז הניראות החזויה.

{
  "authorizedSellerStatus": enum (AuthorizedSellerStatus),
  "targetingOptionId": string
}

enum (AuthorizedSellerStatus)

פלט בלבד. סטטוס המפיץ המורשה שאליו רוצים לטרגט.

string

חובה. targetingOptionId של TargetingOption מסוג TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}

string

פלט בלבד. השם המוצג של השפה (למשל, "צרפתית").

string

חובה. ה-targetingOptionId של TargetingOption מסוג TARGETING_TYPE_LANGUAGE.

boolean

מציין אם האפשרות הזו מטורגטת באופן שלילי. כל אפשרויות הטירגוט לפי שפה שהוקצו לאותו משאב צריכות לכלול את אותו ערך בשדה הזה.

{
  "displayName": string,
  "targetingOptionId": string,
  "geoRegionType": enum (GeoRegionType),
  "negative": boolean
}

string

פלט בלבד. השם המוצג של האזור הגיאוגרפי (למשל, "אונטריו, קנדה").

string

חובה. ה-targetingOptionId של TargetingOption מסוג TARGETING_TYPE_GEO_REGION.

enum (GeoRegionType)

פלט בלבד. סוג הטירגוט לפי אזור גיאוגרפי.

boolean

מראה אם האפשרות הזו מטרגטת באופן שלילי.

{
  "inventorySourceGroupId": string
}

string (int64 format)

חובה. המזהה של קבוצת המקורות של מלאי שטחי הפרסום. צריך להפנות לשדה inventorySourceGroupId של משאב InventorySourceGroup.

{
  "excludedContentRatingTier": enum (ContentRatingTier)
}

enum (ContentRatingTier)

חובה. השם המוצג של רמת הסיווג של הלייבל הדיגיטלי שצריך להחריג.

{
  "excludedSensitiveCategory": enum (SensitiveCategory)
}

enum (SensitiveCategory)

חובה. מספר כולל של תוכן בקטגוריה רגישה ב-DV360 שסווג כמוחרג.

{
  "exchange": enum (Exchange)
}

enum (Exchange)

חובה. ערך ה-enum של הבורסה.

{
  "targetingOptionId": string
}

string

חובה. targetingOptionId של TargetingOption מסוג TARGETING_TYPE_SUB_EXCHANGE.

{

  // Union field verifier can be only one of the following:
  "adloox": {
    object (Adloox)
  },
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  }
  // End of list of possible types for union field verifier.
}

object (Adloox)

צד שלישי לאימות מותג – Adloox.

object (DoubleVerify)

שירות אימות מותגים של צד שלישי – DoubleVerify.

object (IntegralAdScience)

מאמת מותג של צד שלישי – Integral Ad Science.

{
  "excludedAdlooxCategories": [
    enum (AdlooxCategory)
  ]
}

enum (AdlooxCategory)

ההגדרות של Adloox להגנה על המותג.

{
  "brandSafetyCategories": {
    object (BrandSafetyCategories)
  },
  "avoidedAgeRatings": [
    enum (AgeRating)
  ],
  "appStarRating": {
    object (AppStarRating)
  },
  "displayViewability": {
    object (DisplayViewability)
  },
  "videoViewability": {
    object (VideoViewability)
  },
  "fraudInvalidTraffic": {
    object (FraudInvalidTraffic)
  },
  "customSegmentId": string
}

object (BrandSafetyCategories)

אמצעי בקרה להגנה על המותג של DV.

enum (AgeRating)

להימנע מהגשת הצעות מחיר על אפליקציות עם סיווג הגיל הזה.

object (AppStarRating)

לא מומלץ להגיש הצעות מחיר על אפליקציות עם דירוגי כוכבים.

object (DisplayViewability)

הגדרות של ניראות ברשת המדיה (רלוונטיות רק לפריטים ברשת המדיה).

object (VideoViewability)

הגדרות הניראות של הסרטון (רלוונטי רק לפריטי וידאו).

object (FraudInvalidTraffic)

הימנעות מאתרים ומאפליקציות עם היסטוריית הונאות תעריפים של תנועה לא חוקית כללית (IVT).

string (int64 format)

מזהה הפלח בהתאמה אישית שסופק על ידי DoubleVerify. המזהה חייב להתחיל בספרה '51' ולהכיל שמונה ספרות. לא ניתן לציין מזהה פלח מותאם אישית עם אף אחד מהשדות הבאים:

• brandSafetyCategories
• avoidedAgeRatings
• appStarRating
• fraudInvalidTraffic

{
  "avoidUnknownBrandSafetyCategory": boolean,
  "avoidedHighSeverityCategories": [
    enum (HighSeverityCategory)
  ],
  "avoidedMediumSeverityCategories": [
    enum (MediumSeverityCategory)
  ]
}

boolean

לא ידוע או בלתי ניתן לדירוג.

enum (HighSeverityCategory)

קטגוריות הימנעות ברמה גבוהה של בטיחות המותג.

enum (MediumSeverityCategory)

קטגוריות הימנעות ברמת חומרה בינונית של בטיחות המותג.

{
  "avoidedStarRating": enum (StarRating),
  "avoidInsufficientStarRating": boolean
}

enum (StarRating)

מומלץ להימנע מהגשת הצעות מחיר על אפליקציות עם דירוגי כוכבים.

boolean

לא כדאי להגיש הצעות מחיר לאפליקציות שאין להן מספיק דירוגי כוכבים.

{
  "iab": enum (IAB),
  "viewableDuring": enum (ViewableDuring)
}

enum (IAB)

טירגוט של מלאי שטחי פרסום באינטרנט ובאפליקציות כדי למקסם את שיעור הצפייה של IAB.

enum (ViewableDuring)

מטרגטים מלאי שטחי פרסום באינטרנט ובאפליקציות כדי למקסם את משך הזמן שבו המודעות מוצגות ב-100%.

{
  "videoIab": enum (VideoIAB),
  "videoViewableRate": enum (VideoViewableRate),
  "playerImpressionRate": enum (PlayerImpressionRate)
}

enum (VideoIAB)

טירגוט מלאי שטחי פרסום באינטרנט כדי למקסם את שיעור הצפייה לפי IAB.

enum (VideoViewableRate)

כדאי לטרגט את מלאי שטחי הפרסום באינטרנט כדי למקסם את שיעור הניראות והזמינות למדידה.

enum (PlayerImpressionRate)

טירגוט מלאי שטחי פרסום כדי למקסם את מספר החשיפות באמצעות נגן בגודל 400x300 פיקסלים ומעלה.

{
  "avoidedFraudOption": enum (FraudOption),
  "avoidInsufficientOption": boolean
}

enum (FraudOption)

הימנעות מאתרים ומאפליקציות עם היסטוריית הונאות תנועה פסולה (IVT).

boolean

אין מספיק נתונים היסטוריים על הונאות ועל טראפיק לא חוקי.

{
  "traqScoreOption": enum (TRAQScore),
  "excludeUnrateable": boolean,
  "excludedAdultRisk": enum (Adult),
  "excludedAlcoholRisk": enum (Alcohol),
  "excludedIllegalDownloadsRisk": enum (IllegalDownloads),
  "excludedDrugsRisk": enum (Drugs),
  "excludedHateSpeechRisk": enum (HateSpeech),
  "excludedOffensiveLanguageRisk": enum (OffensiveLanguage),
  "excludedViolenceRisk": enum (Violence),
  "excludedGamblingRisk": enum (Gambling),
  "excludedAdFraudRisk": enum (AdFraudPrevention),
  "displayViewability": enum (DisplayViewability),
  "videoViewability": enum (VideoViewability),
  "customSegmentId": [
    string
  ]
}

enum (TRAQScore)

איכות הפרסום בפועל (רלוונטי לפריטים מסוג 'פרסום ברשת המדיה' בלבד).

boolean

בטיחות המותג – לא ניתן לדירוג.

enum (Adult)

הגנה על המותג – תוכן למבוגרים בלבד.

enum (Alcohol)

הגנה על המותג - אלכוהול.

enum (IllegalDownloads)

הגנה על המותג – הורדות לא חוקיות.

enum (Drugs)

הגנה על המותג – תרופות.

enum (HateSpeech)

הגנה על המותג – דברי שטנה.

enum (OffensiveLanguage)

הגנה על המותג – שפה פוגענית.

enum (Violence)

הגנה על המותג – אלימות.

enum (Gambling)

הגנה על המותג - הימורים.

enum (AdFraudPrevention)

הגדרות בנושא זיוף קליקים על מודעות.

enum (DisplayViewability)

הקטע 'ניראות ברשת המדיה' (רלוונטי לפריטים ברשת המדיה בלבד).

enum (VideoViewability)

סעיף הניראות של מודעות וידאו (רלוונטי לפריטי וידאו בלבד).

string (int64 format)

מזהה הפלח בהתאמה אישית שסופק על ידי Integral Ad Science. המזהה חייב להיות בין 1000001 ל-1999999, כולל.

{
  "displayName": string,
  "targetingOptionId": string,
  "latitude": number,
  "longitude": number,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}

string

פלט בלבד. השם המוצג של נקודת עניין, למשל 'Times Square', 'Space needle' (מחט החלל) ולאחר מכן הכתובת המלאה (אם קיימת)

string

חובה. targetingOptionId של TargetingOption מסוג TARGETING_TYPE_POI.

ניתן לאחזר את המזהים הקבילים של אפשרויות טירגוט לנקודות עניין באמצעות targetingTypes.targetingOptions.search.

אם אתם מטרגטים קואורדינטת קווי אורך/רוחב ספציפית שהוסרה מכתובת או משם של נקודת עניין, אפשר ליצור את המזהה של אפשרות הטירגוט הרצויה. לשם כך, יש לעגל את ערכי הקואורדינטות הרצויים למקום השישי אחרי הנקודה העשרונית, להסיר את המספרים העשרוניים ולשרשר את ערכי המחרוזת שמופרדים בנקודה ופסיק. לדוגמה, ניתן לטרגט את צמד קו הרוחב/קו האורך 40.7414691, -74.003387 באמצעות מזהה אפשרות הטירגוט '40741469;-74003387'. לאחר יצירת השדה, הערך של השדה הזה יעודכן כדי להוסיף נקודה ופסיק וערך גיבוב אלפאנומרי אם הזנתם רק קואורדינטות של קו רוחב/קו אורך.

number

פלט בלבד. קו הרוחב של נקודת העניין, מעוגל למקום השישי אחרי הנקודה העשרונית.

number

פלט בלבד. קו האורך של נקודת העניין, המעוגל למקום השישי אחרי הנקודה העשרונית.

number

חובה. הרדיוס של האזור סביב נקודת העניין שאליו יתבצע הטירגוט. היחידות של הרדיוס מצוינות על ידי proximityRadiusUnit. הערך צריך להיות 1 עד 800 אם היחידה היא DISTANCE_UNIT_KILOMETERS ו-1 עד 500 אם היחידה היא DISTANCE_UNIT_MILES.

enum (DistanceUnit)

חובה. יחידת המרחק שבה נמדד רדיוס הטירגוט.

{
  "displayName": string,
  "targetingOptionId": string,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}

string

פלט בלבד. השם המוצג של רשת עסקים, למשל 'KFC', 'בנק הפועלים'.

string

חובה. ה-targetingOptionId של TargetingOption מסוג TARGETING_TYPE_BUSINESS_CHAIN.

אפשר לאחזר באמצעות SearchTargetingOptions את המזהים של אפשרויות הטירגוט הקבילות של רשתות עסקיות.

number

חובה. רדיוס האזור שמסביב לרשת העסקית שאליו יש לטרגט. היחידות של הרדיוס מצוינות על ידי proximityRadiusUnit. הערך צריך להיות 1 עד 800 אם היחידה היא DISTANCE_UNIT_KILOMETERS ו-1 עד 500 אם היחידה היא DISTANCE_UNIT_MILES. הערך המינימלי של העלייה בשני המקרים הוא 0.1. אם הערכים של הקלט מפורטים מדי, הם יעוגלו לערך הקביל הקרוב ביותר. לדוגמה, הערך 15.57 יהפוך לערך 15.6.

enum (DistanceUnit)

חובה. יחידת המרחק שבה נמדד רדיוס הטירגוט.

{
  "targetingOptionId": string,
  "contentDuration": enum (ContentDuration)
}

string

חובה. השדה targetingOptionId כשהערך של targetingType הוא TARGETING_TYPE_CONTENT_DURATION.

enum (ContentDuration)

פלט בלבד. משך התוכן.

{
  "targetingOptionId": string,
  "contentStreamType": enum (ContentStreamType)
}

string

חובה. השדה targetingOptionId כשהערך של targetingType הוא TARGETING_TYPE_CONTENT_STREAM_TYPE.

enum (ContentStreamType)

פלט בלבד. הסוג של מקור נתוני התוכן.

{
  "contentPosition": enum (NativeContentPosition)
}

enum (NativeContentPosition)

חובה. מיקום התוכן.

{
  "omid": enum (Omid)
}

enum (Omid)

חובה. סוג המלאי המופעל באמצעות מדידה פתוחה.

{
  "audioContentType": enum (AudioContentType)
}

enum (AudioContentType)

חובה. סוג תוכן האודיו.

{
  "targetingOptionId": string,
  "displayName": string,
  "negative": boolean
}

string

חובה. השדה targetingOptionId כאשר targetingType הוא TARGETING_TYPE_CONTENT_GENRE.

string

פלט בלבד. השם המוצג של ז'אנר התוכן.

boolean

מציין אם האפשרות הזו מטורגטת באופן שלילי.

{
  "videoId": string,
  "negative": boolean
}

string

מזהה הסרטון ב-YouTube כפי שהוא מופיע בדף הצפייה ב-YouTube.

boolean

מראה אם האפשרות הזו מטרגטת באופן שלילי.

{
  "channelId": string,
  "negative": boolean
}

string

מזהה הערוץ של מעלה התוכן ב-YouTube או קוד הערוץ של ערוץ YouTube.

boolean

מציין אם האפשרות הזו מטורגטת באופן שלילי.

{
  "sessionPosition": enum (SessionPosition)
}

enum (SessionPosition)

המיקום שבו המודעה תוצג בסשן.