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)
  },
  "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)

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

object (KeywordAssignedTargetingOptionDetails)

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

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

object (NegativeKeywordListAssignedTargetingOptionDetails)

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

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

object (OperatingSystemAssignedTargetingOptionDetails)

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

object (DeviceMakeModelAssignedTargetingOptionDetails)

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

object (EnvironmentAssignedTargetingOptionDetails)

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

object (InventorySourceAssignedTargetingOptionDetails)

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

object (CategoryAssignedTargetingOptionDetails)

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

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

object (ViewabilityAssignedTargetingOptionDetails)

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

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

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

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

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

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

object (LanguageAssignedTargetingOptionDetails)

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

object (GeoRegionAssignedTargetingOptionDetails)

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

object (InventorySourceGroupAssignedTargetingOptionDetails)

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

object (DigitalContentLabelAssignedTargetingOptionDetails)

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

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

object (SensitiveCategoryAssignedTargetingOptionDetails)

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

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

object (ExchangeAssignedTargetingOptionDetails)

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

object (SubExchangeAssignedTargetingOptionDetails)

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

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

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

object (PoiAssignedTargetingOptionDetails)

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

object (BusinessChainAssignedTargetingOptionDetails)

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

object (ContentDurationAssignedTargetingOptionDetails)

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

object (ContentStreamTypeAssignedTargetingOptionDetails)

פרטי משך התוכן. השדה הזה יאוכלס כשהערך של 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 של Apple כולל מחרוזת של 9 ספרות, לדוגמה 422689480.
displayName

string

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

boolean

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

enum (AppPlatform)

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

AppPlatform

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

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

UrlAssignedTargetingOptionDetails

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

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

string

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

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

boolean

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

DayAndTimeAssignedTargetingOptionDetails

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

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

enum (DayOfWeek)

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

integer

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

integer

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

enum (TimeZoneResolution)

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

DayOfWeek

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

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

TimeZoneResolution

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

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

AgeRangeAssignedTargetingOptionDetails

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

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

enum (AgeRange)

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

RegionalLocationListAssignedTargetingOptionDetails

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

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

string (int64 format)

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

boolean

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

ProximityLocationListAssignedTargetingOptionDetails

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

ייצוג ב-JSON 
{
  "proximityLocationListId": string,
  "proximityRadius": number,
  "proximityRadiusUnit": enum (ProximityRadiusUnit)
}
שדות
proximityLocationListId

string (int64 format)

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

number

חובה. רדיוס שמבוטא ביחידות המרחק שהוגדרו ב-proximityRadiusUnit. הנתון הזה מייצג את גודל האזור סביב המיקום שנבחר שאליו יתבצע הטירגוט. הרדיוס צריך להיות בין מייל אחד ל-500 מיילים או בין 800 ק"מ ל-800 ק"מ.
proximityRadiusUnit

enum (ProximityRadiusUnit)

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

ProximityRadiusUnit

טיפוס enum של יחידות מרחק עבור ProximityRadius.

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

GenderAssignedTargetingOptionDetails

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

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

enum (Gender)

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

VideoPlayerSizeAssignedTargetingOptionDetails

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

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

enum (VideoPlayerSize)

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

UserRewardedContentAssignedTargetingOptionDetails

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

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

string

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

enum (UserRewardedContent)

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

ParentalStatusAssignedTargetingOptionDetails

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

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

enum (ParentalStatus)

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

ContentInstreamPositionAssignedTargetingOptionDetails

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

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

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

AudienceGroupAssignedTargetingOptionDetails

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

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

object (FirstAndThirdPartyAudienceGroup)

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

object (GoogleAudienceGroup)

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

object (CustomListGroup)

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

object (CombinedAudienceGroup)

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

object (FirstAndThirdPartyAudienceGroup)

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

object (GoogleAudienceGroup)

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

FirstAndThirdPartyAudienceGroup

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

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

object (FirstAndThirdPartyAudienceTargetingSetting)

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

FirstAndThirdPartyAudienceTargetingSetting

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

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

string (int64 format)

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

enum (Recency)

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

עדכניות

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

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

GoogleAudienceGroup

פרטי קבוצת היעד ב-Google. כל ההגדרות של טירגוט לפי קהל ב-Google הן 'OR' (או) לוגיות זו בזו.

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

object (GoogleAudienceTargetingSetting)

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

GoogleAudienceTargetingSetting

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

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

string (int64 format)

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

CustomListGroup

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

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

object (CustomListTargetingSetting)

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

