REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

משאב: AssignedTargetingOption

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

ייצוג 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.

בכל משאב ניתן להקצות עד ארבע רשימות של מילות מפתח שליליות.
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.

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

אם למשאב מסוים אין אפשרות של סטטוס מפיץ מורשה, כברירת מחדל כל המפיצים המורשים שצוינו בקובץ 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)

פרטי ה-Sub-Exchange. השדה הזה יאוכלס כשהערך בשדה 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)

פרטים על משך התוכן. השדה הזה יאוכלס כאשר סוג ה-TargetingType הוא 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.

ירושה

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

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

ChannelAssignedTargetingOptionDetails

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

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

string (int64 format)

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

boolean

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

AppCategoryAssignedTargetingOptionDetails

פרטים על אפשרות הטירגוט לפי קטגוריית אפליקציות שהוקצתה לכם. הערך הזה יאוכלס בשדה appCategoryDetails ב- AssignedTargetingOption כאשר הערך של 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

פרטים על האפשרות שהוקצתה לטירגוט לאפליקציות. הערך הזה יאוכלס בשדה הפרטים של AssignedTargetingOption כאשר הערך של 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

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

טיפוסים בני מנייה (enums)
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 שהוקצתה. הערך הזה יאוכלס בשדה הפרטים של AssignedTargetingOption כאשר הערך של targetingType הוא TARGETING_TYPE_URL.

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

string

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

ב-DV360 יש תמיכה בשתי רמות של טירגוט לפי ספריות משנה, למשל www.example.com/one-subdirectory-level/second-level, ובחמש רמות של טירגוט לפי תת-דומיין, למשל 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

מייצג את היום בשבוע.

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

TimeZoneResolution

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

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

AgeRangeAssignedTargetingOptionDetails

מייצג טווח גילאים שניתן למקד אליו. הערך הזה יאוכלס בשדה הפרטים של AssignedTargetingOption כאשר הערך של 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

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

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

string (int64 format)

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

boolean

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

ProximityLocationListAssignedTargetingOptionDetails

פרטי טירגוט לרשימת מיקומים קרובים. הערך הזה יאוכלס בשדה הפרטים של AssignedTargetingOption כאשר הערך של 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 בעיר מאוכלסת בצפיפות.

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

GenderAssignedTargetingOptionDetails

פרטים על האפשרות שהוקצתה לטירגוט לפי מגדר. הערך הזה יאוכלס בשדה הפרטים של AssignedTargetingOption כאשר הערך של 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

פרטים על אפשרות הטירגוט לפי סטטוס הורה שהוקצה לכם. הערך הזה יאוכלס בשדה הפרטים של AssignedTargetingOption כאשר הערך של 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)

מיקום התוכן בסרטון עבור מודעות וידאו או מודעות אודיו.

פלט רק בגרסה 1. נדרשת בגרסה 2.
adType

enum (AdType)

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

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

AdType

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

טיפוסים בני מנייה (enums)
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

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

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

string

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

enum (DeviceType)

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

פלט רק בגרסה 1. נדרשת בגרסה 2.

AudienceGroupAssignedTargetingOptionDetails

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

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

object (FirstAndThirdPartyAudienceGroup)

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

object (GoogleAudienceGroup)

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

object (CustomListGroup)

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

object (CombinedAudienceGroup)

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

object (FirstAndThirdPartyAudienceGroup)

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

object (GoogleAudienceGroup)

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

FirstAndThirdPartyAudienceGroup

פרטים על קבוצת היעד של צד ראשון ושל צד שלישי. כל הגדרות הטירגוט לפי קהל של צד ראשון וצד שלישי הן מבחינה לוגית '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 אם לא צוין אחרת, לא ייעשה שימוש במגבלת עדכניות.

שכיחות

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

טיפוסים בני מנייה (enums)
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 הן מבחינה לוגית מסוג 'OR'.

ייצוג 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

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

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

object (CombinedAudienceTargetingSetting)

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

CombinedAudienceTargetingSetting

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

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

string (int64 format)

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

BrowserAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

HouseholdIncomeAssignedTargetingOptionDetails

פרטים על אפשרות הטירגוט לפי הכנסה למשק בית שהוקצו. הערך הזה יאוכלס בשדה הפרטים של AssignedTargetingOption כאשר הערך של 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

פרטים על אפשרות הטירגוט לפי ספק וספק אינטרנט שהוקצתה להם. הערך הזה יאוכלס בשדה הפרטים של AssignedTargetingOption כאשר הערך של 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

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

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

string

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

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

boolean

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

NegativeKeywordListAssignedTargetingOptionDetails

