REST Resource: advertisers.adGroups.targetingTypes.assignedTargetingOptions

منبع: AssignedTargetingOption

یک گزینه هدف‌گیری واحد که وضعیت گزینه هدف‌گیری را برای یک موجودیت با تنظیمات هدف‌گیری تعریف می‌کند.

نمایش JSON 
{
  "name": string,
  "assignedTargetingOptionId": string,
  "assignedTargetingOptionIdAlias": string,
  "targetingType": enum (TargetingType),
  "inheritance": enum (Inheritance),

  // Union field details can be only one of the following:
  "channelDetails": {
    object (ChannelAssignedTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryAssignedTargetingOptionDetails)
  },
  "appDetails": {
    object (AppAssignedTargetingOptionDetails)
  },
  "urlDetails": {
    object (UrlAssignedTargetingOptionDetails)
  },
  "dayAndTimeDetails": {
    object (DayAndTimeAssignedTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeAssignedTargetingOptionDetails)
  },
  "regionalLocationListDetails": {
    object (RegionalLocationListAssignedTargetingOptionDetails)
  },
  "proximityLocationListDetails": {
    object (ProximityLocationListAssignedTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderAssignedTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeAssignedTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentAssignedTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusAssignedTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionAssignedTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionAssignedTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeAssignedTargetingOptionDetails)
  },
  "audienceGroupDetails": {
    object (AudienceGroupAssignedTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserAssignedTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeAssignedTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionAssignedTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspAssignedTargetingOptionDetails)
  },
  "keywordDetails": {
    object (KeywordAssignedTargetingOptionDetails)
  },
  "negativeKeywordListDetails": {
    object (NegativeKeywordListAssignedTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemAssignedTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelAssignedTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentAssignedTargetingOptionDetails)
  },
  "inventorySourceDetails": {
    object (InventorySourceAssignedTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryAssignedTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityAssignedTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusAssignedTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageAssignedTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionAssignedTargetingOptionDetails)
  },
  "inventorySourceGroupDetails": {
    object (InventorySourceGroupAssignedTargetingOptionDetails)
  },
  "digitalContentLabelExclusionDetails": {
    object (DigitalContentLabelAssignedTargetingOptionDetails)
  },
  "sensitiveCategoryExclusionDetails": {
    object (SensitiveCategoryAssignedTargetingOptionDetails)
  },
  "contentThemeExclusionDetails": {
    object (ContentThemeAssignedTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeAssignedTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeAssignedTargetingOptionDetails)
  },
  "thirdPartyVerifierDetails": {
    object (ThirdPartyVerifierAssignedTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiAssignedTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainAssignedTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationAssignedTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeAssignedTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionAssignedTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidAssignedTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeAssignedTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreAssignedTargetingOptionDetails)
  },
  "youtubeVideoDetails": {
    object (YoutubeVideoAssignedTargetingOptionDetails)
  },
  "youtubeChannelDetails": {
    object (YoutubeChannelAssignedTargetingOptionDetails)
  },
  "sessionPositionDetails": {
    object (SessionPositionAssignedTargetingOptionDetails)
  }
  // End of list of possible types for union field details.
}
فیلدها
name

string

فقط خروجی. نام منبع برای این گزینه هدف‌گیری اختصاص داده شده.

assignedTargetingOptionId

string

فقط خروجی. شناسه منحصر به فرد گزینه هدف‌گیری اختصاص داده شده. این شناسه فقط در یک منبع و نوع هدف‌گیری مشخص منحصر به فرد است. ممکن است در زمینه‌های دیگر نیز مورد استفاده مجدد قرار گیرد.

assignedTargetingOptionIdAlias

string

فقط خروجی. یک نام مستعار برای assignedTargetingOptionId . این مقدار می‌تواند به جای assignedTargetingOptionId هنگام بازیابی یا حذف target موجود استفاده شود.

این فیلد فقط برای همه گزینه‌های هدف‌گذاری اختصاص داده شده از انواع هدف‌گذاری زیر پشتیبانی می‌شود:

  • 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 فیلد Union. اطلاعات دقیق در مورد گزینه هدف‌گیری اختصاص داده شده. فقط یک فیلد در details می‌تواند پر شود و باید با targeting_type مطابقت داشته باشد؛ details فقط می‌تواند یکی از موارد زیر باشد:
channelDetails

object ( ChannelAssignedTargetingOptionDetails )

جزئیات کانال. این فیلد زمانی پر می‌شود که targetingType TARGETING_TYPE_CHANNEL باشد.

appCategoryDetails

object ( AppCategoryAssignedTargetingOptionDetails )

جزئیات دسته‌بندی برنامه. این فیلد زمانی پر می‌شود که targetingType TARGETING_TYPE_APP_CATEGORY باشد.

appDetails

object ( AppAssignedTargetingOptionDetails )

جزئیات برنامه. این فیلد زمانی پر می‌شود که targetingType برابر با TARGETING_TYPE_APP باشد.

urlDetails

object ( UrlAssignedTargetingOptionDetails )

جزئیات URL. این فیلد زمانی پر می‌شود که targetingType برابر با TARGETING_TYPE_URL باشد.

dayAndTimeDetails

object ( DayAndTimeAssignedTargetingOptionDetails )

جزئیات روز و زمان. این فیلد زمانی پر می‌شود که targetingType TARGETING_TYPE_DAY_AND_TIME باشد.

ageRangeDetails

object ( AgeRangeAssignedTargetingOptionDetails )

جزئیات محدوده سنی. این فیلد زمانی پر می‌شود که targetingType TARGETING_TYPE_AGE_RANGE باشد.

regionalLocationListDetails

object ( RegionalLocationListAssignedTargetingOptionDetails )

جزئیات فهرست موقعیت‌های منطقه‌ای. این فیلد زمانی پر می‌شود که نوع targetingType برابر با TARGETING_TYPE_REGIONAL_LOCATION_LIST باشد.

proximityLocationListDetails

object ( ProximityLocationListAssignedTargetingOptionDetails )

جزئیات لیست مکان‌های نزدیک. این فیلد زمانی پر می‌شود که targetingType TARGETING_TYPE_PROXIMITY_LOCATION_LIST باشد.

genderDetails

object ( GenderAssignedTargetingOptionDetails )

جزئیات جنسیت. این فیلد زمانی پر می‌شود که targetingType TARGETING_TYPE_GENDER باشد.

videoPlayerSizeDetails

object ( VideoPlayerSizeAssignedTargetingOptionDetails )

جزئیات اندازه پخش‌کننده ویدیو. این فیلد زمانی پر می‌شود که targetingType TARGETING_TYPE_VIDEO_PLAYER_SIZE باشد.

userRewardedContentDetails

object ( UserRewardedContentAssignedTargetingOptionDetails )

جزئیات محتوای پاداش داده شده به کاربر. این فیلد زمانی پر می‌شود که targetingType TARGETING_TYPE_USER_REWARDED_CONTENT باشد.

parentalStatusDetails

object ( ParentalStatusAssignedTargetingOptionDetails )

جزئیات وضعیت والدین. این فیلد زمانی پر می‌شود که targetingType TARGETING_TYPE_PARENTAL_STATUS باشد.

contentInstreamPositionDetails

object ( ContentInstreamPositionAssignedTargetingOptionDetails )

جزئیات موقعیت محتوا در جریان. این فیلد زمانی پر می‌شود که targetingType برابر با TARGETING_TYPE_CONTENT_INSTREAM_POSITION باشد.

contentOutstreamPositionDetails

object ( ContentOutstreamPositionAssignedTargetingOptionDetails )

جزئیات موقعیت خروجی محتوا. این فیلد زمانی پر می‌شود که targetingType برابر با TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION باشد.

deviceTypeDetails

object ( DeviceTypeAssignedTargetingOptionDetails )

جزئیات نوع دستگاه. این فیلد زمانی پر می‌شود که targetingType TARGETING_TYPE_DEVICE_TYPE باشد.

audienceGroupDetails

object ( AudienceGroupAssignedTargetingOptionDetails )

جزئیات هدف‌گیری مخاطب. این فیلد زمانی پر می‌شود که نوع targetingType TARGETING_TYPE_AUDIENCE_GROUP باشد. شما فقط می‌توانید برای هر منبع، یک گزینه گروه مخاطب را هدف قرار دهید.

browserDetails

object ( BrowserAssignedTargetingOptionDetails )

جزئیات مرورگر. این فیلد زمانی پر می‌شود که targetingType TARGETING_TYPE_BROWSER باشد.

householdIncomeDetails

object ( HouseholdIncomeAssignedTargetingOptionDetails )

جزئیات درآمد خانوار. این فیلد زمانی پر می‌شود که targetingType برابر با TARGETING_TYPE_HOUSEHOLD_INCOME باشد.

onScreenPositionDetails

object ( OnScreenPositionAssignedTargetingOptionDetails )

جزئیات موقعیت روی صفحه نمایش. این فیلد زمانی پر می‌شود که targetingType برابر با TARGETING_TYPE_ON_SCREEN_POSITION باشد.

carrierAndIspDetails

object ( CarrierAndIspAssignedTargetingOptionDetails )

جزئیات اپراتور و ارائه‌دهنده خدمات اینترنتی. این فیلد زمانی پر می‌شود که targetingType TARGETING_TYPE_CARRIER_AND_ISP باشد.

keywordDetails

object ( KeywordAssignedTargetingOptionDetails )

جزئیات کلمه کلیدی. این فیلد زمانی پر می‌شود که targetingType TARGETING_TYPE_KEYWORD باشد.

حداکثر ۵۰۰۰ کلمه کلیدی منفی مستقیم را می‌توان به یک منبع اختصاص داد. هیچ محدودیتی در تعداد کلمات کلیدی مثبت که می‌توان اختصاص داد، وجود ندارد.

negativeKeywordListDetails

object ( NegativeKeywordListAssignedTargetingOptionDetails )

جزئیات کلمه کلیدی. این فیلد زمانی پر می‌شود که targetingType TARGETING_TYPE_NEGATIVE_KEYWORD_LIST باشد.

حداکثر ۴ فهرست کلمات کلیدی منفی را می‌توان به یک منبع اختصاص داد.

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 باشد.

شما فقط می‌توانید برای هر منبع، یک گزینه وضعیت فروشنده مجاز را هدف قرار دهید.

اگر منبعی گزینه وضعیت فروشنده مجاز را نداشته باشد، تمام فروشندگان مجاز که در فایل ads.txt به عنوان DIRECT یا RESELLER مشخص شده‌اند، به طور پیش‌فرض هدف قرار می‌گیرند.

languageDetails

object ( LanguageAssignedTargetingOptionDetails )

جزئیات زبان. این فیلد زمانی پر می‌شود که targetingType TARGETING_TYPE_LANGUAGE باشد.

geoRegionDetails

object ( GeoRegionAssignedTargetingOptionDetails )

