REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

משאב: AssignedטירגוטOption

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

ייצוג JSON 
{
  "name": string,
  "assignedTargetingOptionId": string,
  "targetingType": enum (TargetingType),
  "inheritance": enum (Inheritance),

  // Union field details can be only one of the following:
  "channelDetails": {
    object (ChannelAssignedTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryAssignedTargetingOptionDetails)
  },
  "appDetails": {
    object (AppAssignedTargetingOptionDetails)
  },
  "urlDetails": {
    object (UrlAssignedTargetingOptionDetails)
  },
  "dayAndTimeDetails": {
    object (DayAndTimeAssignedTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeAssignedTargetingOptionDetails)
  },
  "regionalLocationListDetails": {
    object (RegionalLocationListAssignedTargetingOptionDetails)
  },
  "proximityLocationListDetails": {
    object (ProximityLocationListAssignedTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderAssignedTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeAssignedTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentAssignedTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusAssignedTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionAssignedTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionAssignedTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeAssignedTargetingOptionDetails)
  },
  "audienceGroupDetails": {
    object (AudienceGroupAssignedTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserAssignedTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeAssignedTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionAssignedTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspAssignedTargetingOptionDetails)
  },
  "keywordDetails": {
    object (KeywordAssignedTargetingOptionDetails)
  },
  "negativeKeywordListDetails": {
    object (NegativeKeywordListAssignedTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemAssignedTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelAssignedTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentAssignedTargetingOptionDetails)
  },
  "inventorySourceDetails": {
    object (InventorySourceAssignedTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryAssignedTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityAssignedTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusAssignedTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageAssignedTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionAssignedTargetingOptionDetails)
  },
  "inventorySourceGroupDetails": {
    object (InventorySourceGroupAssignedTargetingOptionDetails)
  },
  "digitalContentLabelExclusionDetails": {
    object (DigitalContentLabelAssignedTargetingOptionDetails)
  },
  "sensitiveCategoryExclusionDetails": {
    object (SensitiveCategoryAssignedTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeAssignedTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeAssignedTargetingOptionDetails)
  },
  "thirdPartyVerifierDetails": {
    object (ThirdPartyVerifierAssignedTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiAssignedTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainAssignedTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationAssignedTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeAssignedTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionAssignedTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidAssignedTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeAssignedTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreAssignedTargetingOptionDetails)
  }
  // End of list of possible types for union field details.
}
שדות
name

string

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

string

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

enum (TargetingType)

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

enum (Inheritance)

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

object (ChannelAssignedTargetingOptionDetails)

פרטי הערוץ. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_CHANNEL.
appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

פרטים על קטגוריית האפליקציה. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_APP_CATEGORY.
appDetails

object (AppAssignedTargetingOptionDetails)

פרטי האפליקציה. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_APP.
urlDetails

object (UrlAssignedTargetingOptionDetails)

פרטי כתובת ה-URL. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_URL.
dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

פרטי יום ושעה. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_DAY_AND_TIME.
ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

פרטי טווח הגילאים. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_AGE_RANGE.
regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

פרטי רשימת המיקומים האזוריים. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_REGIONAL_LOCATION_LIST.
proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

פרטים של רשימת מיקומים קרובים. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_PROXIMITY_LOCATION_LIST.
genderDetails

object (GenderAssignedTargetingOptionDetails)

פרטי המגדר. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_GENDER.
videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

פרטים על הגודל של נגן הווידאו השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_VIDEO_PLAYER_SIZE.
userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

פרטים על התוכן המתגמל של המשתמשים. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_USER_REWARDED_CONTENT.
parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

פרטי סטטוס הורה. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_PARENTAL_STATUS.
contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

פרטים על מיקום מודעת וידאו In-stream בתוכן. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_CONTENT_INSTREAM_POSITION.
contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

פרטי מיקום של מודעות וידאו Outstream בתוכן. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.
deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

פרטים על סוג המכשיר. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_DEVICE_TYPE.
audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

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

object (BrowserAssignedTargetingOptionDetails)

פרטי הדפדפן. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_BROWSER.
householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

פרטי הכנסה למשק בית. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_HOUSEHOLD_INCOME.
onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

פרטים על המיקום במסך. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_ON_SCREEN_POSITION.
carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

פרטי הספק ו-ISP. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_CARRIER_AND_ISP.
keywordDetails

object (KeywordAssignedTargetingOptionDetails)

פרטי מילת המפתח. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_KEYWORD.

אפשר להקצות לכל משאב עד 5,000 מילות מפתח שליליות ישירות. אין הגבלה על מספר מילות המפתח החיוביות שניתן להקצות.
negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

פרטי מילת המפתח. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

אפשר להקצות לכל משאב עד 4 רשימות של מילות מפתח שליליות.
operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

פרטי מערכת ההפעלה. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_OPERATING_SYSTEM.
deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

פרטי היצרן והדגם של המכשיר. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_DEVICE_MAKE_MODEL.
environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

פרטי הסביבה. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_ENVIRONMENT.
inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

פרטים על מקור המלאי. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_INVENTORY_SOURCE.
categoryDetails

object (CategoryAssignedTargetingOptionDetails)

פרטי הקטגוריה. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_CATEGORY.

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

object (ViewabilityAssignedTargetingOptionDetails)

פרטי ניראות. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_VIEWABILITY.

ניתן לטרגט רק אפשרות ניראות אחת לכל משאב.
authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

פרטים על הסטטוס של בית העסק המורשה. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

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

אם למשאב אין אפשרות לסטטוס מפיץ מורשה, כל המפיצים המורשים שמסומנים כ-DIRECT או RESELLER בקובץ ads.txt מטרגטים כברירת מחדל.
languageDetails

object (LanguageAssignedTargetingOptionDetails)

פרטי השפה. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_LANGUAGE.
geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

פרטי האזור הגיאוגרפי. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_GEO_REGION.
inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

פרטי הקבוצה של מקורות מלאי שטחי הפרסום. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_INVENTORY_SOURCE_GROUP.
digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

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

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

object (SensitiveCategoryAssignedTargetingOptionDetails)

פרטים על קטגוריות רגישות. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

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

object (ExchangeAssignedTargetingOptionDetails)

פרטי ההחלפה. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_EXCHANGE.
subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

פרטי בורסת משנה. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_SUB_EXCHANGE.
thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

פרטי אימות של צד שלישי. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_THIRD_PARTY_VERIFIER.
poiDetails

object (PoiAssignedTargetingOptionDetails)

פרטים על נקודת העניין. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_POI.
businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

פרטי הרשת העסקית. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_BUSINESS_CHAIN.
contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

פרטים על משך התוכן. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_CONTENT_DURATION.
contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

פרטים על משך התוכן. השדה הזה יאוכלס כאשר ערך הטירגוט הוא TARGETING_TYPE_CONTENT_STREAM_TYPE.
nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

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

object (OmidAssignedTargetingOptionDetails)

פתיחת פרטים על מלאי שטחי פרסום שהופעלה בו מדידה. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_OMID.
audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

פרטים על סוג תוכן האודיו. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_AUDIO_CONTENT_TYPE.
contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

פרטי הז'אנר של התוכן. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_CONTENT_GENRE.

ירושה

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

טיפוסים בני מנייה (enum)
INHERITANCE_UNSPECIFIED הירושה לא צוינה או לא ידועה.
NOT_INHERITED אפשרות הטירגוט שהוקצתה לא עוברת בירושה מישות ברמה גבוהה יותר.
INHERITED_FROM_PARTNER אפשרות הטירגוט שהוקצתה עוברת בירושה מהגדרות הטירגוט לשותפים.
INHERITED_FROM_ADVERTISER אפשרות הטירגוט שהוקצתה עוברת בירושה מהגדרות הטירגוט של המפרסם.

