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)

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

object (DeviceTypeAssignedTargetingOptionDetails)

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

object (AudienceGroupAssignedTargetingOptionDetails)

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

object (BrowserAssignedTargetingOptionDetails)

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

object (HouseholdIncomeAssignedTargetingOptionDetails)

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

object (OnScreenPositionAssignedTargetingOptionDetails)

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

object (CarrierAndIspAssignedTargetingOptionDetails)

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

object (KeywordAssignedTargetingOptionDetails)

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

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

object (NegativeKeywordListAssignedTargetingOptionDetails)

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

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

object (OperatingSystemAssignedTargetingOptionDetails)

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

object (DeviceMakeModelAssignedTargetingOptionDetails)

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

object (EnvironmentAssignedTargetingOptionDetails)

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

object (InventorySourceAssignedTargetingOptionDetails)

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

object (CategoryAssignedTargetingOptionDetails)

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

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

object (ViewabilityAssignedTargetingOptionDetails)

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

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

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

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

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

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

object (LanguageAssignedTargetingOptionDetails)

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

object (GeoRegionAssignedTargetingOptionDetails)

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

object (InventorySourceGroupAssignedTargetingOptionDetails)

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

object (DigitalContentLabelAssignedTargetingOptionDetails)

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

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

object (SensitiveCategoryAssignedTargetingOptionDetails)

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

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

object (ExchangeAssignedTargetingOptionDetails)

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

object (SubExchangeAssignedTargetingOptionDetails)

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

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

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

object (PoiAssignedTargetingOptionDetails)

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

object (BusinessChainAssignedTargetingOptionDetails)

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

object (ContentDurationAssignedTargetingOptionDetails)

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

object (ContentStreamTypeAssignedTargetingOptionDetails)

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

object (NativeContentPositionAssignedTargetingOptionDetails)

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

object (OmidAssignedTargetingOptionDetails)

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

object (AudioContentTypeAssignedTargetingOptionDetails)

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

object (ContentGenreAssignedTargetingOptionDetails)

פרטי הז'אנר של התוכן. השדה הזה יאוכלס כשהערך בשדה targetingType יהיה TARGETING_TYPE_CONTENT_GENRE.
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.

ירושה

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

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

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

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

string

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

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

string

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

boolean

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

enum (AppPlatform)

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

AppPlatform

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

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

UrlAssignedTargetingOptionDetails

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

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

string

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

מערכת DV360 תומכת בשני רמות של טירגוט לתיקיות משנה, לדוגמה www.example.com/one-subdirectory-level/second-level, ובחמישה רמות של טירגוט לתת-דומיינים, לדוגמה five.four.three.two.one.example.com.
negative

boolean

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

DayAndTimeAssignedTargetingOptionDetails

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

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

enum (DayOfWeek)

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

integer

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

integer

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

enum (TimeZoneResolution)

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

DayOfWeek

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

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

TimeZoneResolution

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

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

AgeRangeAssignedTargetingOptionDetails

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

ייצוג ב-JSON 
{
  "ageRange": enum (AgeRange)
}
שדות
ageRange

enum (AgeRange)

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

RegionalLocationListAssignedTargetingOptionDetails

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

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

string (int64 format)

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

boolean

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

ProximityLocationListAssignedTargetingOptionDetails

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

ייצוג JSON 
{
  "proximityLocationListId": string,
  "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) לרדיוס קירבה.

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

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

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

enum (ParentalStatus)

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

ContentInstreamPositionAssignedTargetingOptionDetails

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

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

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

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

ייצוג ב-JSON 
{
  "deviceType": enum (DeviceType),
  "youtubeAndPartnersBidMultiplier": number
}
שדות
deviceType

enum (DeviceType)

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

number

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

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

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

AudienceGroupAssignedTargetingOptionDetails

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

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

object (FirstAndThirdPartyAudienceGroup)

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

object (GoogleAudienceGroup)

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

object (CustomListGroup)

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

object (CombinedAudienceGroup)

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

object (FirstAndThirdPartyAudienceGroup)

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

object (GoogleAudienceGroup)

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

FirstAndThirdPartyAudienceGroup

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

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

object (FirstAndThirdPartyAudienceTargetingSetting)

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

FirstAndThirdPartyAudienceTargetingSetting

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

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

string (int64 format)

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

enum (Recency)

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

עדכניות

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

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

GoogleAudienceGroup

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

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

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

string

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

string

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

boolean

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

HouseholdIncomeAssignedTargetingOptionDetails

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

ייצוג ב-JSON 
{
  "householdIncome": enum (HouseholdIncome)
}
שדות
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

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

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

string

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

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

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

string (int64 format)

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

OperatingSystemAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

DeviceMakeModelAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

EnvironmentAssignedTargetingOptionDetails

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

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

enum (Environment)

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

InventorySourceAssignedTargetingOptionDetails

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

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

string (int64 format)

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

CategoryAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

ViewabilityAssignedTargetingOptionDetails

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

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

enum (Viewability)

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

AuthorizedSellerStatusAssignedTargetingOptionDetails

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

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

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

enum (AuthorizedSellerStatus)

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

string

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

LanguageAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

GeoRegionAssignedTargetingOptionDetails

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

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

string

פלט בלבד. השם המוצג של האזור הגיאוגרפי (למשל, 'Ontario, Canada').
targetingOptionId

string

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

enum (GeoRegionType)

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

boolean

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

InventorySourceGroupAssignedTargetingOptionDetails

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

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

string (int64 format)

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

DigitalContentLabelAssignedTargetingOptionDetails

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

ייצוג JSON 
{
  "excludedContentRatingTier": enum (ContentRatingTier)
}
שדות
excludedContentRatingTier

enum (ContentRatingTier)

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

SensitiveCategoryAssignedTargetingOptionDetails

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

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

enum (SensitiveCategory)

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

ExchangeAssignedTargetingOptionDetails

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

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

enum (Exchange)

חובה. ערך המאפיין enum של הבורסה.

SubExchangeAssignedTargetingOptionDetails

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

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

string

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

ThirdPartyVerifierAssignedTargetingOptionDetails

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

ייצוג JSON 
{

  // Union field verifier can be only one of the following:
  "adloox": {
    object (Adloox)
  },
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  }
  // End of list of possible types for union field verifier.
}
שדות
שדה האיחוד verifier. אפשר לטרגט לאחד מהמאמתים של הצד השלישי כדי לאכוף ערכי סף של בטיחות המותג לחשיפות. הערך של verifier יכול להיות רק אחת מהאפשרויות הבאות:
adloox

