REST Resource: advertisers.adGroups.targetingTypes.assignedTargetingOptions

משאב: AssignedTargetingOption

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

ייצוג ב-JSON 
{
  "name": string,
  "assignedTargetingOptionId": string,
  "assignedTargetingOptionIdAlias": string,
  "targetingType": enum (TargetingType),
  "inheritance": enum (Inheritance),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "channelDetails": {
    object (ChannelAssignedTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryAssignedTargetingOptionDetails)
  },
  "appDetails": {
    object (AppAssignedTargetingOptionDetails)
  },
  "urlDetails": {
    object (UrlAssignedTargetingOptionDetails)
  },
  "dayAndTimeDetails": {
    object (DayAndTimeAssignedTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeAssignedTargetingOptionDetails)
  },
  "regionalLocationListDetails": {
    object (RegionalLocationListAssignedTargetingOptionDetails)
  },
  "proximityLocationListDetails": {
    object (ProximityLocationListAssignedTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderAssignedTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeAssignedTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentAssignedTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusAssignedTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionAssignedTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionAssignedTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeAssignedTargetingOptionDetails)
  },
  "audienceGroupDetails": {
    object (AudienceGroupAssignedTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserAssignedTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeAssignedTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionAssignedTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspAssignedTargetingOptionDetails)
  },
  "keywordDetails": {
    object (KeywordAssignedTargetingOptionDetails)
  },
  "negativeKeywordListDetails": {
    object (NegativeKeywordListAssignedTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemAssignedTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelAssignedTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentAssignedTargetingOptionDetails)
  },
  "inventorySourceDetails": {
    object (InventorySourceAssignedTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryAssignedTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityAssignedTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusAssignedTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageAssignedTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionAssignedTargetingOptionDetails)
  },
  "inventorySourceGroupDetails": {
    object (InventorySourceGroupAssignedTargetingOptionDetails)
  },
  "digitalContentLabelExclusionDetails": {
    object (DigitalContentLabelAssignedTargetingOptionDetails)
  },
  "sensitiveCategoryExclusionDetails": {
    object (SensitiveCategoryAssignedTargetingOptionDetails)
  },
  "contentThemeExclusionDetails": {
    object (ContentThemeAssignedTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeAssignedTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeAssignedTargetingOptionDetails)
  },
  "thirdPartyVerifierDetails": {
    object (ThirdPartyVerifierAssignedTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiAssignedTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainAssignedTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationAssignedTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeAssignedTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionAssignedTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidAssignedTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeAssignedTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreAssignedTargetingOptionDetails)
  },
  "youtubeVideoDetails": {
    object (YoutubeVideoAssignedTargetingOptionDetails)
  },
  "youtubeChannelDetails": {
    object (YoutubeChannelAssignedTargetingOptionDetails)
  },
  "sessionPositionDetails": {
    object (SessionPositionAssignedTargetingOptionDetails)
  },
  "youtubeChannelPackDetails": {
    object (YoutubeChannelPackAssignedTargetingOptionDetails)
  }
  // End of mutually exclusive fields.
}
שדות
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)

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

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

object (DeviceTypeAssignedTargetingOptionDetails)

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

object (AudienceGroupAssignedTargetingOptionDetails)

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

object (BrowserAssignedTargetingOptionDetails)

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

object (HouseholdIncomeAssignedTargetingOptionDetails)

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

object (OnScreenPositionAssignedTargetingOptionDetails)

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

object (CarrierAndIspAssignedTargetingOptionDetails)

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

object (YoutubeChannelPackAssignedTargetingOptionDetails)

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

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.
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 $והמכפיל הוא 1.5 לטאבלט, מחיר הצעת המחיר לטאבלט יהיה 15$.

האפשרות הזו רלוונטית רק לפריטים של 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

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

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

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

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

object (FirstPartyAndPartnerAudienceTargetingSetting)

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

FirstPartyAndPartnerAudienceTargetingSetting

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

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

string (int64 format)

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

enum (Recency)

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

עדכניות

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

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

BrowserAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

HouseholdIncomeAssignedTargetingOptionDetails

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

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

enum (HouseholdIncome)

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

OnScreenPositionAssignedTargetingOptionDetails

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

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

string

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

enum (OnScreenPosition)

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

enum (AdType)

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

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

CarrierAndIspAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

KeywordAssignedTargetingOptionDetails

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

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