ChannelAssignedTargetingOptionDetails

פרטים על אפשרות הטירגוט לערוץ שהוקצתה. השדה הזה יאוכלס בשדה הפרטים ב-AssignTargetOption כשהערך של targetingType הוא TARGETING_TYPE_CHANNEL.

ייצוג JSON 
{
  "channelId": string,
  "negative": boolean
}
שדות
channelId

string (int64 format)

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

boolean

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

AppCategoryAssignedTargetingOptionDetails

פרטים על אפשרות הטירגוט לפי קטגוריית אפליקציות שהוקצתה. השדה הזה יאוכלס בשדה appCategoryDetails ב-AssignTargetOption כשהערך של targetingType הוא TARGETING_TYPE_APP_CATEGORY.

ייצוג JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
שדות
displayName

string

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

string

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

boolean

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

AppAssignedTargetingOptionDetails

פרטים על אפשרות הטירגוט לאפליקציות שהוקצתה. השדה הזה יאוכלס בשדה הפרטים ב-AssignTargetOption כשהערך של targetingType הוא TARGETING_TYPE_APP.

ייצוג JSON 
{
  "appId": string,
  "displayName": string,
  "negative": boolean,
  "appPlatform": enum (AppPlatform)
}
שדות
appId

string

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

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

string

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

boolean

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

enum (AppPlatform)

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

AppPlatform

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

טיפוסים בני מנייה (enum)
APP_PLATFORM_UNSPECIFIED ערך ברירת המחדל אם פלטפורמת האפליקציה לא צוינה בגרסה הזו. הערך 'טיפוסים בני מנייה (enum)' הוא placeholder של ערך ברירת מחדל, והוא לא מייצג אפשרות של פלטפורמה אמיתית.
APP_PLATFORM_IOS פלטפורמת האפליקציה היא iOS.
APP_PLATFORM_ANDROID פלטפורמת האפליקציה היא Android.
APP_PLATFORM_ROKU פלטפורמת האפליקציה היא Roku.
APP_PLATFORM_AMAZON_FIRETV פלטפורמת האפליקציה היא Amazon FireTV.
APP_PLATFORM_PLAYSTATION פלטפורמת האפליקציה היא Playstation.
APP_PLATFORM_APPLE_TV פלטפורמת האפליקציה היא Apple TV.
APP_PLATFORM_XBOX פלטפורמת האפליקציה היא Xbox.
APP_PLATFORM_SAMSUNG_TV פלטפורמת האפליקציה היא Samsung TV.
APP_PLATFORM_ANDROID_TV פלטפורמת האפליקציה היא Android TV.
APP_PLATFORM_GENERIC_CTV פלטפורמת האפליקציה היא פלטפורמת CTV שלא רשומה במפורש במקום אחר.

UrlAssignedTargetingOptionDetails

פרטים על אפשרות הטירגוט לכתובות URL שהוקצתה. השדה הזה יאוכלס בשדה הפרטים ב-AssignTargetOption כשהערך של targetingType הוא TARGETING_TYPE_URL.

ייצוג JSON 
{
  "url": string,
  "negative": boolean
}
שדות
url

string

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

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

boolean

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

DayAndTimeAssignedTargetingOptionDetails

ייצוג של מקטע זמן המוגדר ביום ספציפי בשבוע עם שעת התחלה ושעת סיום. השעה שמיוצגת על ידי startHour חייבת להיות לפני השעה שמיוצגת על ידי endHour.

ייצוג JSON 
{
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer,
  "timeZoneResolution": enum (TimeZoneResolution)
}
שדות
dayOfWeek

enum (DayOfWeek)

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

integer

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

integer

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

enum (TimeZoneResolution)

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

DayOfWeek

מייצג יום בשבוע.

טיפוסים בני מנייה (enum)
DAY_OF_WEEK_UNSPECIFIED היום בשבוע לא צוין.
MONDAY שני
TUESDAY שלישי
WEDNESDAY רביעי
THURSDAY חמישי
FRIDAY שישי
SATURDAY שבת
SUNDAY ראשון

TimeZoneResolution

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

טיפוסים בני מנייה (enum)
TIME_ZONE_RESOLUTION_UNSPECIFIED הרזולוציה של אזור הזמן לא ספציפית או לא ידועה.
TIME_ZONE_RESOLUTION_END_USER הזמנים נקבעים לפי אזור הזמן של המשתמש שראה את המודעה.
TIME_ZONE_RESOLUTION_ADVERTISER הזמנים נקבעים לפי אזור הזמן של המפרסם שהציג את המודעה.

AgeRangeAssignedTargetingOptionDetails

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

ייצוג JSON 
{
  "ageRange": enum (AgeRange),
  "targetingOptionId": string
}
שדות
ageRange

enum (AgeRange)

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

פלט רק בגרסה 1. חובה בגרסה 2.
targetingOptionId

string

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

RegionalLocationListAssignedTargetingOptionDetails

פרטי טירגוט לרשימת מיקומים אזוריים. השדה הזה יאוכלס בשדה הפרטים ב-AssignTargetOption כשהערך של targetingType הוא TARGETING_TYPE_REGIONAL_LOCATION_LIST.

ייצוג JSON 
{
  "regionalLocationListId": string,
  "negative": boolean
}
שדות
regionalLocationListId

string (int64 format)

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

boolean

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

ProximityLocationListAssignedTargetingOptionDetails

פרטי טירגוט לרשימת מיקומים קרובים. השדה הזה יאוכלס בשדה הפרטים ב-AssignTargetOption כשהערך של targetingType הוא TARGETING_TYPE_PROXIMITY_LOCATION_LIST.

ייצוג JSON 
{
  "proximityLocationListId": string,
  "proximityRadiusRange": enum (ProximityRadiusRange)
}
שדות
proximityLocationListId

string (int64 format)

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

enum (ProximityRadiusRange)

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

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

ProximityRadiusRange

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

טיפוסים בני מנייה (enum)
PROXIMITY_RADIUS_RANGE_UNSPECIFIED טווח הרדיוס המטורגט לא צוין או שאינו ידוע. ערך ברירת המחדל כשלא צוין טווח רדיוס בגרסה הזו. הערך 'טיפוסים בני מנייה (enum)' הוא placeholder של ערך ברירת מחדל, והוא לא מייצג אפשרות אמיתית של טווח רדיוס.
PROXIMITY_RADIUS_RANGE_SMALL טווח הרדיוס המטורגט קטן.
PROXIMITY_RADIUS_RANGE_MEDIUM טווח הרדיוס המטורגט הוא בינוני.
PROXIMITY_RADIUS_RANGE_LARGE טווח הרדיוס המטורגט גדול.

GenderAssignedTargetingOptionDetails

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

ייצוג JSON 
{
  "gender": enum (Gender),
  "targetingOptionId": string
}
שדות
gender

enum (Gender)

המגדר של הקהל.

פלט רק בגרסה 1. חובה בגרסה 2.
targetingOptionId

string

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

VideoPlayerSizeAssignedTargetingOptionDetails

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

ייצוג JSON 
{
  "targetingOptionId": string,
  "videoPlayerSize": enum (VideoPlayerSize)
}
שדות
targetingOptionId

string

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

enum (VideoPlayerSize)

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

פלט רק בגרסה 1. חובה בגרסה 2.

UserRewardedContentAssignedTargetingOptionDetails

פרטים על האפשרות של טירגוט לפי תוכן מתגמל של משתמשים. הערך הזה יאוכלס בשדה userRewardedContentDetails כשהערך של targetingType יהיה TARGETING_TYPE_USER_REWARDED_CONTENT.

