REST Resource: advertisers.adGroups.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)
  },
  "contentThemeExclusionDetails": {
    object (ContentThemeAssignedTargetingOptionDetails)
  },
  "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)
  },
  "youtubeChannelPackDetails": {
    object (YoutubeChannelPackAssignedTargetingOptionDetails)
  }
  // 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)

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

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

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

object (ContentThemeAssignedTargetingOptionDetails)

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

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

object (ExchangeAssignedTargetingOptionDetails)

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

object (SubExchangeAssignedTargetingOptionDetails)

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

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

object (YoutubeChannelPackAssignedTargetingOptionDetails)

פרטים על חבילת ערוצי YouTube. השדה הזה יאוכלס כשהערך של targetingType יהיה TARGETING_TYPE_YOUTUBE_CHANNEL_PACK.

ירושה

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

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

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

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

string

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

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

string

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

boolean

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

enum (AppPlatform)

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

AppPlatform

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

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

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)

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

בפריטים מקמפיינים ליצירת ביקוש, השדה הזה תמיד TIME_ZONE_RESOLUTION_ADVERTISER.

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

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

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

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

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

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

enum (ParentalStatus)

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

ContentInstreamPositionAssignedTargetingOptionDetails

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

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

enum (ContentInstreamPosition)

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

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

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

האפשרות הזו רלוונטית רק לפריטים של YouTube ושותפים.

AudienceGroupAssignedTargetingOptionDetails

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

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

object (GoogleAudienceGroup)

אופציונלי. מזהי הקהלים של Google שכלולים בקבוצת הקהלים של Google. מכיל רק מזהי קהלים של Google.
includedCustomListGroup

object (CustomListGroup)

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

object (CombinedAudienceGroup)

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

object (GoogleAudienceGroup)

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

object (FirstPartyAndPartnerAudienceGroup)

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

object (FirstPartyAndPartnerAudienceGroup)

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

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

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

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

object (CombinedAudienceTargetingSetting)

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

CombinedAudienceTargetingSetting

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

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

string (int64 format)

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

FirstPartyAndPartnerAudienceGroup

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

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

object (FirstPartyAndPartnerAudienceTargetingSetting)

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

FirstPartyAndPartnerAudienceTargetingSetting

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

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

string (int64 format)

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

enum (Recency)

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

עדכניות

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

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

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

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

string

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

boolean

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

KeywordAssignedTargetingOptionDetails

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

ייצוג ב-JSON 
{
  "keyword": string,
  "negative": boolean,
  "exemptedPolicyNames": [
    string
  ]
}
שדות
keyword

string

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

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

boolean

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

string

אופציונלי. שמות המדיניות שממנה רוצים להחריג את מילת המפתח.

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

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

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 הוא TARGETING_TYPE_DEVICE_MAKE_MODEL.targetingType

ייצוג ב-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 הוא TARGETING_TYPE_CATEGORY.targetingType

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

פלט בלבד. השם המוצג של האזור הגיאוגרפי (למשל, Ontario, Canada).
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 שסווגה כמוחרגת.

ContentThemeAssignedTargetingOptionDetails

פרטי הטירגוט של נושא התוכן. השדה הזה יאוכלס בשדה הפרטים של AssignedTargetingOption כש-targetingType הוא TARGETING_TYPE_CONTENT_THEME_EXCLUSION.

ייצוג ב-JSON 
{
  "excludedTargetingOptionId": string,
  "contentTheme": enum (ContentTheme),
  "excludedContentTheme": enum (ContentTheme)
}
שדות
excludedTargetingOptionId

string

חובה. המזהה של נושא התוכן שרוצים להחריג.
contentTheme

enum (ContentTheme)

פלט בלבד. סוג enum של מסווג נושאי התוכן ב-DV360.
excludedContentTheme

enum (ContentTheme)

חובה. סוג enum לנושא התוכן ב-DV360 שסווג כתוכן שהוחרג.

ExchangeAssignedTargetingOptionDetails

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

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

enum (Exchange)

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

SubExchangeAssignedTargetingOptionDetails

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

ספק שירותי אימות מותג חיצוני – Scope3 (לשעבר Adloox).
doubleVerify

object (DoubleVerify)

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

object (IntegralAdScience)

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

Adloox