CustomListTargetingSetting

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

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

string (int64 format)

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

CombinedAudienceGroup

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

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

object (CombinedAudienceTargetingSetting)

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

CombinedAudienceTargetingSetting

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

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

string (int64 format)

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

BrowserAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

HouseholdIncomeAssignedTargetingOptionDetails

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

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

enum (HouseholdIncome)

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

OnScreenPositionAssignedTargetingOptionDetails

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

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

string

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

enum (OnScreenPosition)

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

enum (AdType)

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

  • AD_TYPE_DISPLAY, ההגדרה תועבר בירושה לפריט חדש כשהערך של lineItemType יהיה LINE_ITEM_TYPE_DISPLAY_DEFAULT.
  • AD_TYPE_VIDEO, ההגדרה תועבר בירושה לפריט חדש כשהערך של lineItemType יהיה LINE_ITEM_TYPE_VIDEO_DEFAULT.

CarrierAndIspAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

KeywordAssignedTargetingOptionDetails

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

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

string

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

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

boolean

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

NegativeKeywordListAssignedTargetingOptionDetails

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

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

string (int64 format)

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

OperatingSystemAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

DeviceMakeModelAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

EnvironmentAssignedTargetingOptionDetails

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

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

enum (Environment)

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

InventorySourceAssignedTargetingOptionDetails

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

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

string (int64 format)

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

CategoryAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

ViewabilityAssignedTargetingOptionDetails

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

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

enum (Viewability)

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

AuthorizedSellerStatusAssignedTargetingOptionDetails

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

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

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

enum (AuthorizedSellerStatus)

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

string

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

LanguageAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

GeoRegionAssignedTargetingOptionDetails

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

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

string

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

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

ExchangeAssignedTargetingOptionDetails

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

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

object (DoubleVerify)

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

object (IntegralAdScience)

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

Adloox

פרטים על הגדרות בטיחות המותג ב-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)

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

enum (FraudIvtMfaCategory)

זה שינוי אופציונלי. קטגוריות של Adloox לזיהוי תרמית של תגובות לא רצויות (IVT) עם אימות דו-שלבי (MFA) להחרגה.
adultExplicitSexualContent

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

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

enum (DisplayIabViewability)

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

enum (VideoIabViewability)

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

AdlooxCategory

הקטגוריות הזמינות ב-Adloox.

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

FraudIvtMfaCategory

הקטגוריות הזמינות של Adloox Fraud,‏ IVT ו-MFA.

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

GarmRiskExclusion

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

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

DisplayIabViewability

ערכי הסף הזמינים של Adloox למודעות לרשת המדיה של IAB.

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

ערכי הסף הזמינים של Adloox למודעות וידאו ב-IAB.

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

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

MediumSeverityCategory

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

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

AgeRating

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

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

AppStarRating

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

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

enum (StarRating)

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

boolean

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

StarRating

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

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

DisplayViewability

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

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

enum (IAB)

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

enum (ViewableDuring)

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

IAB

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

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

ViewableDuring

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

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

VideoViewability

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

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

enum (VideoIAB)

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

enum (VideoViewableRate)

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

enum (PlayerImpressionRate)

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

VideoIAB

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

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

VideoViewableRate

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

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

PlayerImpressionRate

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

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

FraudInvalidTraffic

ההגדרות של DoubleVerify לגבי הונאות ותנועה לא חוקית.

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

enum (FraudOption)

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

boolean

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

FraudOption

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

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

IntegralAdScience

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

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

enum (TRAQScore)

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

boolean

הגנה על המותג – לא ניתן לדירוג.
excludedAdultRisk

enum (Adult)

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

enum (Alcohol)

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

enum (IllegalDownloads)

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

enum (Drugs)

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

enum (HateSpeech)

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

enum (OffensiveLanguage)

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

enum (Violence)

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

enum (Gambling)

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

enum (AdFraudPrevention)

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

enum (DisplayViewability)

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

enum (VideoViewability)

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

string (int64 format)

מזהה הפלח בהתאמה אישית שסופק על ידי Integral Ad Science. המזהה חייב להיות בין 1000001 ל-1999999 או בין 3000001 ל-3999999, כולל.
qualitySyncCustomSegmentId[]

string (int64 format)

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

TRAQScore

טווחי הציונים האפשריים של TRAQ (איכות הפרסום בפועל) ב-Integral Ad Science.

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

אדם מבוגר

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

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

אלכוהול

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

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

IllegalDownloads

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

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

סמים

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

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