ייצוג JSON 
{
  "targetingOptionId": string,
  "userRewardedContent": enum (UserRewardedContent)
}
שדות
targetingOptionId

string

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

enum (UserRewardedContent)

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

ParentalStatusAssignedTargetingOptionDetails

פרטים על אפשרות הטירגוט שהוקצתה לכם לפי סטטוס הורה. השדה הזה יאוכלס בשדה הפרטים ב-AssignTargetOption כשהערך של targetingType הוא TARGETING_TYPE_PARENTAL_STATUS.

ייצוג JSON 
{
  "parentalStatus": enum (ParentalStatus),
  "targetingOptionId": string
}
שדות
parentalStatus

enum (ParentalStatus)

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

פלט רק בגרסה 1. חובה בגרסה 2.
targetingOptionId

string

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

ContentInstreamPositionAssignedTargetingOptionDetails

פרטים על אפשרות הטירגוט למיקום מודעה In-stream שהוקצו לתוכן. הערך הזה יאוכלס בשדה contentInstreamPositionDetails כשהערך של targetingType יהיה TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

ייצוג JSON 
{
  "targetingOptionId": string,
  "contentInstreamPosition": enum (ContentInstreamPosition),
  "adType": enum (AdType)
}
שדות
targetingOptionId

string

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

enum (ContentInstreamPosition)

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

פלט רק בגרסה 1. חובה בגרסה 2.
adType

enum (AdType)

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

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

AdType

סוג הקריאייטיב שמשויך למודעות.

טיפוסים בני מנייה (enum)
AD_TYPE_UNSPECIFIED סוג המודעה לא צוין או שאינו ידוע בגרסה הזו.
AD_TYPE_DISPLAY נכסי קריאייטיב לרשת המדיה, למשל התמונה ו-HTML5.
AD_TYPE_VIDEO קריאייטיבים בווידאו, למשל מודעות וידאו שמופעלות במהלך תוכן בסטרימינג בנגני וידאו.
AD_TYPE_AUDIO קריאייטיבים מסוג אודיו, למשל מודעות אודיו שמופעלות במהלך תוכן אודיו.

ContentOutstreamPositionAssignedTargetingOptionDetails

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

ייצוג JSON 
{
  "targetingOptionId": string,
  "contentOutstreamPosition": enum (ContentOutstreamPosition),
  "adType": enum (AdType)
}
שדות
targetingOptionId

string

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

enum (ContentOutstreamPosition)

המיקום של מודעות וידאו Outstream של התוכן.

פלט רק בגרסה 1. חובה בגרסה 2.
adType

enum (AdType)

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

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

DeviceTypeAssignedTargetingOptionDetails

פרטי הטירגוט לפי סוג המכשיר. השדה הזה יאוכלס בשדה הפרטים ב-AssignTargetOption כשהערך של targetingType הוא TARGETING_TYPE_DEVICE_TYPE.

ייצוג JSON 
{
  "targetingOptionId": string,
  "deviceType": enum (DeviceType)
}
שדות
targetingOptionId

string

חובה. המזהה של סוג המכשיר.
deviceType

enum (DeviceType)

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

פלט רק בגרסה 1. חובה בגרסה 2.

AudienceGroupAssignedTargetingOptionDetails

פרטים על אפשרות הטירגוט לקבוצות קהלים שהוקצו. השדה הזה יאוכלס בשדה הפרטים ב-AssignTargetOption כשהערך של targetingType הוא TARGETING_TYPE_AUDIENCE_GROUP. הקשר בין כל קבוצה הוא UNION, למעט אלה שלא נכללים ב-excludedFirstAndAfterPartyAudienceGroup וב-GoogleAudienceGroup שלא נכללים, שבהם COMPLEMENT משמש כ-לוחצים על קבוצות אחרות.

ייצוג JSON 
{
  "includedFirstAndThirdPartyAudienceGroups": [
    {
      object (FirstAndThirdPartyAudienceGroup)
    }
  ],
  "includedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  },
  "includedCustomListGroup": {
    object (CustomListGroup)
  },
  "includedCombinedAudienceGroup": {
    object (CombinedAudienceGroup)
  },
  "excludedFirstAndThirdPartyAudienceGroup": {
    object (FirstAndThirdPartyAudienceGroup)
  },
  "excludedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  }
}
שדות
includedFirstAndThirdPartyAudienceGroups[]

object (FirstAndThirdPartyAudienceGroup)

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

object (GoogleAudienceGroup)

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

object (CustomListGroup)

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

object (CombinedAudienceGroup)

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

object (FirstAndThirdPartyAudienceGroup)

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

object (GoogleAudienceGroup)

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

FirstAndThirdPartyAudienceGroup

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

ייצוג JSON 
{
  "settings": [
    {
      object (FirstAndThirdPartyAudienceTargetingSetting)
    }
  ]
}
שדות
settings[]

object (FirstAndThirdPartyAudienceTargetingSetting)

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

FirstAndThirdPartyAudienceTargetingSetting

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

ייצוג JSON 
{
  "firstAndThirdPartyAudienceId": string,
  "recency": enum (Recency)
}
שדות
firstAndThirdPartyAudienceId

string (int64 format)

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

enum (Recency)

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

עדכניות

כל ערכי עדכניות הקהל של צד ראשון וצד שלישי נתמכים.

טיפוסים בני מנייה (enum)
RECENCY_NO_LIMIT אין מגבלת עדכניות.
RECENCY_1_MINUTE השכיחות היא דקה.
RECENCY_5_MINUTES השכיחות היא 5 דקות.
RECENCY_10_MINUTES השכיחות היא 10 דקות.
RECENCY_15_MINUTES השכיחות היא 15 דקות.
RECENCY_30_MINUTES השכיחות היא 30 דקות.
RECENCY_1_HOUR השכיחות היא שעה אחת.
RECENCY_2_HOURS השכיחות היא שעתיים.
RECENCY_3_HOURS השכיחות היא 3 שעות.
RECENCY_6_HOURS השכיחות היא 6 שעות.
RECENCY_12_HOURS השכיחות היא 12 שעות.
RECENCY_1_DAY השכיחות היא יום אחד.
RECENCY_2_DAYS השכיחות היא יומיים.
RECENCY_3_DAYS השכיחות היא 3 ימים.
RECENCY_5_DAYS השכיחות היא 5 ימים.
RECENCY_7_DAYS השכיחות היא 7 ימים.
RECENCY_10_DAYS השכיחות היא 10 ימים.
RECENCY_14_DAYS השכיחות היא 14 ימים.
RECENCY_15_DAYS השכיחות היא 15 ימים.
RECENCY_21_DAYS השכיחות היא 21 ימים.
RECENCY_28_DAYS השכיחות היא 28 ימים.
RECENCY_30_DAYS השכיחות היא 30 יום.
RECENCY_40_DAYS השכיחות היא 40 יום.
RECENCY_45_DAYS השכיחות היא 45 ימים.
RECENCY_60_DAYS השכיחות היא 60 יום.
RECENCY_90_DAYS השכיחות היא 90 יום.
RECENCY_120_DAYS השכיחות היא 120 ימים.
RECENCY_180_DAYS השכיחות היא 180 יום.
RECENCY_270_DAYS השכיחות היא 270 ימים.
RECENCY_365_DAYS השכיחות היא 365 ימים.

GoogleAudienceGroup

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

ייצוג JSON 
{
  "settings": [
    {
      object (GoogleAudienceTargetingSetting)
    }
  ]
}
שדות
settings[]

object (GoogleAudienceTargetingSetting)

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

GoogleAudienceTargetingSetting

פרטים על הגדרת הטירגוט לפי קהל של Google.