جزئیات منطقه جغرافیایی. این فیلد زمانی پر می‌شود که targetingType TARGETING_TYPE_GEO_REGION باشد.

inventorySourceGroupDetails

object ( InventorySourceGroupAssignedTargetingOptionDetails )

جزئیات گروه منبع موجودی. این فیلد زمانی پر می‌شود که targetingType TARGETING_TYPE_INVENTORY_SOURCE_GROUP باشد.

digitalContentLabelExclusionDetails

object ( DigitalContentLabelAssignedTargetingOptionDetails )

جزئیات برچسب محتوای دیجیتال. این فیلد زمانی پر می‌شود که نوع targetingType برابر با TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION باشد.

برچسب‌های محتوای دیجیتال، موارد استثنا را هدف قرار می‌دهند. موارد استثنا در سطح تبلیغ‌کننده برای برچسب محتوای دیجیتال، در صورت تنظیم، همیشه در ارائه اعمال می‌شوند (حتی اگر در تنظیمات منابع قابل مشاهده نباشند). تنظیمات منابع می‌توانند علاوه بر موارد استثنا برای تبلیغ‌کننده، برچسب‌های محتوا را نیز حذف کنند، اما نمی‌توانند آنها را لغو کنند. اگر همه برچسب‌های محتوای دیجیتال حذف شوند، یک آیتم خطی ارائه نخواهد شد.

sensitiveCategoryExclusionDetails

object ( SensitiveCategoryAssignedTargetingOptionDetails )

جزئیات دسته‌بندی حساس. این فیلد زمانی پر می‌شود که نوع targetingType برابر با TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION باشد.

دسته‌های حساس، استثنائات هدفمند هستند. اگر استثنائات دسته حساس به سطح تبلیغ‌کننده تنظیم شوند، همیشه در ارائه اعمال می‌شوند (حتی اگر در تنظیمات منابع قابل مشاهده نباشند). تنظیمات منابع می‌توانند علاوه بر استثنائات تبلیغ‌کننده، دسته‌های حساس را نیز مستثنی کنند، اما نمی‌توانند آنها را لغو کنند.

contentThemeExclusionDetails

object ( ContentThemeAssignedTargetingOptionDetails )

جزئیات قالب محتوا. این فیلد زمانی پر می‌شود که targetingType برابر با TARGETING_TYPE_CONTENT_THEME_EXCLUSION باشد.

قالب محتوا، استثنائات هدفمند هستند. اگر استثنائات قالب محتوای سطح تبلیغ‌کننده تنظیم شوند، همیشه در ارائه اعمال می‌شوند (حتی اگر در تنظیمات منابع قابل مشاهده نباشند). تنظیمات منابع می‌توانند علاوه بر استثنائات تبلیغ‌کننده، قالب محتوا را نیز مستثنی کنند.

exchangeDetails

object ( ExchangeAssignedTargetingOptionDetails )

جزئیات تبادل. این فیلد زمانی پر می‌شود که targetingType TARGETING_TYPE_EXCHANGE باشد.

subExchangeDetails

object ( SubExchangeAssignedTargetingOptionDetails )

جزئیات زیر-صرافی. این فیلد زمانی پر می‌شود که 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 )

جزئیات ویدیوی یوتیوب. این فیلد زمانی پر می‌شود که targetingType TARGETING_TYPE_YOUTUBE_VIDEO باشد.

youtubeChannelDetails

object ( YoutubeChannelAssignedTargetingOptionDetails )

جزئیات کانال یوتیوب. این فیلد زمانی پر می‌شود که targetingType TARGETING_TYPE_YOUTUBE_CHANNEL باشد.

sessionPositionDetails

object ( SessionPositionAssignedTargetingOptionDetails )

جزئیات موقعیت جلسه. این فیلد زمانی پر می‌شود که targetingType TARGETING_TYPE_SESSION_POSITION باشد.

وراثت

نشان می‌دهد که آیا گزینه هدف‌گیری اختصاص داده شده از یک نهاد سطح بالاتر مانند یک شریک یا یک تبلیغ‌کننده به ارث رسیده است یا خیر. گزینه‌های هدف‌گیری اختصاص داده شده به ارث رسیده، مقدم هستند و همیشه در خدمت‌رسانی نسبت به هدف‌گذاری اختصاص داده شده در سطح فعلی اعمال می‌شوند و نمی‌توان آنها را از طریق سرویس نهاد فعلی تغییر داد. آنها باید از طریق سرویس نهادی که از آن به ارث رسیده‌اند، اصلاح شوند. این ارث‌بری فقط در مورد کانال‌های با هدف‌گیری منفی، استثنائات دسته‌بندی حساس و استثنائات برچسب محتوای دیجیتال اعمال می‌شود، اگر در سطح والد پیکربندی شده باشند.

انوم‌ها
INHERITANCE_UNSPECIFIED وراثت نامشخص یا نامعلوم است.
NOT_INHERITED گزینه هدف‌گیری اختصاص داده شده از موجودیت سطح بالاتر به ارث نمی‌رسد.
INHERITED_FROM_PARTNER گزینه هدف‌گیری اختصاص داده شده از تنظیمات هدف‌گیری شریک به ارث رسیده است.
INHERITED_FROM_ADVERTISER گزینه هدف‌گیری اختصاص داده شده از تنظیمات هدف‌گیری تبلیغ‌کننده به ارث رسیده است.

جزئیات گزینه هدف‌گیری اختصاص داده شده به کانال

جزئیات مربوط به گزینه هدف‌گیری کانال اختصاص داده شده. این مورد در فیلد جزئیات یک AssignedTargetingOption زمانی که targetingType TARGETING_TYPE_CHANNEL باشد، پر خواهد شد.

نمایش JSON 
{
  "channelId": string,
  "negative": boolean
}
فیلدها
channelId

string ( int64 format)

الزامی. شناسه کانال. باید به فیلد شناسه کانال در منبع کانال متعلق به شریک یا کانال متعلق به تبلیغ‌کننده اشاره کند.

negative

boolean

نشان می‌دهد که آیا این گزینه به صورت منفی هدف‌گیری شده است یا خیر. برای گزینه هدف‌گیری اختصاص داده شده به سطح تبلیغ‌کننده، این فیلد باید درست باشد.

جزئیات گزینه هدف‌گیری اختصاص داده شده به دسته بندی برنامه

جزئیات مربوط به گزینه هدف‌گیری دسته‌بندی برنامه اختصاص داده شده. این گزینه در فیلد 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

نشان می‌دهد که آیا این گزینه به صورت منفی هدف قرار گرفته است یا خیر.

جزئیات گزینه هدف‌گیری اختصاص داده شده به برنامه

جزئیات مربوط به گزینه هدف‌گیری برنامه اختصاص داده شده. این مورد در فیلد جزئیات یک AssignedTargetingOption زمانی که targetingType TARGETING_TYPE_APP باشد، پر خواهد شد.

نمایش JSON 
{
  "appId": string,
  "displayName": string,
  "negative": boolean,
  "appPlatform": enum (AppPlatform)
}
فیلدها
appId

string

الزامی. شناسه برنامه.

برنامه‌ی پلی‌استور اندروید از شناسه‌ی بسته (bundle ID) استفاده می‌کند، برای مثال com.google.android.gm . شناسه‌ی برنامه‌ی اپ‌استور اپل از یک رشته‌ی ۹ رقمی استفاده می‌کند، برای مثال 422689480 .

displayName

string

فقط خروجی. نام نمایشی برنامه.

negative

boolean

نشان می‌دهد که آیا این گزینه به صورت منفی هدف قرار گرفته است یا خیر.

appPlatform

enum ( AppPlatform )

پلتفرم برنامه‌ی مورد نظر را نشان می‌دهد. اگر این فیلد مشخص نشود، پلتفرم برنامه، موبایل (یعنی اندروید یا iOS) فرض می‌شود و ما پلتفرم موبایل مناسب را از شناسه‌ی برنامه استخراج خواهیم کرد.

پلتفرم اپلیکیشن

گزینه‌های ممکن برای هدف‌گیری پلتفرم اپلیکیشن.

انوم‌ها
APP_PLATFORM_UNSPECIFIED مقدار پیش‌فرض زمانی که پلتفرم برنامه در این نسخه مشخص نشده باشد. این enum یک جای‌نگهدار برای مقدار پیش‌فرض است و یک گزینه پلتفرم واقعی را نشان نمی‌دهد.
APP_PLATFORM_IOS پلتفرم این اپلیکیشن iOS است.
APP_PLATFORM_ANDROID پلتفرم این اپلیکیشن اندروید است.
APP_PLATFORM_ROKU پلتفرم برنامه Roku است.
APP_PLATFORM_AMAZON_FIRETV پلتفرم این برنامه Amazon FireTV است.
APP_PLATFORM_PLAYSTATION پلتفرم این برنامه پلی‌استیشن است.
APP_PLATFORM_APPLE_TV پلتفرم این برنامه، اپل تی‌وی است.
APP_PLATFORM_XBOX پلتفرم برنامه ایکس‌باکس است.
APP_PLATFORM_SAMSUNG_TV پلتفرم این برنامه، سامسونگ تی‌وی است.
APP_PLATFORM_ANDROID_TV پلتفرم این برنامه اندروید تی‌وی است.
APP_PLATFORM_GENERIC_CTV پلتفرم این اپلیکیشن یک پلتفرم CTV است که به صراحت در جای دیگری فهرست نشده است.
APP_PLATFORM_LG_TV پلتفرم برنامه، تلویزیون ال‌جی است.
APP_PLATFORM_VIZIO_TV پلتفرم برنامه VIZIO TV است.
APP_PLATFORM_VIDAA پلتفرم این اپلیکیشن Vidaa است.

جزئیات گزینه هدف‌گذاری تخصیص‌یافته به آدرس

جزئیات مربوط به گزینه هدف‌گیری URL اختصاص داده شده. این مورد در فیلد جزئیات AssignedTargetingOption زمانی که targetingType TARGETING_TYPE_URL باشد، پر خواهد شد.

نمایش JSON 
{
  "url": string,
  "negative": boolean
}
فیلدها
url

string

الزامی. آدرس اینترنتی، برای مثال example.com .

DV360 از دو سطح هدف‌گیری زیرشاخه‌ها، برای مثال www.example.com/one-subdirectory-level/second-level ، و پنج سطح هدف‌گیری زیردامنه، برای مثال five.four.three.two.one.example.com ، پشتیبانی می‌کند.

negative

boolean

نشان می‌دهد که آیا این گزینه به صورت منفی هدف قرار گرفته است یا خیر.

جزئیات گزینه هدف‌گذاری اختصاص داده شده به روز و زمان

نمایش بخشی از زمان که در یک روز خاص از هفته و با زمان شروع و پایان تعریف شده است. زمان نمایش داده شده توسط startHour باید قبل از زمان نمایش داده شده توسط endHour باشد.