string

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

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

boolean

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

string

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

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

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

NegativeKeywordListAssignedTargetingOptionDetails

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

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

string (int64 format)

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

OperatingSystemAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

DeviceMakeModelAssignedTargetingOptionDetails

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

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

בשדה הזה אפשר להזין רק את הערך CONTENT_RATING_TIER_UNRATED.

SensitiveCategoryAssignedTargetingOptionDetails

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

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

enum (SensitiveCategory)

חובה. סוג enum לקטגוריה רגישה ב-Display & Video 360 שסווגה כתוכן שצריך להחריג.

בשדה הזה אפשר להזין רק את הערכים הבאים:

  • SENSITIVE_CATEGORY_EMBEDDED_VIDEO
  • SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO

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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "adloox": {
    object (Adloox)
  },
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  }
  // End of mutually exclusive fields.
}
שדות
אפשר לטרגט אחד מהמאמתים של צד שלישי כדי לאכוף ספי הגנה על המותג לחשיפות. הרשימה הבאה כוללת שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות:
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)

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

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

IAB

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

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

ViewableDuring

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

טיפוסים בני מנייה (enum)
AVERAGE_VIEW_DURATION_UNSPECIFIED ה-enum הזה הוא רק פלייסהולדר ולא מציין אפשרויות של משך צפייה ממוצע.
AVERAGE_VIEW_DURATION_5_SEC טירגוט מלאי שטחי פרסום באתרים ובאפליקציות כדי למקסם את משך הצפייה שניתן למדידה (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 טרגטו שטחי פרסום באתרים ובאפליקציות כדי למקסם את שיעור הניראות לפי IAB ל-75% ומעלה.
IAB_VIEWABILITY_70_PERCENT_HIGHER טרגטו שטחי פרסום באתרים ובאפליקציות כדי להשיג שיעור ניראות של 70% ומעלה לפי הגדרת IAB.
IAB_VIEWABILITY_65_PERCENT_HIHGER טרגטו שטחי פרסום באתרים ובאפליקציות כדי למקסם את שיעור הניראות לפי IAB ל-65% ומעלה.
IAB_VIEWABILITY_60_PERCENT_HIGHER טרגטו שטחי פרסום באתרים ובאפליקציות כדי למקסם את שיעור הניראות לפי IAB ל-60% ומעלה.
IAB_VIEWABILITY_55_PERCENT_HIHGER טרגטו שטחי פרסום באתרים ובאפליקציות כדי למקסם את שיעור הניראות לפי IAB ל-55% ומעלה.
IAB_VIEWABILITY_50_PERCENT_HIGHER טרגטו שטחי פרסום באתרים ובאפליקציות כדי למקסם את שיעור הניראות לפי IAB ל-50% ומעלה.
IAB_VIEWABILITY_40_PERCENT_HIHGER כדאי לטרגט מלאי שטחי פרסום באתרים ובאפליקציות כדי להשיג שיעור ניראות של 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)

מומלץ להימנע מאתרים ומאפליקציות עם היסטוריה של תרמיות ותנועת גולשים פסולה (IVT).
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-1,000.
TRAQ_500 ציון TRAQ‏ 500-1000.
TRAQ_600 ציון TRAQ‏ 600-1000.
TRAQ_700 ציון TRAQ‏ 700-1000.
TRAQ_750 ציון TRAQ‏ 750-1000.
TRAQ_875 ציון TRAQ‏ 875-1000.
TRAQ_1000 ציון TRAQ‏ 1,000.

אדם מבוגר

אפשרויות לתוכן למבוגרים ב-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 - Exclude High Risk.
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 Gambling.

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

YoutubeChannelPackAssignedTargetingOptionDetails

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

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

string (int64 format)

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

boolean

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

ירושה

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

טיפוסים בני מנייה (enum)
INHERITANCE_UNSPECIFIED הירושה לא צוינה או לא ידועה.
NOT_INHERITED אפשרות הטירגוט שהוקצתה לא מועברת בירושה מישות ברמה גבוהה יותר.
INHERITED_FROM_PARTNER אפשרות הטירגוט שהוקצתה מתקבלת בירושה מהגדרות הטירגוט של השותף.
INHERITED_FROM_ADVERTISER אפשרות הטירגוט שמוקצית לכם עוברת בירושה מהגדרות הטירגוט של המפרסם.

Methods

create

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

delete

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

get

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

list

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