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)

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

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

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

FirstPartyAndPartnerAudienceGroup

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

ייצוג 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 כשהערך של 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

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

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

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

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

create

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

delete

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

get

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

list

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