ייצוג JSON 
{
  "googleAudienceId": string
}
שדות
googleAudienceId

string (int64 format)

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

CustomListGroup

פרטי קבוצת רשימות בהתאמה אישית. כל הגדרות הטירגוט של רשימות מותאמות אישית מוגדרות באופן לוגי מסוג 'OR' אחת של השנייה.

ייצוג JSON 
{
  "settings": [
    {
      object (CustomListTargetingSetting)
    }
  ]
}
שדות
settings[]

object (CustomListTargetingSetting)

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

CustomListTargetingSetting

פרטים על הגדרת הטירגוט לרשימות מותאמות אישית.

ייצוג JSON 
{
  "customListId": string
}
שדות
customListId

string (int64 format)

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

CombinedAudienceGroup

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

ייצוג JSON 
{
  "settings": [
    {
      object (CombinedAudienceTargetingSetting)
    }
  ]
}
שדות
settings[]

object (CombinedAudienceTargetingSetting)

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

CombinedAudienceTargetingSetting

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

ייצוג JSON 
{
  "combinedAudienceId": string
}
שדות
combinedAudienceId

string (int64 format)

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

BrowserAssignedTargetingOptionDetails

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

ייצוג JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
שדות
displayName

string

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

string

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

boolean

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

HouseholdIncomeAssignedTargetingOptionDetails

פרטים על אפשרות הטירגוט לפי הכנסה למשק בית שהוקצתה השדה הזה יאוכלס בשדה הפרטים ב-AssignTargetOption כשהערך של targetingType הוא TARGETING_TYPE_HOUSEHOLD_INCOME.

ייצוג JSON 
{
  "householdIncome": enum (HouseholdIncome),
  "targetingOptionId": string
}
שדות
householdIncome

enum (HouseholdIncome)

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

פלט רק בגרסה 1. חובה בגרסה 2.
targetingOptionId

string

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

OnScreenPositionAssignedTargetingOptionDetails

פרטים על אפשרות הטירגוט למיקום במסך. הערך הזה יאוכלס בשדה onScreenPositionDetails כשהערך של targetingType יהיה TARGETING_TYPE_ON_SCREEN_POSITION.

ייצוג JSON 
{
  "targetingOptionId": string,
  "onScreenPosition": enum (OnScreenPosition),
  "adType": enum (AdType)
}
שדות
targetingOptionId

string

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

enum (OnScreenPosition)

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

enum (AdType)

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

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

CarrierAndIspAssignedTargetingOptionDetails

פרטי אפשרות הטירגוט לספקים וספקי אינטרנט שהוקצו. השדה הזה יאוכלס בשדה הפרטים ב-AssignTargetOption כשהערך של targetingType הוא TARGETING_TYPE_CARRIER_AND_ISP.

ייצוג JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
שדות
displayName

string

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

string

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

boolean

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

KeywordAssignedTargetingOptionDetails

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

ייצוג JSON 
{
  "keyword": string,
  "negative": boolean
}
שדות
keyword

string

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

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

boolean

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

NegativeKeywordListAssignedTargetingOptionDetails

פרטי טירגוט לרשימת מילות מפתח שליליות. השדה הזה יאוכלס בשדה הפרטים ב-AssignTargetOption כשהערך של targetingType הוא TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

ייצוג JSON 
{
  "negativeKeywordListId": string
}
שדות
negativeKeywordListId

string (int64 format)

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

OperatingSystemAssignedTargetingOptionDetails

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

ייצוג JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
שדות
displayName

string

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

string

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

boolean

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

DeviceMakeModelAssignedTargetingOptionDetails

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

ייצוג JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
שדות
displayName

string

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

string

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

boolean

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

EnvironmentAssignedTargetingOptionDetails

פרטים על אפשרות הטירגוט בסביבה שהוקצתה. השדה הזה יאוכלס בשדה הפרטים ב-AssignTargetOption כשהערך של targetingType הוא TARGETING_TYPE_ENVIRONMENT.

ייצוג JSON 
{
  "environment": enum (Environment),
  "targetingOptionId": string
}
שדות
environment

enum (Environment)

סביבת השירות.

פלט רק בגרסה 1. חובה בגרסה 2.
targetingOptionId

string

חובה. targetingOptionId של TargetingOption מסוג TARGETING_TYPE_ENVIRONMENT (למשל, " 508010" לטירגוט לאפשרות ENVIRONMENT_WEB_OPTIMIZED).

InventorySourceAssignedTargetingOptionDetails

פרטי הטירגוט של מקור מלאי שטחי הפרסום. השדה הזה יאוכלס בשדה הפרטים ב-AssignTargetOption כשהערך של targetingType הוא TARGETING_TYPE_INVENTORY_SOURCE.

ייצוג JSON 
{
  "inventorySourceId": string
}
שדות
inventorySourceId

string (int64 format)

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

CategoryAssignedTargetingOptionDetails

פרטים על אפשרות הטירגוט לפי קטגוריה שהוקצו. הערך הזה יאוכלס בשדה categoryDetails כשהערך של targetingType יהיה TARGETING_TYPE_CATEGORY.

ייצוג JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
שדות
displayName

string

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

string

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

boolean

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

ViewabilityAssignedTargetingOptionDetails

פרטים על אפשרות הטירגוט לניראות שהוקצו. השדה הזה יאוכלס בשדה viewabilityDetails ב-AssignTargetOption כשהערך של targetingType הוא TARGETING_TYPE_VIEWABILITY.

ייצוג JSON 
{
  "viewability": enum (Viewability),
  "targetingOptionId": string
}
שדות
viewability

enum (Viewability)

אחוז הניראות הצפוי.

פלט רק בגרסה 1. חובה בגרסה 2.
targetingOptionId

string

חובה. targetingOptionId של TargetingOption מסוג TARGETING_TYPE_VIEWABILITY (למשל, " 509010" לטירגוט לאפשרות VIEWABILITY_10_PERCENT_OR_MORE).

AuthorizedSellerStatusAssignedTargetingOptionDetails

מייצג סטטוס של מפיץ מורשה שהוקצה. השדה הזה יאוכלס בשדה הפרטים ב-AssignTargetOption כשהערך של targetingType הוא TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

אם למשאב לא הוקצתה אפשרות טירגוט ל-TARGETING_TYPE_AUTHORIZED_SELLER_STATUS, הוא משתמש באפשרות 'מפיצים ומפיצים מורשים ישירים' כאפשרות.

ייצוג JSON 
{
  "authorizedSellerStatus": enum (AuthorizedSellerStatus),
  "targetingOptionId": string
}
שדות
authorizedSellerStatus

enum (AuthorizedSellerStatus)

פלט בלבד. הסטטוס של בית העסק המורשה לטירגוט.
targetingOptionId

string

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

LanguageAssignedTargetingOptionDetails

פרטים על אפשרות הטירגוט לפי שפה שהוקצתה. השדה הזה יאוכלס בשדה הפרטים ב-AssignTargetOption כשהערך של targetingType הוא TARGETING_TYPE_LANGUAGE.

ייצוג JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
שדות
displayName

string

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

string

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

boolean

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

GeoRegionAssignedTargetingOptionDetails

פרטים על אפשרות הטירגוט לפי אזור גיאוגרפי שהוקצתה. השדה הזה יאוכלס בשדה הפרטים ב-AssignTargetOption כשהערך של targetingType הוא TARGETING_TYPE_GEO_REGION.

ייצוג JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "geoRegionType": enum (GeoRegionType),
  "negative": boolean
}
שדות
displayName

string

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

string

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

enum (GeoRegionType)

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

boolean

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

InventorySourceGroupAssignedTargetingOptionDetails

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

ייצוג JSON 
{
  "inventorySourceGroupId": string
}
שדות
inventorySourceGroupId

