REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

משאב: AssignedTargetingOption

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

ייצוג JSON 
{
  "name": string,
  "assignedTargetingOptionId": string,
  "assignedTargetingOptionIdAlias": 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)
  },
  "youtubeVideoDetails": {
    object (YoutubeVideoAssignedTargetingOptionDetails)
  },
  "youtubeChannelDetails": {
    object (YoutubeChannelAssignedTargetingOptionDetails)
  },
  "sessionPositionDetails": {
    object (SessionPositionAssignedTargetingOptionDetails)
  }
  // End of list of possible types for union field details.
}
שדות
name

string

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

string

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

string

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

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

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

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

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
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.

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

אם למשאב אין אפשרות של סטטוס מפיץ מורשה, לכל המפיצים המורשים שצוינו בקובץ ads.txt מוגדר טירגוט של DIRECT או RESELLER כברירת מחדל.
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.
youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

פרטי הסרטון ב-YouTube. השדה הזה יאוכלס כאשר הערך של targetingType הוא TARGETING_TYPE_YOUTUBE_VIDEO.
youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

פרטים על ערוץ YouTube. השדה הזה יאוכלס כאשר הערך של targetingType הוא TARGETING_TYPE_YOUTUBE_CHANNEL.
sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

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

ירושה

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

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

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

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)
}
שדות
ageRange

enum (AgeRange)

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

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,
  "proximityRadius": number,
  "proximityRadiusUnit": enum (ProximityRadiusUnit)
}
שדות
proximityLocationListId

string (int64 format)

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

number

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

enum (ProximityRadiusUnit)

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

ProximityRadiusUnit

יחידות מרחק מסוג 'טיפוסים בני מנייה (enum)' לציון מידת הקרבה (ProximityRadius).

טיפוסים בני מנייה (enums)
PROXIMITY_RADIUS_UNIT_UNSPECIFIED ערך ברירת המחדל כשיחידות המרחק לא מצוינות בגרסה הזו. טיפוסים בני מנייה (enum) הם שמירת מקום לערך ברירת המחדל, והם לא מייצגים יחידת מרחק אמיתית.
PROXIMITY_RADIUS_UNIT_MILES יחידת המרחק של הרדיוס במיילים.
PROXIMITY_RADIUS_UNIT_KILOMETERS יחידת המרחק של הרדיוס בקילומטרים

GenderAssignedTargetingOptionDetails

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

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

enum (Gender)

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

VideoPlayerSizeAssignedTargetingOptionDetails

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

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

enum (VideoPlayerSize)

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

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)
}
שדות
parentalStatus

enum (ParentalStatus)

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

ContentInstreamPositionAssignedTargetingOptionDetails

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

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

enum (ContentInstreamPosition)

חובה. מיקום מודעת הווידאו או In-stream של מודעות הווידאו או האודיו.
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 
{
  "contentOutstreamPosition": enum (ContentOutstreamPosition),
  "adType": enum (AdType)
}
שדות
contentOutstreamPosition

enum (ContentOutstreamPosition)

חובה. המיקום של תוכן וידאו Outstream.
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 
{
  "deviceType": enum (DeviceType),
  "youtubeAndPartnersBidMultiplier": number
}
שדות
deviceType

enum (DeviceType)

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

number

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

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

רלוונטי רק לפריטים של YouTube ו-Partners.

AudienceGroupAssignedTargetingOptionDetails

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

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

object (FirstAndThirdPartyAudienceGroup)

המזהים והנכונות של הקהלים של צד ראשון ושל צד שלישי שנכללים בקבוצות הקהלים של צד ראשון ושל צד שלישי כל קבוצת קהל יעד של צד ראשון וצד שלישי מכילה רק מזהים של קהלים מאינטראקציה ישירה ומצד שלישי. הקשר בין כל קבוצת קהל של צד ראשון לבין קבוצת קהל של צד שלישי הוא Singapore, והתוצאה היא 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)
}
שדות
householdIncome

enum (HouseholdIncome)

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

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

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

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)
}
שדות
environment

enum (Environment)

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

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)
}
שדות
viewability

enum (Viewability)

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

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 
{
  "excludedContentRatingTier": enum (ContentRatingTier)
}
שדות
excludedContentRatingTier

enum (ContentRatingTier)

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

SensitiveCategoryAssignedTargetingOptionDetails

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

ייצוג JSON 
{
  "excludedSensitiveCategory": enum (SensitiveCategory)
}
שדות
excludedSensitiveCategory

enum (SensitiveCategory)

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

ExchangeAssignedTargetingOptionDetails

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

ייצוג JSON 
{
  "exchange": enum (Exchange)
}
שדות
exchange

enum (Exchange)

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

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

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

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

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

טיפוסים בני מנייה (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 שפה פוגענית – להחריג סיכון גבוה ובינוני.

אלימות

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

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

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

string

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

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

אם אתם מטרגטים קואורדינטת קו אורך/רוחב ספציפי שהוסרה מכתובת או משם של נקודת עניין, תוכלו ליצור את המזהה של אפשרות הטירגוט שדרושה על ידי עיגול ערכי הקואורדינטות הרצויים למקום השישי עשרוני, הסרת הספרות העשרוניות ושרשור הערכים של המחרוזת שמופרדים בנקודה ופסיק. לדוגמה, ניתן לטרגט את צמד קווי האורך והרוחב 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 
{
  "contentPosition": enum (NativeContentPosition)
}
שדות
contentPosition

enum (NativeContentPosition)

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

OmidAssignedTargetingOptionDetails

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

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

enum (Omid)

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

AudioContentTypeAssignedTargetingOptionDetails

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

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

enum (AudioContentType)

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

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

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

YoutubeVideoAssignedTargetingOptionDetails

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

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

string

מזהה הווידאו ב-YouTube כפי שהוא מופיע בדף הצפייה ב-YouTube.
negative

boolean

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

YoutubeChannelAssignedTargetingOptionDetails

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

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

string

מזהה הערוץ של מעלה הסרטון ב-YouTube או קוד הערוץ של ערוץ YouTube.
negative

boolean

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

SessionPositionAssignedTargetingOptionDetails

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

ייצוג JSON 
{
  "sessionPosition": enum (SessionPosition)
}
שדות
sessionPosition

enum (SessionPosition)

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

SessionPosition

מיקומים אפשריים בסשן.

טיפוסים בני מנייה (enums)
SESSION_POSITION_UNSPECIFIED זהו placeholder ולא מציין מיקומים.
SESSION_POSITION_FIRST_IMPRESSION החשיפה הראשונה של הסשן.

שיטות

get

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

list

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