פרטים על הגדרות בטיחות המותג של Scope3 (לשעבר Adloox).

ייצוג ב-JSON 
{
  "excludedAdlooxCategories": [
    enum (AdlooxCategory)
  ],
  "excludedFraudIvtMfaCategories": [
    enum (FraudIvtMfaCategory)
  ],
  "adultExplicitSexualContent": enum (GarmRiskExclusion),
  "crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent": enum (GarmRiskExclusion),
  "armsAmmunitionContent": enum (GarmRiskExclusion),
  "deathInjuryMilitaryConflictContent": enum (GarmRiskExclusion),
  "debatedSensitiveSocialIssueContent": enum (GarmRiskExclusion),
  "illegalDrugsTobaccoEcigarettesVapingAlcoholContent": enum (GarmRiskExclusion),
  "onlinePiracyContent": enum (GarmRiskExclusion),
  "hateSpeechActsAggressionContent": enum (GarmRiskExclusion),
  "obscenityProfanityContent": enum (GarmRiskExclusion),
  "spamHarmfulContent": enum (GarmRiskExclusion),
  "terrorismContent": enum (GarmRiskExclusion),
  "misinformationContent": enum (GarmRiskExclusion),
  "displayIabViewability": enum (DisplayIabViewability),
  "videoIabViewability": enum (VideoIabViewability)
}
שדות
excludedAdlooxCategories[]

enum (AdlooxCategory)

קטגוריות Scope3 להחרגה.
excludedFraudIvtMfaCategories[]

enum (FraudIvtMfaCategory)

אופציונלי. קטגוריות של Scope3 בנושא הונאה, תנועה לא חוקית (IVT) ו-MFA להחרגה.
adultExplicitSexualContent

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

אופציונלי. טווח הסיכון של GARM להחרגה של תוכן שקשור לפשע ולפעולות מזיקות.
armsAmmunitionContent

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

אופציונלי. טווח הסיכון של GARM להחרגה של תוכן שקשור לסמים לא חוקיים או לאלכוהול.
onlinePiracyContent

enum (GarmRiskExclusion)

אופציונלי. טווח הסיכון של תוכן שקשור לפיראטיות אונליין של GARM להחרגה.
hateSpeechActsAggressionContent

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

אופציונלי. טווח הסיכון של תוכן גס ושפה גסה GARM שצריך להחריג.
spamHarmfulContent

enum (GarmRiskExclusion)

אופציונלי. טווחים של סיכון להחרגה לפי GARM: ספאם או תוכן פוגעני.
terrorismContent

enum (GarmRiskExclusion)

אופציונלי. טווח הסיכון של תוכן שקשור לפעילות טרור GARM להחרגה.
misinformationContent

enum (GarmRiskExclusion)

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

enum (DisplayIabViewability)

אופציונלי. סף הניראות של IAB למודעות לרשת המדיה.
videoIabViewability

enum (VideoIabViewability)

אופציונלי. סף הניראות של IAB למודעות וידאו.

AdlooxCategory

קטגוריות זמינות של Scope3 (לשעבר Adloox).

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

FraudIvtMfaCategory

קטגוריות הזמינות של הונאה, תנועת גולשים לא חוקית (IVT) ושיטות להונאת מפרסמים (MFA) של Scope3 (לשעבר Adloox).

טיפוסים בני מנייה (enum)
FRAUD_IVT_MFA_CATEGORY_UNSPECIFIED ערך ברירת המחדל כשלא מצוינת קטגוריה של הונאה, תנועה לא חוקית או מודעות שמוצגות עם אימות רב-שלבי של Scope3, או כשהקטגוריה לא ידועה בגרסה הזו.
FRAUD_IVT_MFA הונאה, תנועה פסולה (IVT), אימות רב-שלבי (MFA).

GarmRiskExclusion

אפשרויות ההחרגה הזמינות של רמת הסיכון GARM.

טיפוסים בני מנייה (enum)
GARM_RISK_EXCLUSION_UNSPECIFIED ה-enum הזה הוא רק פלייסהולדר ולא מציין אפשרות להחרגת סיכון של GARM.
GARM_RISK_EXCLUSION_FLOOR לא כולל סיכון ברמת הקומה.
GARM_RISK_EXCLUSION_HIGH לא כוללים סיכון גבוה וסיכון מינימלי.
GARM_RISK_EXCLUSION_MEDIUM לא לכלול סיכון בינוני, גבוה ומינימלי.
GARM_RISK_EXCLUSION_LOW החרגה של כל רמות הסיכון (נמוכה, בינונית, גבוהה ורצפה).