string (int64 format)

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

DigitalContentLabelAssignedTargetingOptionDetails

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

ייצוג JSON 
{
  "excludedTargetingOptionId": string,
  "contentRatingTier": enum (ContentRatingTier)
}
שדות
excludedTargetingOptionId

string

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

enum (ContentRatingTier)

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

SensitiveCategoryAssignedTargetingOptionDetails

פרטי טירגוט לקטגוריה רגישה. השדה הזה יאוכלס בשדה הפרטים ב-AssignTargetOption כשהערך של targetingType הוא TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

ייצוג JSON 
{
  "excludedTargetingOptionId": string,
  "sensitiveCategory": enum (SensitiveCategory)
}
שדות
excludedTargetingOptionId

string

חובה. מזהה של קטגוריית הרגישות שרוצים להחריג.
sensitiveCategory

enum (SensitiveCategory)

פלט בלבד. טיפוסים בני מנייה (enum) לסיווג תוכן בקטגוריה רגישה ב-DV360.

ExchangeAssignedTargetingOptionDetails

פרטים על אפשרות הטירגוט ל-Exchange שהוקצתה. השדה הזה יאוכלס בשדה הפרטים ב-AssignTargetOption כשהערך של targetingType הוא TARGETING_TYPE_EXCHANGE.

ייצוג JSON 
{
  "targetingOptionId": string
}
שדות
targetingOptionId

string

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

SubExchangeAssignedTargetingOptionDetails

פרטים על אפשרות הטירגוט ל-Sub-Exchange. השדה הזה יאוכלס בשדה הפרטים ב-AssignTargetOption כשהערך של targetingType הוא TARGETING_TYPE_SUB_EXCHANGE.

ייצוג JSON 
{
  "targetingOptionId": string
}
שדות
targetingOptionId

string

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

ThirdPartyVerifierAssignedTargetingOptionDetails

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

ייצוג JSON 
{

  // 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.
}
שדות
שדה איחוד verifier. אתם יכולים לטרגט אחד משותפי אימות של צד שלישי כדי לאכוף את ערכי הסף של הגנה על המותג לגבי חשיפות. verifier יכול להיות רק אחת מהאפשרויות הבאות:
adloox

object (Adloox)

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

object (DoubleVerify)

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

object (IntegralAdScience)

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

Adloox

פרטי ההגדרות של Adloox.

ייצוג JSON 
{
  "excludedAdlooxCategories": [
    enum (AdlooxCategory)
  ]
}
שדות
excludedAdlooxCategories[]

enum (AdlooxCategory)

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

AdlooxCategory

אפשרויות אפשריות ל-Adloox.

טיפוסים בני מנייה (enum)
ADLOOX_UNSPECIFIED הערך 'טיפוסים בני מנייה (enum)' הוא רק placeholder ולא מצוינת אפשרות של Adloox.
ADULT_CONTENT_HARD תוכן למבוגרים בלבד (קשה).
ADULT_CONTENT_SOFT תוכן למבוגרים בלבד (רך).
ILLEGAL_CONTENT תוכן לא חוקי
BORDERLINE_CONTENT תוכן גבולי.
DISCRIMINATORY_CONTENT תוכן מפלה.
VIOLENT_CONTENT_WEAPONS תוכן אלים כלי נשק.
LOW_VIEWABILITY_DOMAINS דומיינים עם רמת ניראות נמוכה.
FRAUD הונאה.

DoubleVerify

פרטי ההגדרות של DoubleVerify.

ייצוג JSON 
{
  "brandSafetyCategories": {
    object (BrandSafetyCategories)
  },
  "avoidedAgeRatings": [
    enum (AgeRating)
  ],
  "appStarRating": {
    object (AppStarRating)
  },
  "displayViewability": {
    object (DisplayViewability)
  },
  "videoViewability": {
    object (VideoViewability)
  },
  "fraudInvalidTraffic": {
    object (FraudInvalidTraffic)
  },
  "customSegmentId": string
}
שדות
brandSafetyCategories

object (BrandSafetyCategories)

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

enum (AgeRating)

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

object (AppStarRating)

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

object (DisplayViewability)

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

object (VideoViewability)

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

object (FraudInvalidTraffic)

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

string (int64 format)

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

BrandSafetyCategories

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

ייצוג JSON 
{
  "avoidUnknownBrandSafetyCategory": boolean,
  "avoidedHighSeverityCategories": [
    enum (HighSeverityCategory)
  ],
  "avoidedMediumSeverityCategories": [
    enum (MediumSeverityCategory)
  ]
}
שדות
avoidUnknownBrandSafetyCategory

boolean

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

enum (HighSeverityCategory)

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

enum (MediumSeverityCategory)

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

HighSeverityCategory

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

טיפוסים בני מנייה (enum)
HIGHER_SEVERITY_UNSPECIFIED הערך 'טיפוסים בני מנייה (enum)' הוא רק placeholder ולא צוינו קטגוריות בדרגת חומרה גבוהה.
ADULT_CONTENT_PORNOGRAPHY תוכן למבוגרים בלבד: פורנוגרפיה, נושאים למבוגרים בלבד עירום.
COPYRIGHT_INFRINGEMENT הפרת זכויות יוצרים.
SUBSTANCE_ABUSE סמים/אלכוהול/חומרים מבוקרים: התמכרות לחומרים.
GRAPHIC_VIOLENCE_WEAPONS אלימות/כלי נשק באופן קיצוני או בוטה באופן קיצוני.
HATE_PROFANITY שנאה/שפה גסה.
CRIMINAL_SKILLS פעילויות לא חוקיות: מיומנויות פליליות.
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER תמריצים/תוכנות זדוניות/בלגן.

MediumSeverityCategory

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

טיפוסים בני מנייה (enum)
MEDIUM_SEVERITY_UNSPECIFIED הערך של 'טיפוסים בני מנייה (enum)' הוא רק placeholder ולא צוינו קטגוריות בחומרה בינונית.
AD_SERVERS שרתי מודעות.
ADULT_CONTENT_SWIMSUIT תוכן למבוגרים בלבד: בגד ים.
ALTERNATIVE_LIFESTYLES נושאים שנויים במחלוקת: סגנון חיים אלטרנטיבי.
CELEBRITY_GOSSIP נושאים שנויים במחלוקת: רכילות על ידוענים.
GAMBLING נושאים שנויים במחלוקת: הימורים.
OCCULT נושאים שנויים במחלוקת: תורת הנסתר.
SEX_EDUCATION נושאים שנויים במחלוקת: חינוך מיני.
DISASTER_AVIATION אסון: תעופה.
DISASTER_MAN_MADE אסון: מעשה ידי אדם.
DISASTER_NATURAL אסון: טבעי.
DISASTER_TERRORIST_EVENTS אסון: אירועי טרור.
DISASTER_VEHICLE אסון: כלי רכב.
ALCOHOL סמים/אלכוהול/חומרים מבוקרים: אלכוהול.
SMOKING סמים/אלכוהול/חומרים מבוקרים: עישון.
NEGATIVE_NEWS_FINANCIAL חדשות שליליות: פיננסי.
NON_ENGLISH תוכן שאינו באנגלית:
PARKING_PAGE תוכן שאינו Std: דף חנייה.
UNMODERATED_UGC תוכן שנוצר על ידי משתמשים שלא עבר ניהול: פורומים, תמונות סרטון.
INFLAMMATORY_POLITICS_AND_NEWS נושאים שנויים במחלוקת: פוליטיקה וחדשות מלבה יצרים.
NEGATIVE_NEWS_PHARMACEUTICAL חדשות שליליות: תרופות.

AgeRating

אפשרויות אפשריות לדירוגי גיל.