HateSpeech

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

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

OffensiveLanguage

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

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

אלימות

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

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

הימורים

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

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

AdFraudPrevention

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

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

DisplayViewability

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

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

VideoViewability

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

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

PoiAssignedTargetingOptionDetails

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

ייצוג ב-JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "latitude": number,
  "longitude": number,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
שדות
displayName

string

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

string

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

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

אם רוצים לטרגט קואורדינטות ספציפיות של קו הרוחב או קו האורך שהוסרו מכתובת או משם של נקודת עניין, אפשר ליצור את מזהה אפשרות הטירגוט הנדרש על ידי עיגול הערכים הרצויים של הקואורדינטות לספרה העשרונית השישית, הסרת הספרות העשרוניות ושרשור הערכים של המחרוזות המופרדים בנקודה-פסיק. לדוגמה, אפשר לטרגט את הצמד קו הרוחב/קו האורך 40.7414691, -74.003387 באמצעות מזהה אפשרות הטירגוט '40741469;-74003387'. במהלך היצירה, ערך השדה הזה יתעדכן כך שיתווסף לו פסיק נקודה וגם ערך גיבוב אלפאנומרי, אם צוינו רק קואורדינטות של קו רוחב/אורך .
latitude

number

פלט בלבד. קו הרוחב של נקודת העניין, מעוגל לספרה העשרונית השישית.
longitude

number

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

number

חובה. רדיוס האזור סביב נקודת העניין שאליו יתבצע הטירגוט. היחידות של הרדיוס מצוינות על ידי proximityRadiusUnit. הערך חייב להיות בין 1 ל-800 אם היחידות הן DISTANCE_UNIT_KILOMETERS, ובין 1 ל-500 אם היחידות הן DISTANCE_UNIT_MILES.
proximityRadiusUnit

enum (DistanceUnit)

חובה. יחידת המרחק שבה נמדד רדיוס הטירגוט.

DistanceUnit

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

טיפוסים בני מנייה (enum)
DISTANCE_UNIT_UNSPECIFIED ערך הטיפוס לא צוין או שהוא לא ידוע בגרסה הזו.
DISTANCE_UNIT_MILES מייל.
DISTANCE_UNIT_KILOMETERS קילומטרים.

BusinessChainAssignedTargetingOptionDetails

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

ייצוג ב-JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
שדות
displayName

string

פלט בלבד. השם המוצג של רשת עסקים, למשל 'KFC', 'בנק הפועלים'.
targetingOptionId

string

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

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

number

חובה. הרדיוס של האזור סביב רשת העסקים שאליו יתבצע הטירגוט. היחידות של הרדיוס מצוינות על ידי proximityRadiusUnit. הערך חייב להיות בין 1 ל-800 אם היחידות הן DISTANCE_UNIT_KILOMETERS, ובין 1 ל-500 אם היחידות הן DISTANCE_UNIT_MILES. הערך המינימלי של העלייה בשני המקרים הוא 0.1. אם הערכים של הקלט מפורטים מדי, הם יעוגלו לערך הקביל הקרוב ביותר. לדוגמה, הערך 15.57 יהפוך לערך 15.6.
proximityRadiusUnit

enum (DistanceUnit)

חובה. יחידת המרחק שבה נמדד רדיוס הטירגוט.

ContentDurationAssignedTargetingOptionDetails

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

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

string

חובה. השדה targetingOptionId כאשר הערך של targetingType הוא TARGETING_TYPE_CONTENT_DURATION.
contentDuration

enum (ContentDuration)

פלט בלבד. משך התוכן.

ContentStreamTypeAssignedTargetingOptionDetails

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

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

string

חובה. השדה targetingOptionId כאשר הערך של targetingType הוא TARGETING_TYPE_CONTENT_STREAM_TYPE.
contentStreamType

enum (ContentStreamType)

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

NativeContentPositionAssignedTargetingOptionDetails

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

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

enum (NativeContentPosition)

חובה. מיקום התוכן.

OmidAssignedTargetingOptionDetails

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

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

enum (Omid)

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

AudioContentTypeAssignedTargetingOptionDetails

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

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

enum (AudioContentType)

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

ContentGenreAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

YoutubeVideoAssignedTargetingOptionDetails

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

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

string

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

boolean

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

YoutubeChannelAssignedTargetingOptionDetails

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

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

string

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

boolean

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

SessionPositionAssignedTargetingOptionDetails

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

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

enum (SessionPosition)

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

SessionPosition

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

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

Methods

get

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

list

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