DisplayIabViewability

הספים הזמינים של ניראות מודעות לרשת המדיה של IAB‏ (EEA) ב-Scope3 (לשעבר Adloox).

טיפוסים בני מנייה (enum)
DISPLAY_IAB_VIEWABILITY_UNSPECIFIED ערך ברירת המחדל אם לא מציינים אותו או אם הוא לא ידוע בגרסה הזו.
DISPLAY_IAB_VIEWABILITY_10 ‫10%ומעלה של המודעה מוצגים (תקן הניראות של IAB לרשת המדיה).
DISPLAY_IAB_VIEWABILITY_20 לפחות 20%מהמודעה מוצגים (רף הניראות של IAB למודעות לרשת המדיה).
DISPLAY_IAB_VIEWABILITY_35 35%ומעלה מהמודעה מוצגים (רף הניראות של IAB למודעות לרשת המדיה).
DISPLAY_IAB_VIEWABILITY_50 50%ומעלה מהמודעה מוצגים (תקן הניראות של IAB למודעות לרשת המדיה).
DISPLAY_IAB_VIEWABILITY_75 75%ויותר מהמודעה מוצגים (רף הניראות של IAB למודעות לרשת המדיה).

VideoIabViewability

סף הניראות של מודעות וידאו של IAB שזמין ב-Scope3 (לשעבר Adloox).

טיפוסים בני מנייה (enum)
VIDEO_IAB_VIEWABILITY_UNSPECIFIED ערך ברירת המחדל אם לא מציינים אותו או אם הוא לא ידוע בגרסה הזו.
VIDEO_IAB_VIEWABILITY_10 ‫10%ומעלה מהסרטון מוצג (תקן הניראות של סרטונים של IAB).
VIDEO_IAB_VIEWABILITY_20 20%ומעלה מהמודעה מוצגים (תקן הניראות של מודעות וידאו של IAB).
VIDEO_IAB_VIEWABILITY_35 ‫35%ומעלה מהמודעה מוצגים (תקן הניראות של מודעות וידאו של IAB).
VIDEO_IAB_VIEWABILITY_50 50%מהמודעה מוצגים (תקן הניראות של מודעות וידאו של IAB).
VIDEO_IAB_VIEWABILITY_75 ‫75%ומעלה מהסרטון מוצגים (התקן של IAB לניראות של סרטונים).

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 הזה הוא רק פלייסהולדר ולא מציין קטגוריות ברמת חומרה גבוהה.
ADULT_CONTENT_PORNOGRAPHY תוכן למבוגרים בלבד: פורנוגרפיה, נושאים למבוגרים בלבד ועירום.
COPYRIGHT_INFRINGEMENT הפרת זכויות יוצרים.
SUBSTANCE_ABUSE סמים/אלכוהול/חומרים מבוקרים: שימוש מזיק בסמים או אלכוהול.
GRAPHIC_VIOLENCE_WEAPONS אלימות קיצונית גרפית/בוטה/שימוש בנשק.
HATE_PROFANITY דברי שטנה/שפה גסה.
CRIMINAL_SKILLS פעילויות לא חוקיות: מיומנויות פליליות.
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER תמריצים/תוכנות זדוניות/עומס.

MediumSeverityCategory

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

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

AgeRating

אפשרויות אפשריות לסיווגי תוכן.

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

AppStarRating

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

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

enum (StarRating)

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

boolean

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

StarRating

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

