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)
  }
  // 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)

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

חובה. מזהה הערוץ. צריך להתייחס לשדה של מזהה הערוץ במשאב Partner-owned channel או advertiser-owned channel.
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.

UrlAssignedTargetingOptionDetails

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

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

string

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

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

boolean

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

DayAndTimeAssignedTargetingOptionDetails

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

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

enum (DayOfWeek)

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

integer

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

integer

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

enum (TimeZoneResolution)

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

DayOfWeek

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

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

יחידות מרחק מסוג enum ל-ProximityRadius.

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

GenderAssignedTargetingOptionDetails

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

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

enum (Gender)

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

VideoPlayerSizeAssignedTargetingOptionDetails

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

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

enum (VideoPlayerSize)

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

UserRewardedContentAssignedTargetingOptionDetails

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

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

string

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

enum (UserRewardedContent)

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

ParentalStatusAssignedTargetingOptionDetails

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

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

enum (ParentalStatus)

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

ContentInstreamPositionAssignedTargetingOptionDetails

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

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

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

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

enum (ContentOutstreamPosition)

חובה. המיקום של מודעת הווידאו Outstream.
adType

enum (AdType)

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

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

DeviceTypeAssignedTargetingOptionDetails

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

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

enum (DeviceType)

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

number

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

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

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

AudienceGroupAssignedTargetingOptionDetails

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

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

object (FirstAndThirdPartyAudienceGroup)

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

object (GoogleAudienceGroup)

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

object (CustomListGroup)

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

object (CombinedAudienceGroup)

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

object (FirstAndThirdPartyAudienceGroup)

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

object (GoogleAudienceGroup)

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

FirstAndThirdPartyAudienceGroup

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

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

object (FirstAndThirdPartyAudienceTargetingSetting)

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

FirstAndThirdPartyAudienceTargetingSetting

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

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

string (int64 format)

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

enum (Recency)

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

עדכניות

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

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

GoogleAudienceGroup

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

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

object (GoogleAudienceTargetingSetting)

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

GoogleAudienceTargetingSetting

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

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

string (int64 format)

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

CustomListGroup

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

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

object (CustomListTargetingSetting)

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

CustomListTargetingSetting

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

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

string (int64 format)

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

CombinedAudienceGroup

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

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

object (CombinedAudienceTargetingSetting)

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

CombinedAudienceTargetingSetting

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

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

string (int64 format)

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

BrowserAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

HouseholdIncomeAssignedTargetingOptionDetails

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

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

enum (HouseholdIncome)

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

OnScreenPositionAssignedTargetingOptionDetails

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

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

string

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

enum (OnScreenPosition)

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

enum (AdType)

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

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

CarrierAndIspAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

KeywordAssignedTargetingOptionDetails

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

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

string

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

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

boolean

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

NegativeKeywordListAssignedTargetingOptionDetails

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

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

string (int64 format)

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

OperatingSystemAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

DeviceMakeModelAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

EnvironmentAssignedTargetingOptionDetails

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

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

enum (Environment)

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

InventorySourceAssignedTargetingOptionDetails

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

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

string (int64 format)

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

CategoryAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

ViewabilityAssignedTargetingOptionDetails

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

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

enum (Viewability)

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

AuthorizedSellerStatusAssignedTargetingOptionDetails

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

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

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

enum (AuthorizedSellerStatus)

פלט בלבד. סטטוס המפיץ המורשה לטירגוט.
targetingOptionId

string

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

LanguageAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

GeoRegionAssignedTargetingOptionDetails

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

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

string

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

string

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

enum (GeoRegionType)

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

boolean

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

InventorySourceGroupAssignedTargetingOptionDetails

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

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

string (int64 format)

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

DigitalContentLabelAssignedTargetingOptionDetails

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

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

enum (ContentRatingTier)

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

SensitiveCategoryAssignedTargetingOptionDetails

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

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

enum (SensitiveCategory)

חובה. ‫Enum לקטגוריית התוכן הרגיש ב-DV360 שסווגה כתוכן שצריך להחריג.

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 שהיא הונאה.
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)

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

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

טיפוסים בני מנייה (enum)
FRAUD_UNSPECIFIED ה-enum הזה הוא רק פלייסהולדר ולא מציין אפשרויות של תרמיות ותנועה פסולה.
AD_IMPRESSION_FRAUD_100 ‫100% תרמיות ותנועה לא חוקית.
AD_IMPRESSION_FRAUD_50 50% או יותר של הונאה ותנועה לא חוקית.
AD_IMPRESSION_FRAUD_25 ‫25% או יותר הונאה ותנועת גולשים לא חוקית.
AD_IMPRESSION_FRAUD_10 הונאה ותנועה לא חוקית בשיעור של 10% ומעלה.
AD_IMPRESSION_FRAUD_8 שיעור ההונאה וה-IVT הוא 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-1000.
TRAQ_500 ציון TRAQ‏ 500-1000.
TRAQ_600 ציון TRAQ‏ 600-1,000.
TRAQ_700 ציון TRAQ‏ 700-1000.
TRAQ_750 ציון TRAQ‏ 750-1000.
TRAQ_875 ציון TRAQ‏ 875-1000.
TRAQ_1000 ציון TRAQ‏ 1000.

אדם מבוגר

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

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

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',‏ '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

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

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

enum (Omid)

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

AudioContentTypeAssignedTargetingOptionDetails

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

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

enum (AudioContentType)

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

ContentGenreAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

YoutubeVideoAssignedTargetingOptionDetails

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

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

string

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

boolean

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

YoutubeChannelAssignedTargetingOptionDetails

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

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

string

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

boolean

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

SessionPositionAssignedTargetingOptionDetails

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

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

enum (SessionPosition)

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

SessionPosition

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

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

Methods

get

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

list

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