טיפוסים בני מנייה (enum)
AGE_RATING_UNSPECIFIED הערך 'טיפוסים בני מנייה (enum)' הוא רק placeholder ולא צוינו בו אפשרויות לדירוג גיל.
APP_AGE_RATE_UNKNOWN אפליקציות עם סיווג גיל לא ידוע.
APP_AGE_RATE_4_PLUS אפליקציות שסווגו לכולם (4 ומעלה).
APP_AGE_RATE_9_PLUS אפליקציות שסווגו לכולם (9 ומעלה).
APP_AGE_RATE_12_PLUS אפליקציות שסווגו לבני נוער (12 ומעלה).
APP_AGE_RATE_17_PLUS אפליקציות בסיווג למבוגרים (17 ומעלה).
APP_AGE_RATE_18_PLUS אפליקציות בדירוג למבוגרים בלבד (18 ומעלה).

AppStarRating

פרטי ההגדרות של דירוג הכוכבים של DoubleVerify.

ייצוג JSON 
{
  "avoidedStarRating": enum (StarRating),
  "avoidInsufficientStarRating": boolean
}
שדות
avoidedStarRating

enum (StarRating)

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

boolean

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

StarRating

אפשרויות אפשריות לדירוג כוכבים.

טיפוסים בני מנייה (enum)
APP_STAR_RATE_UNSPECIFIED הערך 'טיפוסים בני מנייה (enum)' הוא רק placeholder ולא צוינו בו אפשרויות לדירוג כוכבים של אפליקציות.
APP_STAR_RATE_1_POINT_5_LESS אפליקציות רשמיות עם דירוג < 1.5 כוכבים.
APP_STAR_RATE_2_LESS אפליקציות רשמיות עם דירוג < 2 כוכבים.
APP_STAR_RATE_2_POINT_5_LESS אפליקציות רשמיות עם דירוג < 2.5 כוכבים.
APP_STAR_RATE_3_LESS אפליקציות רשמיות עם דירוג < 3 כוכבים.
APP_STAR_RATE_3_POINT_5_LESS אפליקציות רשמיות עם דירוג < 3.5 כוכבים.
APP_STAR_RATE_4_LESS אפליקציות רשמיות עם דירוג < 4 כוכבים.
APP_STAR_RATE_4_POINT_5_LESS אפליקציות רשמיות עם דירוג < 4.5 כוכבים.

DisplayViewability

פרטי ההגדרות של DoubleVerify בנושא ניראות ברשת המדיה.

ייצוג JSON 
{
  "iab": enum (IAB),
  "viewableDuring": enum (ViewableDuring)
}
שדות
iab

enum (IAB)

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

enum (ViewableDuring)

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

IAB

אפשרויות אפשריות לשיעור הניראות של IAB.

טיפוסים בני מנייה (enum)
IAB_VIEWED_RATE_UNSPECIFIED הערך 'טיפוסים בני מנייה (enum)' הוא רק placeholder ולא צוינו אפשרויות שיעור הצפייה בסרטונים של IAB.
IAB_VIEWED_RATE_80_PERCENT_HIGHER כדאי לטרגט מלאי שטחי פרסום באתרים ובאפליקציות כדי למקסם את שיעור הניראות של IAB ב-80% או יותר.
IAB_VIEWED_RATE_75_PERCENT_HIGHER כדאי לטרגט מלאי שטחי פרסום באתרים ובאפליקציות כדי למקסם את שיעור הניראות של IAB ב-75% או יותר.
IAB_VIEWED_RATE_70_PERCENT_HIGHER כדאי לטרגט מלאי שטחי פרסום באתרים ובאפליקציות כדי למקסם את שיעור הניראות של IAB ב-70% או יותר.
IAB_VIEWED_RATE_65_PERCENT_HIGHER כדאי לטרגט מלאי שטחי פרסום באתרים ובאפליקציות כדי למקסם את שיעור הניראות של IAB ב-65% או יותר.
IAB_VIEWED_RATE_60_PERCENT_HIGHER כדאי לטרגט מלאי שטחי פרסום באתרים ובאפליקציות כדי למקסם את שיעור הניראות של IAB ב-60% או יותר.
IAB_VIEWED_RATE_55_PERCENT_HIGHER לטרגט מלאי שטחי פרסום באתרים ובאפליקציות כדי למקסם את שיעור הניראות של IAB ב-55% או יותר.
IAB_VIEWED_RATE_50_PERCENT_HIGHER כדאי לטרגט מלאי שטחי פרסום באתרים ובאפליקציות כדי למקסם את שיעור הניראות של IAB ב-50% או יותר.
IAB_VIEWED_RATE_40_PERCENT_HIGHER כדאי לטרגט את מלאי שטחי הפרסום באתרים ובאפליקציות כדי למקסם את שיעור הניראות של IAB ב-40% או יותר.
IAB_VIEWED_RATE_30_PERCENT_HIGHER כדאי לטרגט מלאי שטחי פרסום באתרים ובאפליקציות כדי למקסם את שיעור הניראות של IAB ב-30% או יותר.

ViewableDuring

אפשרויות אפשריות למשך הזמן שבו ניתן לצפות

טיפוסים בני מנייה (enum)
AVERAGE_VIEW_DURATION_UNSPECIFIED הערך 'טיפוסים בני מנייה (enum)' הוא רק placeholder ולא צוינו אפשרויות של משך צפייה ממוצע.
AVERAGE_VIEW_DURATION_5_SEC כדאי לטרגט את מלאי שטחי הפרסום באינטרנט ובאפליקציות כדי למקסם את משך הניראות ל-100% למשך 5 שניות או יותר.
AVERAGE_VIEW_DURATION_10_SEC כדאי לטרגט את מלאי שטחי הפרסום באתרים ובאפליקציות כדי למקסם את משך הניראות של 100% למשך 10 שניות או יותר.
AVERAGE_VIEW_DURATION_15_SEC כדאי לטרגט את מלאי שטחי הפרסום באתרים ובאפליקציות כדי למקסם את משך הניראות ל-100% למשך 15 שניות או יותר.

VideoViewability

פרטי ההגדרות של DoubleVerify בנושא ניראות הסרטון.

ייצוג JSON 
{
  "videoIab": enum (VideoIAB),
  "videoViewableRate": enum (VideoViewableRate),
  "playerImpressionRate": enum (PlayerImpressionRate)
}
שדות
videoIab

enum (VideoIAB)

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

enum (VideoViewableRate)

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

enum (PlayerImpressionRate)

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

VideoIAB

אפשרויות אפשריות לשיעור הניראות של IAB.

טיפוסים בני מנייה (enum)
VIDEO_IAB_UNSPECIFIED הערך 'טיפוסים בני מנייה (enum)' הוא רק placeholder, ולא צוינו בו אפשרויות לשיעור הצפייה בסרטונים לפי IAB.
IAB_VIEWABILITY_80_PERCENT_HIGHER כדאי לטרגט מלאי שטחי פרסום באתרים ובאפליקציות כדי למקסם את שיעור הניראות של IAB ב-80% או יותר.
IAB_VIEWABILITY_75_PERCENT_HIGHER כדאי לטרגט מלאי שטחי פרסום באתרים ובאפליקציות כדי למקסם את שיעור הניראות של IAB ב-75% או יותר.
IAB_VIEWABILITY_70_PERCENT_HIGHER כדאי לטרגט מלאי שטחי פרסום באתרים ובאפליקציות כדי למקסם את שיעור הניראות של IAB ב-70% או יותר.
IAB_VIEWABILITY_65_PERCENT_HIHGER כדאי לטרגט מלאי שטחי פרסום באתרים ובאפליקציות כדי למקסם את שיעור הניראות של IAB ב-65% או יותר.
IAB_VIEWABILITY_60_PERCENT_HIGHER כדאי לטרגט מלאי שטחי פרסום באתרים ובאפליקציות כדי למקסם את שיעור הניראות של IAB ב-60% או יותר.
IAB_VIEWABILITY_55_PERCENT_HIHGER לטרגט מלאי שטחי פרסום באתרים ובאפליקציות כדי למקסם את שיעור הניראות של IAB ב-55% או יותר.
IAB_VIEWABILITY_50_PERCENT_HIGHER כדאי לטרגט מלאי שטחי פרסום באתרים ובאפליקציות כדי למקסם את שיעור הניראות של IAB ב-50% או יותר.
IAB_VIEWABILITY_40_PERCENT_HIHGER כדאי לטרגט את מלאי שטחי הפרסום באתרים ובאפליקציות כדי למקסם את שיעור הניראות של IAB ב-40% או יותר.
IAB_VIEWABILITY_30_PERCENT_HIHGER כדאי לטרגט מלאי שטחי פרסום באתרים ובאפליקציות כדי למקסם את שיעור הניראות של IAB ב-30% או יותר.