نمایش JSON 
{
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer,
  "timeZoneResolution": enum (TimeZoneResolution)
}
فیلدها
dayOfWeek

enum ( DayOfWeek )

الزامی. روز هفته برای این تنظیم هدف‌گذاری روز و زمان.

startHour

integer

الزامی. ساعت شروع برای هدف‌گذاری روزانه و زمانی. باید بین ۰ (شروع روز) و ۲۳ (۱ ساعت قبل از پایان روز) باشد.

endHour

integer

الزامی. ساعت پایان هدف‌گذاری روزانه و زمانی. باید بین ۱ (۱ ساعت پس از شروع روز) و ۲۴ (پایان روز) باشد.

timeZoneResolution

enum ( TimeZoneResolution )

الزامی. مکانیزمی که برای تعیین منطقه زمانی مورد استفاده برای تنظیم هدف‌گذاری روز و زمان استفاده می‌شود.

روز هفته

نشان دهنده یک روز از هفته است.

انوم‌ها
DAY_OF_WEEK_UNSPECIFIED روز هفته مشخص نشده است.
MONDAY دوشنبه
TUESDAY سه‌شنبه
WEDNESDAY چهارشنبه
THURSDAY پنجشنبه
FRIDAY جمعه
SATURDAY شنبه
SUNDAY یکشنبه

وضوح منطقه زمانی

رویکردهای ممکن برای حل مشکل منطقه زمانی.

انوم‌ها
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 )

الزامی. محدوده سنی مخاطب. ما فقط از هدف قرار دادن یک محدوده سنی پیوسته از مخاطب پشتیبانی می‌کنیم. بنابراین، محدوده سنی ارائه شده در این زمینه می‌تواند ۱) منحصراً هدف قرار گرفته باشد، یا ۲) بخشی از یک محدوده سنی پیوسته بزرگتر باشد. دسترسی به یک محدوده سنی پیوسته را می‌توان با هدف قرار دادن مخاطبانی با سن نامشخص نیز گسترش داد.

جزئیات گزینه هدف‌گیری اختصاص داده شده به فهرست موقعیت‌های منطقه‌ای

جزئیات هدف‌گیری برای فهرست موقعیت‌های منطقه‌ای. این مورد در فیلد جزئیات یک AssignedTargetingOption زمانی که targetingType برابر با TARGETING_TYPE_REGIONAL_LOCATION_LIST باشد، پر خواهد شد.

نمایش JSON 
{
  "regionalLocationListId": string,
  "negative": boolean
}
فیلدها
regionalLocationListId

string ( int64 format)

الزامی. شناسه‌ی فهرست مکان‌های منطقه‌ای. باید به فیلد locationListId از یک منبع LocationList که نوع آن TARGETING_LOCATION_TYPE_REGIONAL است، اشاره کند.

negative

boolean

نشان می‌دهد که آیا این گزینه به صورت منفی هدف قرار گرفته است یا خیر.

جزئیات گزینه هدف‌گیریِ تخصیص‌یافته به لیست موقعیت‌های مکانیِ مجاورت

جزئیات هدف‌گیری برای فهرست مکان‌های نزدیک. این مورد در فیلد جزئیات یک 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 تنظیم شده است. این نشان دهنده اندازه منطقه اطراف یک مکان انتخاب شده است که هدف قرار خواهد گرفت. شعاع باید بین ۱ تا ۵۰۰ مایل یا ۸۰۰ کیلومتر باشد.

proximityRadiusUnit

enum ( ProximityRadiusUnit )

الزامی. واحدهای فاصله شعاعی.

واحد شعاع مجاورت

واحدهای فاصله enum برای ProximityRadius.

انوم‌ها
PROXIMITY_RADIUS_UNIT_UNSPECIFIED مقدار پیش‌فرض زمانی که واحدهای فاصله در این نسخه مشخص نشده باشند. این enum یک نگهدارنده‌ی مکان برای مقدار پیش‌فرض است و واحد فاصله‌ی واقعی را نشان نمی‌دهد.
PROXIMITY_RADIUS_UNIT_MILES واحد فاصله شعاعی بر حسب مایل.
PROXIMITY_RADIUS_UNIT_KILOMETERS واحد فاصله شعاعی بر حسب کیلومتر

جزئیات گزینه هدف‌گیری تخصیص‌یافته به جنسیت

جزئیات مربوط به گزینه هدف‌گذاری جنسیت اختصاص داده شده. این مورد در فیلد جزئیات یک AssignedTargetingOption زمانی که targetingType TARGETING_TYPE_GENDER باشد، پر خواهد شد.

نمایش JSON 
{
  "gender": enum (Gender)
}
فیلدها
gender

enum ( Gender )

الزامی. جنسیت مخاطب.

جزئیات گزینه هدف‌گیری اختصاص داده شده به پخش‌کننده ویدیواندازه پخش‌کننده

جزئیات گزینه هدف‌گیری اندازه پخش‌کننده ویدیو. این گزینه در فیلد videoPlayerSizeDetails زمانی که targetingType TARGETING_TYPE_VIDEO_PLAYER_SIZE باشد، پر خواهد شد. هدف‌گیری صریح همه گزینه‌ها پشتیبانی نمی‌شود. برای دستیابی به این اثر، همه گزینه‌های هدف‌گیری اندازه پخش‌کننده ویدیو را حذف کنید.

نمایش JSON 
{
  "videoPlayerSize": enum (VideoPlayerSize)
}
فیلدها
videoPlayerSize

enum ( VideoPlayerSize )

الزامی. اندازه پخش‌کننده ویدیو.

جزئیات گزینه هدف‌گیری اختصاص داده شده به کاربر با پاداش محتوا

جزئیات گزینه هدف‌گیری محتوای پاداش‌دهی‌شده به کاربر. این گزینه در فیلد 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 )

فقط خروجی. وضعیت محتوای پاداش داده شده توسط کاربر برای تبلیغات ویدیویی.

جزئیات گزینه هدف‌گیریِ اختصاص‌یافته به والدینوضعیت

جزئیات مربوط به گزینه هدف‌گیری وضعیت والدین اختصاص داده شده. این مورد در فیلد جزئیات یک AssignedTargetingOption زمانی که targetingType TARGETING_TYPE_PARENTAL_STATUS باشد، پر خواهد شد.

نمایش JSON 
{
  "parentalStatus": enum (ParentalStatus)
}
فیلدها
parentalStatus

enum ( ParentalStatus )

الزامی. وضعیت والدین مخاطب.

جزئیات گزینه هدف‌گیری تخصیص‌یافته در موقعیت محتوادرجریان

جزئیات گزینه هدف‌گیری موقعیت درون جریانی محتوا اختصاص داده شده است. این مورد در فیلد 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 باشد، توسط آیتم خط جدید به ارث برده می‌شود.

نوع تبلیغ

نشان دهنده نوع خلاقیت مرتبط با تبلیغات است.

انوم‌ها
AD_TYPE_UNSPECIFIED نوع تبلیغ در این نسخه مشخص نشده یا ناشناخته است.
AD_TYPE_DISPLAY نمایش موارد خلاقانه، مانند تصویر و HTML5.
AD_TYPE_VIDEO ویدیوهای خلاقانه، مثلاً تبلیغات ویدیویی که هنگام پخش محتوای استریم در پخش‌کننده‌های ویدیو پخش می‌شوند.
AD_TYPE_AUDIO خلاقیت‌های صوتی، مانند تبلیغات صوتی که در حین محتوای صوتی پخش می‌شوند.

جزئیات گزینه هدف‌گیری تخصیص‌یافته به محتوا

جزئیات گزینه هدف‌گیری موقعیت خروجی محتوا اختصاص داده شده است. این مورد در فیلد contentOutstreamPositionDetails زمانی که targetingType برابر با TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION باشد، پر خواهد شد.

نمایش JSON 
{
  "contentOutstreamPosition": enum (ContentOutstreamPosition),
  "adType": enum (AdType)
}
فیلدها
contentOutstreamPosition

enum ( ContentOutstreamPosition )

الزامی. موقعیت خروجی محتوا.

adType

enum ( AdType )

فقط خروجی. نوع تبلیغ برای هدف‌گیری. فقط برای هدف‌گیری ترتیب درج قابل استفاده است و آیتم‌های خط جدید که از نوع تبلیغ مشخص‌شده پشتیبانی می‌کنند، به‌طور پیش‌فرض این گزینه هدف‌گیری را به ارث می‌برند. مقادیر ممکن عبارتند از:

  • AD_TYPE_DISPLAY ، این تنظیم زمانی که lineItemType برابر با LINE_ITEM_TYPE_DISPLAY_DEFAULT باشد، توسط آیتم خط جدید به ارث برده می‌شود.
  • AD_TYPE_VIDEO ، این تنظیم زمانی که lineItemType برابر با LINE_ITEM_TYPE_VIDEO_DEFAULT باشد، توسط آیتم خط جدید به ارث برده می‌شود.

جزئیات گزینه هدف‌گیری اختصاص داده شده به نوع دستگاه

جزئیات هدف‌گیری برای نوع دستگاه. این مورد در فیلد جزئیات AssignedTargetingOption زمانی که targetingType TARGETING_TYPE_DEVICE_TYPE باشد، پر خواهد شد.

نمایش JSON 
{
  "deviceType": enum (DeviceType),
  "youtubeAndPartnersBidMultiplier": number
}
فیلدها
deviceType

enum ( DeviceType )

الزامی. نام نمایشی نوع دستگاه.

youtubeAndPartnersBidMultiplier

number

فقط خروجی. ضریب پیشنهاد به شما این امکان را می‌دهد که تبلیغات خود را بر اساس نوع دستگاه، بیشتر یا کمتر نمایش دهید. این ضریب، قیمت پیشنهادی اصلی را افزایش می‌دهد. وقتی این فیلد ۰ باشد، به جای ضرب ۰ در قیمت پیشنهادی اصلی، نشان می‌دهد که این فیلد قابل اجرا نیست.

برای مثال، اگر قیمت پیشنهادی بدون ضریب ۱۰ دلار و ضریب ۱.۵ برای تبلت باشد، قیمت پیشنهادی حاصل برای تبلت ۱۵ دلار خواهد بود.

فقط برای موارد مربوط به یوتیوب و شرکا قابل اجرا است.

جزئیات گزینه هدف‌گیری تخصیص‌یافته به گروه مخاطبان

جزئیات گزینه هدف‌گیری گروه مخاطبان اختصاص داده شده. این مورد در فیلد جزئیات یک AssignedTargetingOption زمانی که targetingType برابر با TARGETING_TYPE_AUDIENCE_GROUP باشد، پر خواهد شد. رابطه بین هر گروه UNION است، به جز excludeFirstAndThirdPartyAudienceGroup و excludeGoogleAudienceGroup که COMPLEMENT به عنوان یک تقاطع با سایر گروه‌ها استفاده می‌شود.