object (Adloox)

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

object (DoubleVerify)

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

object (IntegralAdScience)

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

Adloox

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

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

enum (AdlooxCategory)

הגדרות בטיחות המותג של Adloox.

AdlooxCategory

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

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

DoubleVerify

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

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

object (BrandSafetyCategories)

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

enum (AgeRating)

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

object (AppStarRating)

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

object (DisplayViewability)

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

object (VideoViewability)

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

object (FraudInvalidTraffic)

הימנעו משימוש באתרים ובאפליקציות עם שיעור גבוה של תרמיות ו-IVT בהיסטוריה.
customSegmentId

string (int64 format)

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

BrandSafetyCategories

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

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

boolean

לא מוכר או לא ניתן לדירוג.
avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

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

enum (MediumSeverityCategory)

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

HighSeverityCategory

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

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

MediumSeverityCategory

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

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

AgeRating

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

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

AppStarRating

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

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

enum (StarRating)

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

boolean

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

StarRating

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

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

DisplayViewability

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

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

enum (IAB)

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

enum (ViewableDuring)

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

IAB

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

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

ViewableDuring

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

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

VideoViewability

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

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

enum (VideoIAB)

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

enum (VideoViewableRate)

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

enum (PlayerImpressionRate)

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

VideoIAB

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

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

VideoViewableRate

האפשרויות האפשריות של שיעור החשיפות שניתנות לצפייה במלואן.

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

PlayerImpressionRate

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

טיפוסים בני מנייה (enum)
PLAYER_SIZE_400X300_UNSPECIFIED המאפיין הזה הוא רק 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

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

FraudOption

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

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

IntegralAdScience

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

ייצוג ב-JSON 
{
  "traqScoreOption": enum (TRAQScore),
  "excludeUnrateable": boolean,
  "excludedAdultRisk": enum (Adult),
  "excludedAlcoholRisk": enum (Alcohol),
  "excludedIllegalDownloadsRisk": enum (IllegalDownloads),
  "excludedDrugsRisk": enum (Drugs),
  "excludedHateSpeechRisk": enum (HateSpeech),
  "excludedOffensiveLanguageRisk": enum (OffensiveLanguage),
  "excludedViolenceRisk": enum (Violence),
  "excludedGamblingRisk": enum (Gambling),
  "excludedAdFraudRisk": enum (AdFraudPrevention),
  "displayViewability": enum (DisplayViewability),
  "videoViewability": enum (VideoViewability),
  "customSegmentId": [
    string
  ]
}
שדות
traqScoreOption

enum (TRAQScore)

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

boolean

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

enum (Adult)

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

enum (Alcohol)

הגנה על המותג – אלכוהול.
excludedIllegalDownloadsRisk

enum (IllegalDownloads)

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

enum (Drugs)

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

enum (HateSpeech)

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

enum (OffensiveLanguage)

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

enum (Violence)

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

enum (Gambling)

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

enum (AdFraudPrevention)

הגדרות לזיוף קליקים על מודעות.
displayViewability

enum (DisplayViewability)

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

enum (VideoViewability)

הקטע 'ניראות של סרטון' (רלוונטי לפריטי וידאו בלבד).
customSegmentId[]

string (int64 format)

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

TRAQScore

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

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

אדם מבוגר

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

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

אלכוהול

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

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

IllegalDownloads

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

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

סמים

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

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

HateSpeech

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

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

OffensiveLanguage

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

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

אלימות

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

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

הימורים

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

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

AdFraudPrevention

אפשרויות אפשריות למניעת זיוף מודעות של Integral Ad Science.

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

DisplayViewability

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

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

VideoViewability

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

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

PoiAssignedTargetingOptionDetails

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

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

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

טיפוסים בני מנייה (enum)
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. השדה הזה יאוכלס בשדה הפרטים ב-AssignTargetOption כשהערך של targetingType הוא TARGETING_TYPE_OMID.

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

enum (Omid)

חובה. סוג מלאי שטחי הפרסום שתומך ב-Open Measurement.

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

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

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

שיטות

get

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

list

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