VideoViewableRate

אפשרויות אפשריות של שיעור לצפייה מלאה.

טיפוסים בני מנייה (enum)
VIDEO_VIEWABLE_RATE_UNSPECIFIED הערך 'טיפוסים בני מנייה (enum)' הוא רק placeholder ולא מפורטות בו אפשרויות לשיעור הצפייה בסרטונים.
VIEWED_PERFORMANCE_40_PERCENT_HIGHER כדאי לטרגט מלאי שטחי הפרסום באינטרנט כדי למקסם את שיעור הניראות והזמינות למדידה של 40% ומעלה.
VIEWED_PERFORMANCE_35_PERCENT_HIGHER כדאי לטרגט מלאי שטחי פרסום באינטרנט כדי למקסם את שיעור הניראות והזמינות למדידה של 35% ומעלה.
VIEWED_PERFORMANCE_30_PERCENT_HIGHER כדאי לטרגט מלאי שטחי פרסום באינטרנט כדי למקסם את שיעור הניראות והזמינות למדידה של 30% ומעלה.
VIEWED_PERFORMANCE_25_PERCENT_HIGHER כדאי לטרגט מלאי שטחי פרסום באינטרנט כדי למקסם את שיעור הניראות והזמינות למדידה של 25% ומעלה.
VIEWED_PERFORMANCE_20_PERCENT_HIGHER כדאי לטרגט מלאי שטחי פרסום באינטרנט כדי למקסם את שיעור הניראות והזמינות למדידה של 20% ומעלה.
VIEWED_PERFORMANCE_10_PERCENT_HIGHER כדאי לטרגט מלאי שטחי פרסום באינטרנט כדי למקסם את שיעור הניראות והזמינות למדידה ב-10% ומעלה.

PlayerImpressionRate

אפשרויות אפשריות לחשיפות.

טיפוסים בני מנייה (enum)
PLAYER_SIZE_400X300_UNSPECIFIED הערך 'טיפוסים בני מנייה (enum)' הוא רק placeholder ולא מוגדרות בו אפשרויות לחשיפות.
PLAYER_SIZE_400X300_95 אתרים עם מעל 95%מהחשיפות.
PLAYER_SIZE_400X300_70 אתרים עם יותר מ-70%מהחשיפות.
PLAYER_SIZE_400X300_25 אתרים עם יותר מ-25%מהחשיפות.
PLAYER_SIZE_400X300_5 אתרים עם למעלה מ-5%מהחשיפות.

FraudInvalidTraffic

הונאה של DoubleVerify הגדרות תנועה לא חוקית.

ייצוג JSON 
{
  "avoidedFraudOption": enum (FraudOption),
  "avoidInsufficientOption": boolean
}
שדות
avoidedFraudOption

enum (FraudOption)

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

boolean

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

FraudOption

אפשרויות אפשריות של הונאות היסטוריות שיעור IVT.

טיפוסים בני מנייה (enum)
FRAUD_UNSPECIFIED הערך הזה הוא רק placeholder ולא מציין אפשרויות של הונאות ותנועה פסולה.
AD_IMPRESSION_FRAUD_100 100% הונאות תנועה פסולה (IVT).
AD_IMPRESSION_FRAUD_50 הונאה או רמה גבוהה יותר של הונאה תנועה פסולה (IVT).
AD_IMPRESSION_FRAUD_25 25% או יותר הונאות תנועה פסולה (IVT).
AD_IMPRESSION_FRAUD_10 10% או רמה גבוהה יותר של הונאה תנועה פסולה (IVT).
AD_IMPRESSION_FRAUD_8 8% או רמה גבוהה יותר של הונאה תנועה פסולה (IVT).
AD_IMPRESSION_FRAUD_6 6% או יותר הונאות תנועה פסולה (IVT).
AD_IMPRESSION_FRAUD_4 4% או רמה גבוהה יותר של הונאה תנועה פסולה (IVT).
AD_IMPRESSION_FRAUD_2 2% או יותר הונאות תנועה פסולה (IVT).

IntegralAdScience

פרטי ההגדרות של Integral Ad Science.

ייצוג JSON 
{
  "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
  ]
}
שדות
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 (int64 format)

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

TRAQScore

טווחי ציון אפשריים של Integral Ad Science TRAQ (איכות הפרסום האמיתית).

טיפוסים בני מנייה (enum)
TRAQ_UNSPECIFIED הערך הזה הוא רק placeholder ולא מציין ציוני איכות אמיתיים של פרסום.
TRAQ_250 ציון TRAQ של 250-1000.
TRAQ_500 ציון TRAQ: 500-1000.
TRAQ_600 ציון TRAQ הוא 600-1000.
TRAQ_700 ציון TRAQ: 700-1000.
TRAQ_750 ציון TRAQ: 750-1000.
TRAQ_875 ציון TRAQ: 875-1000.
TRAQ_1000 ציון TRAQ 1,000.

אדם מבוגר

אפשרויות אפשריות ל-Integral Ad Science למבוגרים בלבד.

טיפוסים בני מנייה (enum)
ADULT_UNSPECIFIED הערך של 'טיפוסים בני מנייה (enum)' הוא רק placeholder ולא מוגדרות בו אפשרויות למבוגרים בלבד.
ADULT_HR מבוגר – לא לכלול סיכון גבוה.
ADULT_HMR מבוגרים – אין לכלול סיכון גבוה ובינוני.

אלכוהול

אפשרויות אפשריות ל-Integral Ad Science אלכוהול ב-Integral Ad Science.

טיפוסים בני מנייה (enum)
ALCOHOL_UNSPECIFIED הערך של 'טיפוסים בני מנייה (enum)' הוא רק placeholder ולא מפורטות בו אפשרויות אלכוהול.
ALCOHOL_HR אלכוהול - החרגה של סיכון גבוה.
ALCOHOL_HMR אלכוהול - לא כולל סיכון גבוה ובינוני.

IllegalDownloads

אפשרויות אפשריות להורדות לא חוקיות של Integral Ad Science.

טיפוסים בני מנייה (enum)
ILLEGAL_DOWNLOADS_UNSPECIFIED ה-enum הזה הוא רק placeholder ולא מפורטות בו אפשרויות להורדות לא חוקיות.
ILLEGAL_DOWNLOADS_HR הורדות לא חוקיות – החרגה של סיכון גבוה.
ILLEGAL_DOWNLOADS_HMR הורדות לא חוקיות – החרגה של סיכון גבוה ובינוני.

סמים

אפשרויות אפשריות לתרופות של Integral Ad Science.