نمایش JSON 
{
  "includedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  },
  "includedCustomListGroup": {
    object (CustomListGroup)
  },
  "includedCombinedAudienceGroup": {
    object (CombinedAudienceGroup)
  },
  "excludedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  },
  "includedFirstPartyAndPartnerAudienceGroups": [
    {
      object (FirstPartyAndPartnerAudienceGroup)
    }
  ],
  "excludedFirstPartyAndPartnerAudienceGroup": {
    object (FirstPartyAndPartnerAudienceGroup)
  }
}
فیلدها
includedGoogleAudienceGroup

object ( GoogleAudienceGroup )

اختیاری. شناسه‌های مخاطبان گوگلِ گروه مخاطبان گوگلِ لحاظ‌شده. فقط شامل شناسه‌های مخاطبان گوگل است.

includedCustomListGroup

object ( CustomListGroup )

اختیاری. شناسه‌های لیست سفارشی گروه لیست سفارشیِ شامل‌شده. فقط شامل شناسه‌های لیست سفارشی است.

includedCombinedAudienceGroup

object ( CombinedAudienceGroup )

اختیاری. شناسه‌های مخاطبان ترکیبی گروه مخاطبان ترکیبی. فقط شامل شناسه‌های مخاطبان ترکیبی است.

excludedGoogleAudienceGroup

object ( GoogleAudienceGroup )

اختیاری. شناسه‌های مخاطبان گوگل گروه مخاطبان گوگل حذف‌شده. برای هدف‌گیری منفی استفاده می‌شود. مکمل اتحاد این گروه و سایر گروه‌های مخاطبان حذف‌شده به عنوان نقطه تقاطع برای هرگونه هدف‌گیری مثبت مخاطبان استفاده می‌شود. فقط شامل مخاطبان گوگل از نوع Affinity، In-market و Installed-apps است. همه موارد منطقاً با یکدیگر «OR» هستند.

includedFirstPartyAndPartnerAudienceGroups[]

object ( FirstPartyAndPartnerAudienceGroup )

اختیاری. شناسه‌های مخاطبان طرف اول و شریک و آخرین گروه‌های مخاطبان طرف اول و شریک. هر گروه مخاطبان طرف اول و شریک فقط شامل شناسه‌های مخاطبان طرف اول و شریک است. رابطه بین هر گروه مخاطبان طرف اول و شریک به صورت تقاطع (INTERSCTION) است و نتیجه با سایر گروه‌های مخاطبان ترکیب می‌شود. گروه‌های تکراری با تنظیمات یکسان نادیده گرفته می‌شوند.

excludedFirstPartyAndPartnerAudienceGroup

object ( FirstPartyAndPartnerAudienceGroup )

اختیاری. شناسه‌های مخاطبان طرف اول و شریک و آخرین حضورهای گروه مخاطبان طرف اول و شریک حذف‌شده. برای هدف‌گیری منفی استفاده می‌شود. مکمل اتحاد این گروه و سایر گروه‌های مخاطبان حذف‌شده به عنوان نقطه تقاطع برای هرگونه هدف‌گیری مثبت مخاطبان استفاده می‌شود. همه موارد منطقاً «یا»ی یکدیگر هستند.

گروه مخاطبان گوگل

جزئیات گروه مخاطبان گوگل. همه تنظیمات هدف‌گیری مخاطبان گوگل منطقاً «یا»ی یکدیگر هستند.

نمایش JSON 
{
  "settings": [
    {
      object (GoogleAudienceTargetingSetting)
    }
  ]
}
فیلدها
settings[]

object ( GoogleAudienceTargetingSetting )

الزامی. تمام تنظیمات هدف‌گیری مخاطبان گوگل در گروه مخاطبان گوگل. تنظیمات تکراری با شناسه یکسان نادیده گرفته می‌شوند.

تنظیمات هدف‌گیری مخاطبان گوگل

جزئیات تنظیمات هدف‌گیری مخاطبان گوگل.

نمایش JSON 
{
  "googleAudienceId": string
}
فیلدها
googleAudienceId

string ( int64 format)

الزامی. شناسه مخاطب گوگل مربوط به تنظیمات هدف‌گیری مخاطب گوگل. این شناسه googleAudienceId است.

گروه لیست سفارشی

جزئیات گروه لیست سفارشی. همه تنظیمات هدف‌گیری لیست سفارشی منطقاً «یا»ی یکدیگر هستند.

نمایش JSON 
{
  "settings": [
    {
      object (CustomListTargetingSetting)
    }
  ]
}
فیلدها
settings[]

object ( CustomListTargetingSetting )

الزامی. تمام تنظیمات هدف‌گیری سفارشی لیست در گروه لیست سفارشی. تنظیمات تکراری با شناسه یکسان نادیده گرفته می‌شوند.

تنظیمات هدف‌گذاری لیست سفارشی

جزئیات تنظیمات هدف‌گیری سفارشی فهرست.

نمایش JSON 
{
  "customListId": string
}
فیلدها
customListId

string ( int64 format)

الزامی. شناسه سفارشی تنظیمات هدف‌گیری لیست سفارشی. این شناسه customListId است.

گروه مخاطبان ترکیبی

جزئیات گروه مخاطبان ترکیبی. همه تنظیمات هدف‌گیری مخاطبان ترکیبی منطقاً «یا»ی یکدیگر هستند.

نمایش JSON 
{
  "settings": [
    {
      object (CombinedAudienceTargetingSetting)
    }
  ]
}
فیلدها
settings[]

object ( CombinedAudienceTargetingSetting )

الزامی. تمام تنظیمات هدف‌گیری مخاطبان ترکیبی در گروه مخاطبان ترکیبی. تنظیمات تکراری با شناسه یکسان نادیده گرفته می‌شوند. تعداد تنظیمات مخاطبان ترکیبی نباید بیش از پنج باشد، در غیر این صورت خطا صادر می‌شود.

تنظیمات هدف‌گیری مخاطب ترکیبی

جزئیات تنظیمات هدف‌گیری مخاطبان ترکیبی.

نمایش JSON 
{
  "combinedAudienceId": string
}
فیلدها
combinedAudienceId

string ( int64 format)

الزامی. شناسه مخاطب ترکیبی از تنظیمات هدف‌گیری مخاطب ترکیبی. این شناسه combinedAudienceId است.

گروه مخاطبان FirstPartyAndPartner

جزئیات گروه مخاطبان طرف اول و شریک. همه تنظیمات هدف‌گیری مخاطبان طرف اول و شریک منطقاً «یا»ی یکدیگر هستند.

نمایش JSON 
{
  "settings": [
    {
      object (FirstPartyAndPartnerAudienceTargetingSetting)
    }
  ]
}
فیلدها
settings[]

object ( FirstPartyAndPartnerAudienceTargetingSetting )

الزامی. تمام تنظیمات هدف‌گیری مخاطبان طرف اول و شریک در گروه مخاطبان طرف اول و شریک. تنظیمات تکراری با شناسه یکسان مجاز نیست.

تنظیمات هدف‌گیری مخاطب FirstPartyAndPartner

جزئیات تنظیمات هدف‌گیری مخاطبان طرف اول و شریک.

نمایش JSON 
{
  "firstPartyAndPartnerAudienceId": string,
  "recency": enum (Recency)
}
فیلدها
firstPartyAndPartnerAudienceId

string ( int64 format)

الزامی. شناسه مخاطب طرف اول و شریک مربوط به تنظیمات هدف‌گیری مخاطب طرف اول و شریک. این شناسه firstPartyAndPartnerAudienceId است.

recency

enum ( Recency )

الزامی. میزان تازگی تنظیمات هدف‌گیری مخاطبان طرف اول و شریک. فقط برای مخاطبان طرف اول قابل اجرا است، در غیر این صورت نادیده گرفته می‌شود. برای اطلاعات بیشتر، به https://support.google.com/displayvideo/answer/2949947#recency مراجعه کنید. در صورت عدم تعیین، هیچ محدودیتی برای تازگی اعمال نخواهد شد.

تازگی

همه از مقادیر تازگی مخاطبان شخص اول و شریک پشتیبانی می‌کنند.

انوم‌ها
RECENCY_NO_LIMIT بدون محدودیت تازگی.
RECENCY_1_MINUTE آخرین مهلت ۱ دقیقه است.
RECENCY_5_MINUTES آخرین مهلت ۵ دقیقه است.
RECENCY_10_MINUTES آخرین مهلت 10 دقیقه است.
RECENCY_15_MINUTES آخرین مهلت ۱۵ دقیقه است.
RECENCY_30_MINUTES آخرین مهلت ۳۰ دقیقه است.
RECENCY_1_HOUR آخرین مهلت ۱ ساعت است.
RECENCY_2_HOURS آخرین مهلت ۲ ساعت است.
RECENCY_3_HOURS آخرین بازدید ۳ ساعت است.
RECENCY_6_HOURS آخرین بازدید ۶ ساعت است.
RECENCY_12_HOURS آخرین بازدید ۱۲ ساعت است.
RECENCY_1_DAY آخرین خبر ۱ روز است.
RECENCY_2_DAYS آخرین خبر ۲ روز است.
RECENCY_3_DAYS آخرین خبر ۳ روز است.
RECENCY_5_DAYS آخرین مهلت ۵ روز است.
RECENCY_7_DAYS آخرین مهلت ۷ روز است.
RECENCY_10_DAYS آخرین مهلت 10 روز است.
RECENCY_14_DAYS آخرین مورد ۱۴ روز است.
RECENCY_15_DAYS آخرین مهلت ۱۵ روز است.
RECENCY_21_DAYS آخرین مورد ۲۱ روز است.
RECENCY_28_DAYS آخرین مورد ۲۸ روز است.
RECENCY_30_DAYS آخرین مهلت 30 روز است.
RECENCY_40_DAYS آخرین مهلت ۴۰ روز است.
RECENCY_45_DAYS آخرین مهلت ۴۵ روز است.
RECENCY_60_DAYS آخرین مهلت ۶۰ روز است.
RECENCY_90_DAYS آخرین مهلت ۹۰ روز است.
RECENCY_120_DAYS آخرین مهلت ۱۲۰ روز است.
RECENCY_180_DAYS آخرین مورد ۱۸۰ روز است.
RECENCY_270_DAYS آخرین مورد ۲۷۰ روز است.
RECENCY_365_DAYS آخرین مورد ۳۶۵ روز است.

جزئیات گزینه هدف‌گیری اختصاص داده شده به مرورگر

جزئیات مربوط به گزینه هدف‌گیری مرورگر اختصاص داده شده. این مورد در فیلد جزئیات یک AssignedTargetingOption زمانی که targetingType TARGETING_TYPE_BROWSER باشد، پر خواهد شد.

نمایش JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
فیلدها
displayName

string

فقط خروجی. نام نمایشی مرورگر.

targetingOptionId

string

