REST Resource: advertisers.adGroups.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 ו-Partner.

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

object (FirstAndThirdPartyAudienceGroup)

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

object (GoogleAudienceGroup)

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

object (CustomListGroup)

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

object (CombinedAudienceGroup)

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

object (FirstAndThirdPartyAudienceGroup)

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

object (GoogleAudienceGroup)

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

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

object (FirstAndThirdPartyAudienceTargetingSetting)

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

{
  "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

פלט בלבד. השם המוצג של הספק או ה-ISP.

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

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

{
  "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', 'Chase Bank'.

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)

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