טיפוסים בני מנייה (enum)
APP_STAR_RATE_UNSPECIFIED ה-enum הזה הוא רק פלייסהולדר ולא מציין אפשרויות של דירוג כוכבים לאפליקציה.
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 הזה הוא רק פלייסהולדר ולא מציין אפשרויות של שיעור הצפייה לפי IAB.
IAB_VIEWED_RATE_80_PERCENT_HIGHER כדאי לטרגט מלאי שטחי פרסום באתרים ובאפליקציות כדי להשיג שיעור ניראות של 80% ומעלה לפי הגדרת ה-IAB.
IAB_VIEWED_RATE_75_PERCENT_HIGHER כדאי לטרגט מלאי שטחי פרסום באתרים ובאפליקציות כדי להשיג שיעור ניראות של 75% ומעלה לפי הגדרת IAB.
IAB_VIEWED_RATE_70_PERCENT_HIGHER טרגטו מלאי שטחי פרסום באתרים ובאפליקציות כדי להשיג שיעור ניראות של 70% ומעלה לפי הגדרת IAB.
IAB_VIEWED_RATE_65_PERCENT_HIGHER טרגטו מלאי שטחי פרסום באתרים ובאפליקציות כדי להשיג שיעור ניראות של 65% ומעלה לפי הגדרת IAB.
IAB_VIEWED_RATE_60_PERCENT_HIGHER טרגטו מלאי שטחי פרסום באתרים ובאפליקציות כדי להשיג שיעור ניראות של 60% ומעלה לפי הגדרת IAB.
IAB_VIEWED_RATE_55_PERCENT_HIGHER כדאי לטרגט מלאי שטחי פרסום באתרים ובאפליקציות כדי למקסם את שיעור הניראות לפי IAB ל-55% ומעלה.
IAB_VIEWED_RATE_50_PERCENT_HIGHER טרגטו מלאי שטחי פרסום באתרים ובאפליקציות כדי למקסם את שיעור הניראות לפי IAB בשיעור של 50% ומעלה.
IAB_VIEWED_RATE_40_PERCENT_HIGHER כדאי לטרגט מלאי שטחי פרסום באתרים ובאפליקציות כדי להשיג שיעור ניראות של 40% ומעלה לפי הגדרת IAB.
IAB_VIEWED_RATE_30_PERCENT_HIGHER טרגטו מלאי שטחי פרסום באתרים ובאפליקציות כדי להשיג שיעור ניראות של 30% ומעלה לפי הגדרת IAB.

ViewableDuring

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

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

VideoViewability

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

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

enum (VideoIAB)

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

enum (VideoViewableRate)

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

enum (PlayerImpressionRate)

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

VideoIAB

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

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

VideoViewableRate

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

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

PlayerImpressionRate

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

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

FraudInvalidTraffic

הגדרות של DoubleVerify בנושא הונאה ותנועה פסולה (IVT).

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

enum (FraudOption)

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

boolean

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

FraudOption

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

טיפוסים בני מנייה (enum)
FRAUD_UNSPECIFIED ה-enum הזה הוא רק פלייסהולדר ולא מציין אפשרויות של תרמיות ותנועה פסולה.
AD_IMPRESSION_FRAUD_100 ‫100% הונאות ו-IVT.
AD_IMPRESSION_FRAUD_50 הונאה ותנועה לא חוקית (IVT) בשיעור של 50% ומעלה.
AD_IMPRESSION_FRAUD_25 הונאה ותנועת גולשים פסולה בשיעור של 25% ומעלה.
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
  ],
  "qualitySyncCustomSegmentId": [
    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 או בין 3000001 ל-3999999, כולל.
qualitySyncCustomSegmentId[]

string (int64 format)

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

TRAQScore

טווחים אפשריים של ציון TRAQ ‏ (true advertising quality, איכות הפרסום בפועל) של Integral Ad Science.

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

אדם מבוגר

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

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

אלכוהול

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

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

IllegalDownloads

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

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

סמים

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

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

HateSpeech

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

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

OffensiveLanguage

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

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

אלימות

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

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

הימורים

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

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

AdFraudPrevention

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

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

DisplayViewability

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

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

VideoViewability

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

טיפוסים בני מנייה (enum)
VIDEO_VIEWABILITY_UNSPECIFIED ה-enum הזה הוא רק פלייסהולדר ולא מציין אפשרויות של נראות סרטונים.
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', 'בנק צ'ייס'.
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

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

ייצוג ב-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 החשיפה הראשונה בסשן.

YoutubeChannelPackAssignedTargetingOptionDetails

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

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

string (int64 format)

חובה. המזהה של חבילת הערוצים ב-YouTube.
negative

boolean

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

Methods

create

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

delete

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

get

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

list

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