الزامی. targetingOptionId مربوط به یک TargetingOption از نوع TARGETING_TYPE_BROWSER .

negative

boolean

نشان می‌دهد که آیا این گزینه به صورت منفی هدف‌گیری شده است یا خیر. همه گزینه‌های هدف‌گیری مرورگر اختصاص داده شده در یک منبع باید مقدار یکسانی برای این فیلد داشته باشند.

جزئیات گزینه هدف‌گیری تخصیص‌یافته به درآمد خانوار

جزئیات مربوط به گزینه هدف‌گذاری درآمد خانوار. این مورد در فیلد جزئیات یک AssignedTargetingOption زمانی که targetingType برابر با TARGETING_TYPE_HOUSEHOLD_INCOME باشد، پر خواهد شد.

نمایش JSON 
{
  "householdIncome": enum (HouseholdIncome)
}
فیلدها
householdIncome

enum ( HouseholdIncome )

الزامی. درآمد خانوار مخاطب.

جزئیات گزینه هدف‌گیری اختصاص داده شدهموقعیت روی صفحه

جزئیات گزینه هدف‌گیری موقعیت روی صفحه. این گزینه در فیلد 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 باشد، توسط آیتم خط جدید به ارث برده می‌شود.

جزئیات گزینه هدف‌گیری اختصاص داده شده توسط CarrierAndIsp

جزئیات مربوط به گزینه هدف‌گیری اپراتور و ISP اختصاص داده شده. این مورد در فیلد جزئیات AssignedTargetingOption زمانی که targetingType TARGETING_TYPE_CARRIER_AND_ISP باشد، پر خواهد شد.

نمایش JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
فیلدها
displayName

string

فقط خروجی. نام نمایشی اپراتور یا ISP.

targetingOptionId

string

الزامی. targetingOptionId مربوط به یک TargetingOption از نوع TARGETING_TYPE_CARRIER_AND_ISP .

negative

boolean

نشان می‌دهد که آیا این گزینه به صورت منفی هدف‌گیری شده است یا خیر. همه گزینه‌های هدف‌گذاری اختصاص داده شده به اپراتور و ISP در یک منبع باید مقدار یکسانی برای این فیلد داشته باشند.

جزئیات گزینه هدف‌گیری اختصاص داده شده با کلمه کلیدی

جزئیات مربوط به گزینه هدف‌گیری کلمات کلیدی اختصاص داده شده. این مورد در فیلد جزئیات یک AssignedTargetingOption زمانی که targetingType TARGETING_TYPE_KEYWORD باشد، پر خواهد شد.

نمایش JSON 
{
  "keyword": string,
  "negative": boolean
}
فیلدها
keyword

string

الزامی. کلمه کلیدی، برای مثال car insurance .

کلمه کلیدی مثبت نمی‌تواند کلمه توهین‌آمیز باشد. باید با کد UTF-8 و حداکثر اندازه ۲۵۵ بایت کدگذاری شود. حداکثر تعداد کاراکترها ۸۰ است. حداکثر تعداد کلمات ۱۰ است.

negative

boolean

نشان می‌دهد که آیا این گزینه به صورت منفی هدف قرار گرفته است یا خیر.

جزئیات گزینه هدف‌گیری اختصاص داده شده به لیست کلمات کلیدی منفی

جزئیات هدف‌گیری برای فهرست کلمات کلیدی منفی. این مورد در فیلد جزئیات AssignedTargetingOption زمانی که targetingType برابر با TARGETING_TYPE_NEGATIVE_KEYWORD_LIST باشد، پر خواهد شد.

نمایش JSON 
{
  "negativeKeywordListId": string
}
فیلدها
negativeKeywordListId

string ( int64 format)

الزامی. شناسه‌ی فهرست کلمات کلیدی منفی. باید به فیلد negativeKeywordListId از یک منبع NegativeKeywordList اشاره کند.

جزئیات گزینه‌های هدف‌گیری اختصاص داده شده به سیستم عامل

جزئیات گزینه هدف‌گیری سیستم عامل اختصاص داده شده. این مورد در فیلد 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

نشان می‌دهد که آیا این گزینه به صورت منفی هدف قرار گرفته است یا خیر.

جزئیات گزینه هدف‌گیری تخصیص‌یافته

جزئیات گزینه هدف‌گیری مدل و ساخت دستگاه اختصاص داده شده. این مورد در فیلد 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

نشان می‌دهد که آیا این گزینه به صورت منفی هدف قرار گرفته است یا خیر.

جزئیات گزینه هدف‌گیری اختصاص داده شده به محیط

جزئیات گزینه هدف‌گیری محیطی اختصاص داده شده. این مورد در فیلد جزئیات یک AssignedTargetingOption زمانی که targetingType TARGETING_TYPE_ENVIRONMENT باشد، پر خواهد شد.

نمایش JSON 
{
  "environment": enum (Environment)
}
فیلدها
environment

enum ( Environment )

الزامی. محیط سرو.

منبع موجودیجزئیات گزینه هدف‌گیری اختصاص داده شده

جزئیات هدف‌گیری برای منبع موجودی. این مورد در فیلد جزئیات یک AssignedTargetingOption زمانی که targetingType برابر با TARGETING_TYPE_INVENTORY_SOURCE باشد، پر خواهد شد.

نمایش JSON 
{
  "inventorySourceId": string
}
فیلدها
inventorySourceId

string ( int64 format)

الزامی. شناسه منبع موجودی. باید به فیلد inventorySourceId از منبع InventorySource اشاره کند.

جزئیات گزینه هدف‌گذاری تخصیص‌یافته برای دسته‌بندی

جزئیات گزینه هدف‌گیری دسته‌بندی اختصاص داده شده. این مورد در فیلد categoryDetails زمانی که targetingType TARGETING_TYPE_CATEGORY باشد، پر خواهد شد.

نمایش JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
فیلدها
displayName

string

فقط خروجی. نام نمایشی دسته‌بندی.

targetingOptionId

string

الزامی. فیلد targetingOptionId هنگام targetingType TARGETING_TYPE_CATEGORY است.

negative

boolean

نشان می‌دهد که آیا این گزینه به صورت منفی هدف قرار گرفته است یا خیر.

جزئیات گزینه هدف‌گیری اختصاص داده شده برای قابلیت مشاهده

Assigned viewability targeting option details. This will be populated in the viewabilityDetails field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_VIEWABILITY .

نمایش JSON 
{
  "viewability": enum (Viewability)
}
فیلدها
viewability

enum ( Viewability )

Required. The predicted viewability percentage.

AuthorizedSellerStatusAssignedTargetingOptionDetails

Represents an assigned authorized seller status. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_AUTHORIZED_SELLER_STATUS .

If a resource does not have an TARGETING_TYPE_AUTHORIZED_SELLER_STATUS assigned targeting option, it is using the "Authorized Direct Sellers and Resellers" option.

نمایش JSON 
{
  "authorizedSellerStatus": enum (AuthorizedSellerStatus),
  "targetingOptionId": string
}
فیلدها
authorizedSellerStatus

enum ( AuthorizedSellerStatus )

Output only. The authorized seller status to target.

targetingOptionId

string

Required. The targetingOptionId of a TargetingOption of type TARGETING_TYPE_AUTHORIZED_SELLER_STATUS .

LanguageAssignedTargetingOptionDetails

Details for assigned language targeting option. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_LANGUAGE .

نمایش JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
فیلدها
displayName

string

Output only. The display name of the language (eg, "French").

targetingOptionId

string

Required. The targetingOptionId of a TargetingOption of type TARGETING_TYPE_LANGUAGE .

negative

boolean

Indicates if this option is being negatively targeted. All assigned language targeting options on the same resource must have the same value for this field.

GeoRegionAssignedTargetingOptionDetails

Details for assigned geographic region targeting option. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_GEO_REGION .

نمایش JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "geoRegionType": enum (GeoRegionType),
  "negative": boolean
}
فیلدها
displayName

string

Output only. The display name of the geographic region (eg, "Ontario, Canada").

targetingOptionId

string

Required. The targetingOptionId of a TargetingOption of type TARGETING_TYPE_GEO_REGION .

geoRegionType

enum ( GeoRegionType )

Output only. The type of geographic region targeting.

negative

boolean

Indicates if this option is being negatively targeted.

InventorySourceGroupAssignedTargetingOptionDetails

Targeting details for inventory source group. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_INVENTORY_SOURCE_GROUP .

نمایش JSON 
{
  "inventorySourceGroupId": string
}
فیلدها
inventorySourceGroupId

string ( int64 format)

Required. ID of the inventory source group. Should refer to the inventorySourceGroupId field of an InventorySourceGroup resource.

DigitalContentLabelAssignedTargetingOptionDetails

Targeting details for digital content label. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION .

نمایش JSON 
{
  "excludedContentRatingTier": enum (ContentRatingTier)
}
فیلدها
excludedContentRatingTier

enum ( ContentRatingTier )

Required. The display name of the digital content label rating tier to be EXCLUDED.

SensitiveCategoryAssignedTargetingOptionDetails

Targeting details for sensitive category. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION .

نمایش JSON 
{
  "excludedSensitiveCategory": enum (SensitiveCategory)
}
فیلدها
excludedSensitiveCategory

enum ( SensitiveCategory )

Required. An enum for the DV360 Sensitive category content classified to be EXCLUDED.

ContentThemeAssignedTargetingOptionDetails

Targeting details for content theme. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_CONTENT_THEME_EXCLUSION .

نمایش JSON 
{
  "excludedTargetingOptionId": string,
  "contentTheme": enum (ContentTheme),
  "excludedContentTheme": enum (ContentTheme)
}
فیلدها
excludedTargetingOptionId

string

Required. ID of the content theme to be EXCLUDED.

contentTheme

enum ( ContentTheme )

Output only. An enum for the DV360 content theme classifier.

excludedContentTheme

enum ( ContentTheme )

Required. An enum for the DV360 content theme classified to be EXCLUDED.

ExchangeAssignedTargetingOptionDetails

Details for assigned exchange targeting option. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_EXCHANGE .

نمایش JSON 
{
  "exchange": enum (Exchange)
}
فیلدها
exchange

enum ( Exchange )

Required. The enum value for the exchange.

SubExchangeAssignedTargetingOptionDetails

Details for assigned sub-exchange targeting option. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_SUB_EXCHANGE .

نمایش JSON 
{
  "targetingOptionId": string
}
فیلدها
targetingOptionId

string

Required. The targetingOptionId of a TargetingOption of type TARGETING_TYPE_SUB_EXCHANGE .

ThirdPartyVerifierAssignedTargetingOptionDetails

Assigned third party verifier targeting option details. This will be populated in the details field of an AssignedTargetingOption when targetingType is 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.
}
فیلدها
Union field verifier . Can target one of third-party verifier to enforce brand safety thresholds for impressions. verifier can be only one of the following:
adloox

object ( Adloox )

Third party brand verifier -- Scope3 (previously known as Adloox).

