REST Resource: advertisers.adGroups.targetingTypes.assignedTargetingOptions

משאב: AssignedטירגוטOption

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

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

פרטי מיקום של מודעות וידאו 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)

פרטי הספק וחברת ה-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

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

enum (ProximityRadiusUnit)

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

ProximityRadiusUnit

יחידות מרחק, טיפוסים בני מנייה (enum) לרדיוס קירבה.

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

GenderAssignedTargetingOptionDetails

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

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

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

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

enum (DeviceType)

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

number

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

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

רלוונטי רק לפריטים של YouTube ו-Partner.

AudienceGroupAssignedTargetingOptionDetails

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

ייצוג ב-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. מכיל מזהי קהלים של Google בלבד.
includedCustomListGroup

object (CustomListGroup)

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

object (CombinedAudienceGroup)

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

object (FirstAndThirdPartyAudienceGroup)

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

object (GoogleAudienceGroup)

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

FirstAndThirdPartyAudienceGroup

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

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

object (FirstAndThirdPartyAudienceTargetingSetting)

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

FirstAndThirdPartyAudienceTargetingSetting

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

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

string (int64 format)

חובה. מזהה הקהל מאינטראקציה ישירה (first-party) ומזהה הקהל מצד שלישי של הגדרת הטירגוט לפי קהל מאינטראקציה ישירה ומצד שלישי. המזהה הזה הוא firstAndThirdPartyAudienceId.
recency

enum (Recency)

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

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

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

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

ExchangeAssignedTargetingOptionDetails

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

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

enum (Exchange)

חובה. ערך המאפיין enum של פלטפורמת ה-Exchange.

SubExchangeAssignedTargetingOptionDetails

פרטים על אפשרות הטירגוט ל-Sub-Exchange. השדה הזה יאוכלס בשדה הפרטים ב-AssignTargetOption כשהערך של targetingType הוא TARGETING_TYPE_SUB_EXCHANGE.

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

string

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

ThirdPartyVerifierAssignedTargetingOptionDetails

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

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

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

FraudOption

אפשרויות אפשריות לשיעור הונאה ולשיעור IVT.

טיפוסים בני מנייה (enum)
FRAUD_UNSPECIFIED המאפיין הזה הוא רק placeholder, והוא לא מציין אפשרויות של תעבורת נתונים לא חוקית ותרמיות.
AD_IMPRESSION_FRAUD_100 100% הונאה ותנועה פסולה (IVT).
AD_IMPRESSION_FRAUD_50 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
  ]
}
שדות
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, כולל.

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 הערך 'טיפוסים בני מנייה (enum)' הוא רק placeholder ולא מפורטות בו אפשרויות למבוגרים בלבד.
ADULT_HR למבוגרים בלבד – לא כולל סיכון גבוה.
ADULT_HMR למבוגרים בלבד – לא כולל סיכון גבוה וסיכון בינוני.

אלכוהול

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

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

IllegalDownloads

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

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

סמים

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

טיפוסים בני מנייה (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 הערך 'טיפוסים בני מנייה (enum)' הוא רק placeholder ולא מוגדרות בו אפשרויות שפה.
OFFENSIVE_LANGUAGE_HR שפה פוגענית – החרגת סיכון גבוה.
OFFENSIVE_LANGUAGE_HMR שפה פוגענית – החרגת סיכון גבוה וסיכון בינוני.

אלימות

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

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

הימורים

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

טיפוסים בני מנייה (enum)
GAMBLING_UNSPECIFIED הערך של 'טיפוסים בני מנייה (enum)' הוא רק 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 Video.

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

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

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

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

enum (Omid)

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

AudioContentTypeAssignedTargetingOptionDetails

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

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

enum (AudioContentType)

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

ContentGenreAssignedTargetingOptionDetails

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

שיטות

get

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

list

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