טיפוסים בני מנייה (enum)
DRUGS_UNSPECIFIED הערך 'טיפוסים בני מנייה (enum)' הוא רק placeholder ולא מפורטות בו אפשרויות לגבי סמים.
DRUGS_HR תרופות - החרגה של סיכון גבוה.
DRUGS_HMR תרופות - החרגה של סיכון גבוה ובינוני.

HateSpeech

אפשרויות אפשריות לדברי שטנה ב-Integral Ad Science.

טיפוסים בני מנייה (enum)
HATE_SPEECH_UNSPECIFIED הערך הזה הוא רק placeholder ולא צוינו אפשרויות של דברי שטנה.
HATE_SPEECH_HR דברי שטנה – החרגה של סיכון גבוה.
HATE_SPEECH_HMR דברי שטנה – החרגה של סיכון גבוה ובינוני.

OffensiveLanguage

אפשרויות של שפה פוגענית ב-Integral Ad Science.

טיפוסים בני מנייה (enum)
OFFENSIVE_LANGUAGE_UNSPECIFIED הערך 'טיפוסים בני מנייה (enum)' הוא רק placeholder ולא מוגדרות בו אפשרויות שפה.
OFFENSIVE_LANGUAGE_HR שפה פוגענית – החרגה של רמת סיכון גבוהה.
OFFENSIVE_LANGUAGE_HMR שפה פוגענית – החרגה של סיכון גבוה ובינוני.

אלימות

אפשרויות אפשריות לאלימות ב-Integral Ad Science.

טיפוסים בני מנייה (enum)
VIOLENCE_UNSPECIFIED הערך של 'טיפוסים בני מנייה (enum)' הוא רק placeholder ולא מפורטות בו אפשרויות לאלימות.
VIOLENCE_HR אלימות – החרגה של סיכון גבוה.
VIOLENCE_HMR אלימות – יש להחריג סיכון גבוה ובינוני.

הימורים

אפשרויות אפשריות להימורים ב-Integral Ad Science.

טיפוסים בני מנייה (enum)
GAMBLING_UNSPECIFIED הערך 'טיפוסים בני מנייה (enum)' הוא רק placeholder ולא מפורטות בו אפשרויות להימורים.
GAMBLING_HR הימורים - החרגה של סיכון גבוה.
GAMBLING_HMR הימורים - החרגה של סיכון גבוה ובינוני.

AdFraudPrevention

אפשרויות אפשריות למניעת הונאות במודעות ב-Integral Ad Science.

טיפוסים בני מנייה (enum)
SUSPICIOUS_ACTIVITY_UNSPECIFIED הערך הזה הוא רק placeholder ולא צוינו בו אפשרויות למניעת הונאות במודעות.
SUSPICIOUS_ACTIVITY_HR זיוף קליקים על מודעות – החרגת סיכון גבוה.
SUSPICIOUS_ACTIVITY_HMR זיוף קליקים על מודעות – החרגה של סיכון גבוה ובינוני.

DisplayViewability

אפשרויות אפשריות לניראות ברשת המדיה של Integral Ad Science.

טיפוסים בני מנייה (enum)
PERFORMANCE_VIEWABILITY_UNSPECIFIED ה-enum הזה הוא רק placeholder ולא מפורטות בו אפשרויות של ניראות ברשת המדיה.
PERFORMANCE_VIEWABILITY_40 יעד ניראות של 40% או יותר.
PERFORMANCE_VIEWABILITY_50 יעד ניראות של 50% או יותר.
PERFORMANCE_VIEWABILITY_60 יעד ניראות של 60% או יותר.
PERFORMANCE_VIEWABILITY_70 יעד ניראות של 70% או יותר.

VideoViewability

אפשרויות אפשריות לניראות של Integral Ad Science Video.

טיפוסים בני מנייה (enum)
VIDEO_VIEWABILITY_UNSPECIFIED הערך הזה הוא רק placeholder ולא צוינו אפשרויות הניראות של מודעות וידאו.
VIDEO_VIEWABILITY_40 מעל 40%צפיות (תקן הניראות של מודעות וידאו של IAB).
VIDEO_VIEWABILITY_50 מעל 50%מצפיות (תקן IAB למדידת ניראות של מודעות וידאו).
VIDEO_VIEWABILITY_60 מעל 60%צפיות (תקן הניראות של מודעות וידאו של IAB).
VIDEO_VIEWABILITY_70 מעל 70%צפיות (תקן הניראות של מודעות וידאו של IAB).

PoiAssignedTargetingOptionDetails

פרטים על אפשרות הטירגוט לנקודות עניין שהוקצתה. השדה הזה יאוכלס בשדה הפרטים ב-AssignTargetOption כשהערך של targetingType הוא TARGETING_TYPE_POI.

ייצוג JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "latitude": number,
  "longitude": number,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
שדות
displayName

string

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

string

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

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

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

number

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

number

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

number

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

enum (DistanceUnit)

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

DistanceUnit

אפשרויות אפשריות של יחידות מרחק.

טיפוסים בני מנייה (enum)
DISTANCE_UNIT_UNSPECIFIED ערך הסוג לא צוין או שאינו ידוע בגרסה הזו.
DISTANCE_UNIT_MILES מיילים.
DISTANCE_UNIT_KILOMETERS קילומטרים.

BusinessChainAssignedTargetingOptionDetails

פרטים על אפשרות הטירגוט של הרשת העסקית. השדה הזה יאוכלס בשדה הפרטים ב-AssignTargetOption כשהערך של targetingType הוא TARGETING_TYPE_BUSINESS_CHAIN.

ייצוג JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
שדות
displayName

string

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

string

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

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

number

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

enum (DistanceUnit)

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

ContentDurationAssignedTargetingOptionDetails

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

ייצוג JSON 
{
  "targetingOptionId": string,
  "contentDuration": enum (ContentDuration)
}
שדות
targetingOptionId

string

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

enum (ContentDuration)

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

ContentStreamTypeAssignedTargetingOptionDetails

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

ייצוג JSON 
{
  "targetingOptionId": string,
  "contentStreamType": enum (ContentStreamType)
}
שדות
targetingOptionId

string

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

enum (ContentStreamType)

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

NativeContentPositionAssignedTargetingOptionDetails

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

ייצוג JSON 
{
  "targetingOptionId": string,
  "contentPosition": enum (NativeContentPosition)
}
שדות
targetingOptionId

string

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

enum (NativeContentPosition)

המיקום של התוכן.

פלט רק בגרסה 1. חובה בגרסה 2.

OmidAssignedTargetingOptionDetails

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

ייצוג JSON 
{
  "omid": enum (Omid),
  "targetingOptionId": string
}
שדות
omid

enum (Omid)

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

פלט רק בגרסה 1. חובה בגרסה 2.
targetingOptionId

string

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

AudioContentTypeAssignedTargetingOptionDetails

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

ייצוג JSON 
{
  "targetingOptionId": string,
  "audioContentType": enum (AudioContentType)
}
שדות
targetingOptionId

string

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

enum (AudioContentType)

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

פלט רק בגרסה 1. חובה בגרסה 2.

ContentGenreAssignedTargetingOptionDetails

פרטים על אפשרות הטירגוט שהוקצתה לפי ז'אנר של תוכן. הערך הזה יאוכלס בשדה contentGenreDetails כשהערך של targetingType יהיה TARGETING_TYPE_CONTENT_GENRE. אין תמיכה בטירגוט מפורש של כל האפשרויות. כדי להשיג את האפקט הזה, צריך להסיר את כל אפשרויות הטירגוט לפי ז'אנר של תוכן.

ייצוג JSON 
{
  "targetingOptionId": string,
  "displayName": string,
  "negative": boolean
}
שדות
targetingOptionId

string

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

string

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

boolean

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

שיטות

get

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

list

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