doubleVerify

object ( DoubleVerify )

Third party brand verifier -- DoubleVerify.

integralAdScience

object ( IntegralAdScience )

Third party brand verifier -- Integral Ad Science.

Adloox

Details of Scope3 (previously known as Adloox) brand safety settings.

نمایش JSON 
{
  "excludedAdlooxCategories": [
    enum (AdlooxCategory)
  ],
  "excludedFraudIvtMfaCategories": [
    enum (FraudIvtMfaCategory)
  ],
  "adultExplicitSexualContent": enum (GarmRiskExclusion),
  "crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent": enum (GarmRiskExclusion),
  "armsAmmunitionContent": enum (GarmRiskExclusion),
  "deathInjuryMilitaryConflictContent": enum (GarmRiskExclusion),
  "debatedSensitiveSocialIssueContent": enum (GarmRiskExclusion),
  "illegalDrugsTobaccoEcigarettesVapingAlcoholContent": enum (GarmRiskExclusion),
  "onlinePiracyContent": enum (GarmRiskExclusion),
  "hateSpeechActsAggressionContent": enum (GarmRiskExclusion),
  "obscenityProfanityContent": enum (GarmRiskExclusion),
  "spamHarmfulContent": enum (GarmRiskExclusion),
  "terrorismContent": enum (GarmRiskExclusion),
  "misinformationContent": enum (GarmRiskExclusion),
  "displayIabViewability": enum (DisplayIabViewability),
  "videoIabViewability": enum (VideoIabViewability)
}
فیلدها
excludedAdlooxCategories[]

enum ( AdlooxCategory )

Scope3 categories to exclude.

excludedFraudIvtMfaCategories[]

enum ( FraudIvtMfaCategory )

Optional. Scope3's fraud IVT MFA categories to exclude.

adultExplicitSexualContent

enum ( GarmRiskExclusion )

Optional. Adult and Explicit Sexual Content GARM risk ranges to exclude.

crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent

enum ( GarmRiskExclusion )

Optional. Crime and Harmful Acts Content GARM risk ranges to exclude.

armsAmmunitionContent

enum ( GarmRiskExclusion )

Optional. Arms and Ammunition Content GARM risk ranges to exclude.

deathInjuryMilitaryConflictContent

enum ( GarmRiskExclusion )

Optional. Death, Injury, or Military Conflict Content GARM risk ranges to exclude.

debatedSensitiveSocialIssueContent

enum ( GarmRiskExclusion )

Optional. Debated Sensitive Social Issue Content GARM risk ranges to exclude.

illegalDrugsTobaccoEcigarettesVapingAlcoholContent

enum ( GarmRiskExclusion )

Optional. Illegal Drugs/Alcohol Content GARM risk ranges to exclude.

onlinePiracyContent

enum ( GarmRiskExclusion )

Optional. Online Piracy Content GARM risk ranges to exclude.

hateSpeechActsAggressionContent

enum ( GarmRiskExclusion )

Optional. Hate Speech and Acts of Aggression Content GARM risk ranges to exclude.

obscenityProfanityContent

enum ( GarmRiskExclusion )

Optional. Obscenity and Profanity Content GARM risk ranges to exclude.

spamHarmfulContent

enum ( GarmRiskExclusion )

Optional. Spam or Harmful Content GARM risk ranges to exclude.

terrorismContent

enum ( GarmRiskExclusion )

Optional. Terrorism Content GARM risk ranges to exclude.

misinformationContent

enum ( GarmRiskExclusion )

Optional. Misinformation Content GARM risk ranges to exclude.

displayIabViewability

enum ( DisplayIabViewability )

Optional. IAB viewability threshold for display ads.

videoIabViewability

enum ( VideoIabViewability )

Optional. IAB viewability threshold for video ads.

AdlooxCategory

Available Scope3 (previously known as Adloox) categories.

انوم‌ها
ADLOOX_UNSPECIFIED Default value when a Scope3 category is not specified or is unknown in this version.
ADULT_CONTENT_HARD Adult content (hard).
ADULT_CONTENT_SOFT Adult content (soft).
ILLEGAL_CONTENT Illegal content.
BORDERLINE_CONTENT Borderline content.
DISCRIMINATORY_CONTENT Discriminatory content.
VIOLENT_CONTENT_WEAPONS Violent content & weapons.
LOW_VIEWABILITY_DOMAINS Low viewability domains.
FRAUD Fraud.

FraudIvtMfaCategory

Available Scope3 (previously known as Adloox) Fraud, IVT, MFA categories.

انوم‌ها
FRAUD_IVT_MFA_CATEGORY_UNSPECIFIED Default value when a Scope3 Fraud, IVT, MFA category is not specified or is unknown in this version.
FRAUD_IVT_MFA FRAUD, IVT, MFA.

GarmRiskExclusion

Available GARM risk level exclusion options.

انوم‌ها
GARM_RISK_EXCLUSION_UNSPECIFIED This enum is only a placeholder and it doesn't specify any GARM risk exclusion option.
GARM_RISK_EXCLUSION_FLOOR Exclude floor risk.
GARM_RISK_EXCLUSION_HIGH Exclude high and floor risk.
GARM_RISK_EXCLUSION_MEDIUM Exclude medium, high, and floor risk.
GARM_RISK_EXCLUSION_LOW Exclude all levels of risk (low, medium, high and floor).

DisplayIabViewability

Available Scope3 (previously known as Adloox) IAB display viewability thresholds.

انوم‌ها
DISPLAY_IAB_VIEWABILITY_UNSPECIFIED Default value when not specified or is unknown in this version.
DISPLAY_IAB_VIEWABILITY_10 10%+ in view (IAB display viewability standard).
DISPLAY_IAB_VIEWABILITY_20 20%+ in view (IAB display viewability standard).
DISPLAY_IAB_VIEWABILITY_35 35%+ in view (IAB display viewability standard).
DISPLAY_IAB_VIEWABILITY_50 50%+ in view (IAB display viewability standard).
DISPLAY_IAB_VIEWABILITY_75 75%+ in view (IAB display viewability standard).

VideoIabViewability

Available Scope3 (previously known as Adloox) IAB video viewability thresholds.

انوم‌ها
VIDEO_IAB_VIEWABILITY_UNSPECIFIED Default value when not specified or is unknown in this version.
VIDEO_IAB_VIEWABILITY_10 10%+ in view (IAB video viewability standard).
VIDEO_IAB_VIEWABILITY_20 20%+ in view (IAB video viewability standard).
VIDEO_IAB_VIEWABILITY_35 35%+ in view (IAB video viewability standard).
VIDEO_IAB_VIEWABILITY_50 50%+ in view (IAB video viewability standard).
VIDEO_IAB_VIEWABILITY_75 75%+ in view (IAB video viewability standard).

دابل وریفای

Details of DoubleVerify settings.

نمایش 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 Brand Safety Controls.

avoidedAgeRatings[]

enum ( AgeRating )

Avoid bidding on apps with the age rating.

appStarRating

object ( AppStarRating )

Avoid bidding on apps with the star ratings.

displayViewability

object ( DisplayViewability )

Display viewability settings (applicable to display line items only).

videoViewability

object ( VideoViewability )

Video viewability settings (applicable to video line items only).

fraudInvalidTraffic

object ( FraudInvalidTraffic )

Avoid Sites and Apps with historical Fraud & IVT Rates.

customSegmentId

string ( int64 format)

The custom segment ID provided by DoubleVerify. The ID must start with "51" and consist of eight digits. Custom segment ID cannot be specified along with any of the following fields:

BrandSafetyCategories

Settings for brand safety controls.

نمایش JSON 
{
  "avoidUnknownBrandSafetyCategory": boolean,
  "avoidedHighSeverityCategories": [
    enum (HighSeverityCategory)
  ],
  "avoidedMediumSeverityCategories": [
    enum (MediumSeverityCategory)
  ]
}
فیلدها
avoidUnknownBrandSafetyCategory

boolean

Unknown or unrateable.

avoidedHighSeverityCategories[]

enum ( HighSeverityCategory )

Brand safety high severity avoidance categories.

avoidedMediumSeverityCategories[]

enum ( MediumSeverityCategory )

Brand safety medium severity avoidance categories.

HighSeverityCategory

Possible options for high severity categories.

انوم‌ها
HIGHER_SEVERITY_UNSPECIFIED This enum is only a placeholder and it doesn't specify any high severity categories.
ADULT_CONTENT_PORNOGRAPHY Adult Content: Pornography, Mature Topics & Nudity.
COPYRIGHT_INFRINGEMENT Copyright Infringement.
SUBSTANCE_ABUSE Drugs/Alcohol/Controlled Substances: Substance Abuse.
GRAPHIC_VIOLENCE_WEAPONS Extreme Graphic/Explicit Violence/Weapons.
HATE_PROFANITY Hate/Profanity.
CRIMINAL_SKILLS Illegal Activities: Criminal Skills.
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER Incentivized/Malware/Clutter.

MediumSeverityCategory

Possible options for medium severity categories.

انوم‌ها
MEDIUM_SEVERITY_UNSPECIFIED This enum is only a placeholder and it doesn't specify any medium severity categories.
AD_SERVERS Ad Servers.
ADULT_CONTENT_SWIMSUIT Adult Content: Swimsuit.
ALTERNATIVE_LIFESTYLES Controversial Subjects: Alternative Lifestyles.
CELEBRITY_GOSSIP Controversial Subjects: Celebrity Gossip.
GAMBLING Controversial Subjects: Gambling.
OCCULT Controversial Subjects: Occult.
SEX_EDUCATION Controversial Subjects: Sex Education.
DISASTER_AVIATION Disaster: Aviation.
DISASTER_MAN_MADE Disaster: Man-made.
DISASTER_NATURAL Disaster: Natural.
DISASTER_TERRORIST_EVENTS Disaster: Terrorist Events.
DISASTER_VEHICLE Disaster: Vehicle.
ALCOHOL Drugs/Alcohol/Controlled Substances: Alcohol.
SMOKING Drugs/Alcohol/Controlled Substances: Smoking.
NEGATIVE_NEWS_FINANCIAL Negative News: Financial.
NON_ENGLISH Non-Std Content: Non-English.
PARKING_PAGE Non-Std Content: Parking Page.
UNMODERATED_UGC Unmoderated UGC: Forums, Images & Video.
INFLAMMATORY_POLITICS_AND_NEWS Controversial Subjects: Inflammatory Politics and News.
NEGATIVE_NEWS_PHARMACEUTICAL Negative News: Pharmaceutical.

AgeRating

Possible options for age ratings.

انوم‌ها
AGE_RATING_UNSPECIFIED This enum is only a placeholder and it doesn't specify any age rating options.
APP_AGE_RATE_UNKNOWN Apps with unknown age rating.
APP_AGE_RATE_4_PLUS Apps rated for Everyone (4+).
APP_AGE_RATE_9_PLUS Apps rated for Everyone (9+).
APP_AGE_RATE_12_PLUS Apps rated for Teens (12+).
APP_AGE_RATE_17_PLUS Apps rated for Mature (17+).
APP_AGE_RATE_18_PLUS Apps rated for Adults Only (18+).