פרטי טירגוט לרשימת מילות מפתח שליליות. הערך הזה יאוכלס בשדה הפרטים של AssignedTargetingOption כאשר הערך של 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

פרטים לגבי האפשרות של טירגוט לפי סביבה שהוקצתה הערך הזה יאוכלס בשדה הפרטים של AssignedTargetingOption כאשר הערך של 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

פרטי הטירגוט למקור של מלאי שטחי הפרסום. הערך הזה יאוכלס בשדה הפרטים של AssignedTargetingOption כאשר הערך של 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 ב- AssignedTargetingOption כאשר הערך של 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

מייצג סטטוס של מפיץ מורשה שהוקצה. הערך הזה יאוכלס בשדה הפרטים של AssignedTargetingOption כאשר הערך של 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

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

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

string

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

string

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

boolean

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

GeoRegionAssignedTargetingOptionDetails

פרטים על אפשרות הטירגוט לפי אזור גיאוגרפי שהוקצה. הערך הזה יאוכלס בשדה הפרטים של AssignedTargetingOption כאשר הערך של 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

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

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

string (int64 format)

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

DigitalContentLabelAssignedTargetingOptionDetails

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

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

string

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

enum (ContentRatingTier)

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

SensitiveCategoryAssignedTargetingOptionDetails

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

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

string

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

enum (SensitiveCategory)

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

ExchangeAssignedTargetingOptionDetails

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

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

string

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

SubExchangeAssignedTargetingOptionDetails

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

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

string

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

ThirdPartyVerifierAssignedTargetingOptionDetails

פרטים לגבי אפשרות הטירגוט של מאמת של צד שלישי שהוקצה. הערך הזה יאוכלס בשדה הפרטים של AssignedTargetingOption כאשר הערך של 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 אפשריות.

טיפוסים בני מנייה (enums)
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

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

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

MediumSeverityCategory

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

טיפוסים בני מנייה (enums)
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 תוכן שאינו בפורמט Std: לא באנגלית.
PARKING_PAGE תוכן שאינו רלוונטי ל-Std: דף חניה.
UNMODERATED_UGC תוכן שנוצר על ידי משתמשים לא מבוקר: פורומים, תמונות וסרטונים.
INFLAMMATORY_POLITICS_AND_NEWS נושאים שנויים במחלוקת: חדשות ופוליטיקה מלבי יצרים.
NEGATIVE_NEWS_PHARMACEUTICAL חדשות שליליות: פרמצבטיקה.

AgeRating

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

טיפוסים בני מנייה (enums)
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

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

טיפוסים בני מנייה (enums)
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.

טיפוסים בני מנייה (enums)
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

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

טיפוסים בני מנייה (enums)
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.

טיפוסים בני מנייה (enums)
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

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

טיפוסים בני מנייה (enums)
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

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

טיפוסים בני מנייה (enums)
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).

טיפוסים בני מנייה (enums)
FRAUD_UNSPECIFIED טיפוסים בני מנייה (enum) זה הוא רק placeholder ולא מפורטים בו אפשרויות להונאות ולתנועה לא חוקית.
AD_IMPRESSION_FRAUD_100 100% הונאה ותנועה לא חוקית (IVT).
AD_IMPRESSION_FRAUD_50 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

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

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

אדם מבוגר

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

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

אלכוהול

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

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

IllegalDownloads

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

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

סמים

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

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

HateSpeech

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

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

OffensiveLanguage

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

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

אלימות

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

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

הימורים

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

טיפוסים בני מנייה (enums)
GAMBLING_UNSPECIFIED טיפוסים בני מנייה (enum) זה הוא רק placeholder ולא מפורטים בו אפשרויות להימורים.
GAMBLING_HR הימורים – לא לכלול סיכון גבוה.
GAMBLING_HMR הימורים – אין לכלול סיכון גבוה או בינוני.

AdFraudPrevention

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

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

DisplayViewability

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

טיפוסים בני מנייה (enums)
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.

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

PoiAssignedTargetingOptionDetails

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

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

string

פלט בלבד. השם המוצג של נקודת עניין, למשל "כיכר הרצל" או "מחט החלל", ואחריו הכתובת המלאה שלה, אם היא זמינה.
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

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

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

BusinessChainAssignedTargetingOptionDetails

פרטים על אפשרות הטירגוט לרשת עסקית שהוקצתה לכם. הערך הזה יאוכלס בשדה הפרטים של AssignedTargetingOption כאשר הערך של 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

מייצג סוג של מלאי שטחי פרסום שהופעל ב-Open Measurement שניתן לטרגט. הערך הזה יאוכלס בשדה הפרטים של AssignedTargetingOption כאשר הערך של 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

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