AppStarRating

Details of DoubleVerify star ratings settings.

نمایش JSON 
{
  "avoidedStarRating": enum (StarRating),
  "avoidInsufficientStarRating": boolean
}
فیلدها
avoidedStarRating

enum ( StarRating )

Avoid bidding on apps with the star ratings.

avoidInsufficientStarRating

boolean

Avoid bidding on apps with insufficient star ratings.

StarRating

Possible options for star ratings.

انوم‌ها
APP_STAR_RATE_UNSPECIFIED This enum is only a placeholder and it doesn't specify any app star rating options.
APP_STAR_RATE_1_POINT_5_LESS Official Apps with rating < 1.5 Stars.
APP_STAR_RATE_2_LESS Official Apps with rating < 2 Stars.
APP_STAR_RATE_2_POINT_5_LESS Official Apps with rating < 2.5 Stars.
APP_STAR_RATE_3_LESS Official Apps with rating < 3 Stars.
APP_STAR_RATE_3_POINT_5_LESS Official Apps with rating < 3.5 Stars.
APP_STAR_RATE_4_LESS Official Apps with rating < 4 Stars.
APP_STAR_RATE_4_POINT_5_LESS Official Apps with rating < 4.5 Stars.

DisplayViewability

Details of DoubleVerify display viewability settings.

نمایش JSON 
{
  "iab": enum (IAB),
  "viewableDuring": enum (ViewableDuring)
}
فیلدها
iab

enum ( IAB )

Target web and app inventory to maximize IAB viewable rate.

viewableDuring

enum ( ViewableDuring )

Target web and app inventory to maximize 100% viewable duration.

آی ای بی

Possible options for IAB viewable rate.

انوم‌ها
IAB_VIEWED_RATE_UNSPECIFIED This enum is only a placeholder and it doesn't specify any IAB viewed rate options.
IAB_VIEWED_RATE_80_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 80% or higher.
IAB_VIEWED_RATE_75_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 75% or higher.
IAB_VIEWED_RATE_70_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 70% or higher.
IAB_VIEWED_RATE_65_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 65% or higher.
IAB_VIEWED_RATE_60_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 60% or higher.
IAB_VIEWED_RATE_55_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 55% or higher.
IAB_VIEWED_RATE_50_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 50% or higher.
IAB_VIEWED_RATE_40_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 40% or higher.
IAB_VIEWED_RATE_30_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 30% or higher.

ViewableDuring

Possible options for viewable duration.

انوم‌ها
AVERAGE_VIEW_DURATION_UNSPECIFIED This enum is only a placeholder and it doesn't specify any average view duration options.
AVERAGE_VIEW_DURATION_5_SEC Target web and app inventory to maximize 100% viewable duration 5 seconds or more.
AVERAGE_VIEW_DURATION_10_SEC Target web and app inventory to maximize 100% viewable duration 10 seconds or more.
AVERAGE_VIEW_DURATION_15_SEC Target web and app inventory to maximize 100% viewable duration 15 seconds or more.

VideoViewability

Details of DoubleVerify video viewability settings.

نمایش JSON 
{
  "videoIab": enum (VideoIAB),
  "videoViewableRate": enum (VideoViewableRate),
  "playerImpressionRate": enum (PlayerImpressionRate)
}
فیلدها
videoIab

enum ( VideoIAB )

Target web inventory to maximize IAB viewable rate.

videoViewableRate

enum ( VideoViewableRate )

Target web inventory to maximize fully viewable rate.

playerImpressionRate

enum ( PlayerImpressionRate )

Target inventory to maximize impressions with 400x300 or greater player size.

VideoIAB

Possible options of IAB viewable rate.

انوم‌ها
VIDEO_IAB_UNSPECIFIED This enum is only a placeholder and it doesn't specify any video IAB viewable rate options.
IAB_VIEWABILITY_80_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 80% or higher.
IAB_VIEWABILITY_75_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 75% or higher.
IAB_VIEWABILITY_70_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 70% or higher.
IAB_VIEWABILITY_65_PERCENT_HIHGER Target web and app inventory to maximize IAB viewable rate 65% or higher.
IAB_VIEWABILITY_60_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 60% or higher.
IAB_VIEWABILITY_55_PERCENT_HIHGER Target web and app inventory to maximize IAB viewable rate 55% or higher.
IAB_VIEWABILITY_50_PERCENT_HIGHER Target web and app inventory to maximize IAB viewable rate 50% or higher.
IAB_VIEWABILITY_40_PERCENT_HIHGER Target web and app inventory to maximize IAB viewable rate 40% or higher.
IAB_VIEWABILITY_30_PERCENT_HIHGER Target web and app inventory to maximize IAB viewable rate 30% or higher.

VideoViewableRate

Possible options of fully viewable rate.

انوم‌ها
VIDEO_VIEWABLE_RATE_UNSPECIFIED This enum is only a placeholder and it doesn't specify any video viewable rate options.
VIEWED_PERFORMANCE_40_PERCENT_HIGHER Target web inventory to maximize fully viewable rate 40% or higher.
VIEWED_PERFORMANCE_35_PERCENT_HIGHER Target web inventory to maximize fully viewable rate 35% or higher.
VIEWED_PERFORMANCE_30_PERCENT_HIGHER Target web inventory to maximize fully viewable rate 30% or higher.
VIEWED_PERFORMANCE_25_PERCENT_HIGHER Target web inventory to maximize fully viewable rate 25% or higher.
VIEWED_PERFORMANCE_20_PERCENT_HIGHER Target web inventory to maximize fully viewable rate 20% or higher.
VIEWED_PERFORMANCE_10_PERCENT_HIGHER Target web inventory to maximize fully viewable rate 10% or higher.

PlayerImpressionRate

Possible options of impressions.

انوم‌ها
PLAYER_SIZE_400X300_UNSPECIFIED This enum is only a placeholder and it doesn't specify any impressions options.
PLAYER_SIZE_400X300_95 Sites with 95%+ of impressions.
PLAYER_SIZE_400X300_70 Sites with 70%+ of impressions.
PLAYER_SIZE_400X300_25 Sites with 25%+ of impressions.
PLAYER_SIZE_400X300_5 Sites with 5%+ of impressions.

FraudInvalidTraffic

DoubleVerify Fraud & Invalid Traffic settings.

نمایش JSON 
{
  "avoidedFraudOption": enum (FraudOption),
  "avoidInsufficientOption": boolean
}
فیلدها
avoidedFraudOption

enum ( FraudOption )

Avoid Sites and Apps with historical Fraud & IVT.

avoidInsufficientOption

boolean

Insufficient Historical Fraud & IVT Stats.

FraudOption

Possible options of historical Fraud & IVT rate.

انوم‌ها
FRAUD_UNSPECIFIED This enum is only a placeholder and it doesn't specify any fraud and invalid traffic options.
AD_IMPRESSION_FRAUD_100 100% Fraud & IVT.
AD_IMPRESSION_FRAUD_50 50% or Higher Fraud & IVT.
AD_IMPRESSION_FRAUD_25 25% or Higher Fraud & IVT.
AD_IMPRESSION_FRAUD_10 10% or Higher Fraud & IVT.
AD_IMPRESSION_FRAUD_8 8% or Higher Fraud & IVT.
AD_IMPRESSION_FRAUD_6 6% or Higher Fraud & IVT.
AD_IMPRESSION_FRAUD_4 4% or Higher Fraud & IVT.
AD_IMPRESSION_FRAUD_2 2% or Higher Fraud & IVT.

IntegralAdScience

Details of Integral Ad Science settings.

نمایش 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 )

True advertising quality (applicable to Display line items only).

excludeUnrateable

boolean

Brand Safety - Unrateable .

excludedAdultRisk

enum ( Adult )

Brand Safety - Adult content .

excludedAlcoholRisk

enum ( Alcohol )

Brand Safety - Alcohol .

excludedIllegalDownloadsRisk

enum ( IllegalDownloads )

Brand Safety - Illegal downloads .

excludedDrugsRisk

enum ( Drugs )

Brand Safety - Drugs .

excludedHateSpeechRisk

enum ( HateSpeech )

Brand Safety - Hate speech .

excludedOffensiveLanguageRisk

enum ( OffensiveLanguage )

Brand Safety - Offensive language .

excludedViolenceRisk

enum ( Violence )

Brand Safety - Violence .

excludedGamblingRisk

enum ( Gambling )

Brand Safety - Gambling .

excludedAdFraudRisk

enum ( AdFraudPrevention )

Ad Fraud settings.

displayViewability

enum ( DisplayViewability )

Display Viewability section (applicable to display line items only).

videoViewability

enum ( VideoViewability )

Video Viewability Section (applicable to video line items only).

customSegmentId[]

string ( int64 format)

The custom segment ID provided by Integral Ad Science. The ID must be between 1000001 and 1999999 or 3000001 and 3999999 , inclusive.

qualitySyncCustomSegmentId[]

string ( int64 format)

Optional. The quality sync custom segment ID provided by Integral Ad Science. The ID must be between 3000000 and 4999999 , inclusive.

TRAQScore

Possible Integral Ad Science TRAQ (true advertising quality) score ranges.

انوم‌ها
TRAQ_UNSPECIFIED This enum is only a placeholder and it doesn't specify any true advertising quality scores.
TRAQ_250 TRAQ score 250-1000.
TRAQ_500 TRAQ score 500-1000.
TRAQ_600 TRAQ score 600-1000.
TRAQ_700 TRAQ score 700-1000.
TRAQ_750 TRAQ score 750-1000.
TRAQ_875 TRAQ score 875-1000.
TRAQ_1000 TRAQ score 1000.

بزرگسال

Possible Integral Ad Science Adult options.

انوم‌ها
ADULT_UNSPECIFIED This enum is only a placeholder and it doesn't specify any adult options.
ADULT_HR Adult - Exclude High Risk.
ADULT_HMR Adult - Exclude High and Moderate Risk.

الکل

Possible Integral Ad Science Alcohol options.

انوم‌ها
ALCOHOL_UNSPECIFIED This enum is only a placeholder and it doesn't specify any alcohol options.
ALCOHOL_HR Alcohol - Exclude High Risk.
ALCOHOL_HMR Alcohol - Exclude High and Moderate Risk.

IllegalDownloads

Possible Integral Ad Science Illegal downloads options.

انوم‌ها
ILLEGAL_DOWNLOADS_UNSPECIFIED This enum is only a placeholder and it doesn't specify any illegal downloads options.
ILLEGAL_DOWNLOADS_HR Illegal Downloads - Exclude High Risk.
ILLEGAL_DOWNLOADS_HMR Illegal Downloads - Exclude High and Moderate Risk.

مواد مخدر

Possible Integral Ad Science Drugs options.

انوم‌ها
DRUGS_UNSPECIFIED This enum is only a placeholder and it doesn't specify any drugs options.
DRUGS_HR Drugs - Exclude High Risk.
DRUGS_HMR Drugs - Exclude High and Moderate Risk.

HateSpeech

Possible Integral Ad Science Hate speech options.

انوم‌ها
HATE_SPEECH_UNSPECIFIED This enum is only a placeholder and it doesn't specify any hate speech options.
HATE_SPEECH_HR Hate Speech - Exclude High Risk.
HATE_SPEECH_HMR Hate Speech - Exclude High and Moderate Risk.

OffensiveLanguage

Possible Integral Ad Science Offensive language options.

انوم‌ها
OFFENSIVE_LANGUAGE_UNSPECIFIED This enum is only a placeholder and it doesn't specify any language options.
OFFENSIVE_LANGUAGE_HR Offensive Language - Exclude High Risk.
OFFENSIVE_LANGUAGE_HMR Offensive Language - Exclude High and Moderate Risk.

خشونت

Possible Integral Ad Science Violence options.

انوم‌ها
VIOLENCE_UNSPECIFIED This enum is only a placeholder and it doesn't specify any violence options.
VIOLENCE_HR Violence - Exclude High Risk.
VIOLENCE_HMR Violence - Exclude High and Moderate Risk.

قمار

Possible Integral Ad Science Gambling options.

انوم‌ها
GAMBLING_UNSPECIFIED This enum is only a placeholder and it doesn't specify any gambling options.
GAMBLING_HR Gambling - Exclude High Risk.
GAMBLING_HMR Gambling - Exclude High and Moderate Risk.

AdFraudPrevention

Possible Integral Ad Science Ad fraud prevention options.

انوم‌ها
SUSPICIOUS_ACTIVITY_UNSPECIFIED This enum is only a placeholder and it doesn't specify any ad fraud prevention options.
SUSPICIOUS_ACTIVITY_HR Ad Fraud - Exclude High Risk.
SUSPICIOUS_ACTIVITY_HMR Ad Fraud - Exclude High and Moderate Risk.
SUSPICIOUS_ACTIVITY_FD Ad Fraud - Exclude Fraudulent Device.

DisplayViewability

Possible Integral Ad Science Display viewability options.

انوم‌ها
PERFORMANCE_VIEWABILITY_UNSPECIFIED This enum is only a placeholder and it doesn't specify any display viewability options.
PERFORMANCE_VIEWABILITY_40 Target 40% Viewability or Higher.
PERFORMANCE_VIEWABILITY_50 Target 50% Viewability or Higher.
PERFORMANCE_VIEWABILITY_60 Target 60% Viewability or Higher.
PERFORMANCE_VIEWABILITY_70 Target 70% Viewability or Higher.

VideoViewability

Possible Integral Ad Science Video viewability options.

انوم‌ها
VIDEO_VIEWABILITY_UNSPECIFIED This enum is only a placeholder and it doesn't specify any video viewability options.
VIDEO_VIEWABILITY_40 40%+ in view (IAB video viewability standard).
VIDEO_VIEWABILITY_50 50%+ in view (IAB video viewability standard).
VIDEO_VIEWABILITY_60 60%+ in view (IAB video viewability standard).
VIDEO_VIEWABILITY_70 70%+ in view (IAB video viewability standard).

PoiAssignedTargetingOptionDetails

Details for assigned POI targeting option. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_POI .

نمایش JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "latitude": number,
  "longitude": number,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
فیلدها
displayName

string

Output only. The display name of a POI, eg "Times Square", "Space Needle", followed by its full address if available.

targetingOptionId

string

Required. The targetingOptionId of a TargetingOption of type TARGETING_TYPE_POI .

Accepted POI targeting option IDs can be retrieved using targetingTypes.targetingOptions.search .

If targeting a specific latitude/longitude coordinate removed from an address or POI name, you can generate the necessary targeting option ID by rounding the desired coordinate values to the 6th decimal place, removing the decimals, and concatenating the string values separated by a semicolon. For example, you can target the latitude/longitude pair of 40.7414691, -74.003387 using the targeting option ID "40741469;-74003387". Upon creation, this field value will be updated to append a semicolon and alphanumerical hash value if only latitude/longitude coordinates are provided.

latitude

number

Output only. Latitude of the POI rounding to 6th decimal place.

longitude

number

Output only. Longitude of the POI rounding to 6th decimal place.

proximityRadiusAmount

number

Required. The radius of the area around the POI that will be targeted. The units of the radius are specified by proximityRadiusUnit . Must be 1 to 800 if unit is DISTANCE_UNIT_KILOMETERS and 1 to 500 if unit is DISTANCE_UNIT_MILES .

proximityRadiusUnit

enum ( DistanceUnit )

Required. The unit of distance by which the targeting radius is measured.

DistanceUnit

Possible distance unit options.

انوم‌ها
DISTANCE_UNIT_UNSPECIFIED Type value is not specified or is unknown in this version.
DISTANCE_UNIT_MILES Miles.
DISTANCE_UNIT_KILOMETERS Kilometers.

BusinessChainAssignedTargetingOptionDetails

Details for assigned Business chain targeting option. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_BUSINESS_CHAIN .

نمایش JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
فیلدها
displayName

string

Output only. The display name of a business chain, eg "KFC", "Chase Bank".

targetingOptionId

string

Required. The targetingOptionId of a TargetingOption of type TARGETING_TYPE_BUSINESS_CHAIN .

Accepted business chain targeting option IDs can be retrieved using SearchTargetingOptions .

proximityRadiusAmount

number

Required. The radius of the area around the business chain that will be targeted. The units of the radius are specified by proximityRadiusUnit . Must be 1 to 800 if unit is DISTANCE_UNIT_KILOMETERS and 1 to 500 if unit is DISTANCE_UNIT_MILES . The minimum increment for both cases is 0.1. Inputs will be rounded to the nearest acceptable value if it is too granular, eg 15.57 will become 15.6.

proximityRadiusUnit

enum ( DistanceUnit )

Required. The unit of distance by which the targeting radius is measured.

ContentDurationAssignedTargetingOptionDetails

Details for content duration assigned targeting option. This will be populated in the contentDurationDetails field when targetingType is TARGETING_TYPE_CONTENT_DURATION . Explicitly targeting all options is not supported. Remove all content duration targeting options to achieve this effect.

نمایش JSON 
{
  "targetingOptionId": string,
  "contentDuration": enum (ContentDuration)
}
فیلدها
targetingOptionId

string

Required. The targetingOptionId field when targetingType is TARGETING_TYPE_CONTENT_DURATION .

contentDuration

enum ( ContentDuration )

Output only. The content duration.

ContentStreamTypeAssignedTargetingOptionDetails

Details for content stream type assigned targeting option. This will be populated in the contentStreamTypeDetails field when targetingType is TARGETING_TYPE_CONTENT_STREAM_TYPE . Explicitly targeting all options is not supported. Remove all content stream type targeting options to achieve this effect.

نمایش JSON 
{
  "targetingOptionId": string,
  "contentStreamType": enum (ContentStreamType)
}
فیلدها
targetingOptionId

string

Required. The targetingOptionId field when targetingType is TARGETING_TYPE_CONTENT_STREAM_TYPE .

contentStreamType

enum ( ContentStreamType )

Output only. The content stream type.

NativeContentPositionAssignedTargetingOptionDetails

Details for native content position assigned targeting option. This will be populated in the nativeContentPositionDetails field when targetingType is TARGETING_TYPE_NATIVE_CONTENT_POSITION . Explicitly targeting all options is not supported. Remove all native content position targeting options to achieve this effect.

نمایش JSON 
{
  "contentPosition": enum (NativeContentPosition)
}
فیلدها
contentPosition

enum ( NativeContentPosition )

Required. The content position.

OmidAssignedTargetingOptionDetails

Represents a targetable Open Measurement enabled inventory type. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_OMID .

نمایش JSON 
{
  "omid": enum (Omid)
}
فیلدها
omid

enum ( Omid )

Required. The type of Open Measurement enabled inventory.

AudioContentTypeAssignedTargetingOptionDetails

Details for audio content type assigned targeting option. This will be populated in the audioContentTypeDetails field when targetingType is TARGETING_TYPE_AUDIO_CONTENT_TYPE . Explicitly targeting all options is not supported. Remove all audio content type targeting options to achieve this effect.

نمایش JSON 
{
  "audioContentType": enum (AudioContentType)
}
فیلدها
audioContentType

enum ( AudioContentType )

Required. The audio content type.

ContentGenreAssignedTargetingOptionDetails

Details for content genre assigned targeting option. This will be populated in the contentGenreDetails field when targetingType is TARGETING_TYPE_CONTENT_GENRE . Explicitly targeting all options is not supported. Remove all content genre targeting options to achieve this effect.

نمایش JSON 
{
  "targetingOptionId": string,
  "displayName": string,
  "negative": boolean
}
فیلدها
targetingOptionId

string

Required. The targetingOptionId field when targetingType is TARGETING_TYPE_CONTENT_GENRE .

displayName

string

Output only. The display name of the content genre.

negative

boolean

Indicates if this option is being negatively targeted.

YoutubeVideoAssignedTargetingOptionDetails

Details for YouTube video assigned targeting option. This will be populated in the youtubeVideoDetails field when targetingType is TARGETING_TYPE_YOUTUBE_VIDEO .

نمایش JSON 
{
  "videoId": string,
  "negative": boolean
}
فیلدها
videoId

string

YouTube video id as it appears on the YouTube watch page.

negative

boolean

Indicates if this option is being negatively targeted.

YoutubeChannelAssignedTargetingOptionDetails

Details for YouTube channel assigned targeting option. This will be populated in the youtubeChannelDetails field when targetingType is TARGETING_TYPE_YOUTUBE_CHANNEL .

نمایش JSON 
{
  "channelId": string,
  "negative": boolean
}
فیلدها
channelId

string

The YouTube uploader channel id or the channel code of a YouTube channel.

negative

boolean

Indicates if this option is being negatively targeted.

SessionPositionAssignedTargetingOptionDetails

Details for session position assigned targeting option. This will be populated in the sessionPositionDetails field when targetingType is TARGETING_TYPE_SESSION_POSITION .

نمایش JSON 
{
  "sessionPosition": enum (SessionPosition)
}
فیلدها
sessionPosition

enum ( SessionPosition )

The position where the ad will show in a session.

SessionPosition

Possible positions in a session.

انوم‌ها
SESSION_POSITION_UNSPECIFIED This is a placeholder, does not indicate any positions.
SESSION_POSITION_FIRST_IMPRESSION The first impression of the session.

روش‌ها

get

 Gets a single targeting option assigned to an ad group.

list

 Lists the targeting options assigned to an ad group.