REST Resource: advertisers.adGroups.targetingTypes.assignedTargetingOptions

منبع: AssignedTargetingOption

یک گزینه هدف‌یابی اختصاص‌یافته، که وضعیت یک گزینه هدف‌گیری را برای نهادی با تنظیمات هدف‌یابی تعریف می‌کند.

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

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

string

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

assignedTargetingOptionId

string

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

assignedTargetingOptionIdAlias

string

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

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

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

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

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum ( TargetingType )

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

inheritance

enum ( Inheritance )

فقط خروجی وضعیت وراثت گزینه هدف گذاری اختصاص داده شده.

details فیلد اتحادیه اطلاعات دقیق در مورد گزینه هدف گذاری که اختصاص داده شده است. فقط یک فیلد با جزئیات ممکن است پر شود و باید با targeting_type مطابقت داشته باشد. details فقط می تواند یکی از موارد زیر باشد:
channelDetails

object ( ChannelAssignedTargetingOptionDetails )

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

appCategoryDetails

object ( AppCategoryAssignedTargetingOptionDetails )

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

appDetails

object ( AppAssignedTargetingOptionDetails )

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

urlDetails

object ( UrlAssignedTargetingOptionDetails )

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

dayAndTimeDetails

object ( DayAndTimeAssignedTargetingOptionDetails )

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

ageRangeDetails

object ( AgeRangeAssignedTargetingOptionDetails )

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

regionalLocationListDetails

object ( RegionalLocationListAssignedTargetingOptionDetails )

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

proximityLocationListDetails

object ( ProximityLocationListAssignedTargetingOptionDetails )

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

genderDetails

object ( GenderAssignedTargetingOptionDetails )

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

videoPlayerSizeDetails

object ( VideoPlayerSizeAssignedTargetingOptionDetails )

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

userRewardedContentDetails

object ( UserRewardedContentAssignedTargetingOptionDetails )

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

parentalStatusDetails

object ( ParentalStatusAssignedTargetingOptionDetails )

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

contentInstreamPositionDetails

object ( ContentInstreamPositionAssignedTargetingOptionDetails )

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

contentOutstreamPositionDetails

object ( ContentOutstreamPositionAssignedTargetingOptionDetails )

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

deviceTypeDetails

object ( DeviceTypeAssignedTargetingOptionDetails )

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

audienceGroupDetails

object ( AudienceGroupAssignedTargetingOptionDetails )

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

browserDetails

object ( BrowserAssignedTargetingOptionDetails )

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

householdIncomeDetails

object ( HouseholdIncomeAssignedTargetingOptionDetails )

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

onScreenPositionDetails

object ( OnScreenPositionAssignedTargetingOptionDetails )

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

carrierAndIspDetails

object ( CarrierAndIspAssignedTargetingOptionDetails )

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

keywordDetails

object ( KeywordAssignedTargetingOptionDetails )

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

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

negativeKeywordListDetails

object ( NegativeKeywordListAssignedTargetingOptionDetails )

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

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

operatingSystemDetails

object ( OperatingSystemAssignedTargetingOptionDetails )

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

deviceMakeModelDetails

object ( DeviceMakeModelAssignedTargetingOptionDetails )

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

environmentDetails

object ( EnvironmentAssignedTargetingOptionDetails )

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

inventorySourceDetails

object ( InventorySourceAssignedTargetingOptionDetails )

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

categoryDetails

object ( CategoryAssignedTargetingOptionDetails )

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

هدف قرار دادن یک دسته، زیرمجموعه های آن را نیز هدف قرار می دهد. اگر یک دسته از هدف گذاری حذف شود و یک زیرمجموعه گنجانده شود، حذف اولویت دارد.

viewabilityDetails

object ( ViewabilityAssignedTargetingOptionDetails )

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

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

authorizedSellerStatusDetails

object ( AuthorizedSellerStatusAssignedTargetingOptionDetails )

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

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

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

languageDetails

object ( LanguageAssignedTargetingOptionDetails )

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

geoRegionDetails

object ( GeoRegionAssignedTargetingOptionDetails )

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

inventorySourceGroupDetails

object ( InventorySourceGroupAssignedTargetingOptionDetails )

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

digitalContentLabelExclusionDetails

object ( DigitalContentLabelAssignedTargetingOptionDetails )

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

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

sensitiveCategoryExclusionDetails

object ( SensitiveCategoryAssignedTargetingOptionDetails )

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

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

contentThemeExclusionDetails

object ( ContentThemeAssignedTargetingOptionDetails )

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

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

exchangeDetails

object ( ExchangeAssignedTargetingOptionDetails )

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

subExchangeDetails

object ( SubExchangeAssignedTargetingOptionDetails )

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

thirdPartyVerifierDetails

object ( ThirdPartyVerifierAssignedTargetingOptionDetails )

جزئیات تأیید شخص ثالث. زمانی که targetingType TARGETING_TYPE_THIRD_PARTY_VERIFIER باشد، این فیلد پر می شود.

poiDetails

object ( PoiAssignedTargetingOptionDetails )

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

ارث

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

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

ChannelAssignedTargetingOptionDetails

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

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

string ( int64 format)

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

negative

boolean

نشان می دهد که آیا این گزینه به طور منفی مورد هدف قرار گرفته است. برای گزینه هدف گذاری تعیین شده در سطح تبلیغ کننده، این قسمت باید درست باشد.

AppCategoryAssignedTargetingOptionDetails

جزئیات برای گزینه هدف گذاری دسته برنامه اختصاص داده شده. زمانی که targetingType TARGETING_TYPE_APP_CATEGORY باشد، در قسمت appCategoryDetails یک AssignedTargetingOption پر می شود.

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

string

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

targetingOptionId

string

مورد نیاز. فیلد targetingOptionId هنگام targetingType TARGETING_TYPE_APP_CATEGORY است.

negative

boolean

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

AppAssignedTargetingOptionDetails

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

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

string

مورد نیاز. شناسه برنامه

برنامه فروشگاه Play Android از شناسه بسته، برای مثال com.google.android.gm استفاده می‌کند. شناسه برنامه فروشگاه App اپل از رشته 9 رقمی استفاده می کند، به عنوان مثال 422689480 .

displayName

string

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

negative

boolean

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

appPlatform

enum ( AppPlatform )

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

AppPlatform

گزینه های احتمالی هدف گذاری پلت فرم برنامه

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

UrlAssignedTargetingOptionDetails

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

نمایندگی 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 (1 ساعت قبل از پایان روز) باشد.

endHour

integer

مورد نیاز. ساعت پایانی برای هدف‌گیری روز و زمان. باید بین 1 (1 ساعت پس از شروع روز) و 24 (پایان روز) باشد.

timeZoneResolution

enum ( TimeZoneResolution )

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

روز هفته

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

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

TimeZoneResolution

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

Enums
TIME_ZONE_RESOLUTION_UNSPECIFIED وضوح منطقه زمانی یا نامشخص یا ناشناخته است.
TIME_ZONE_RESOLUTION_END_USER زمان‌ها در منطقه زمانی کاربری که آگهی را دیده است مشخص می‌شود.
TIME_ZONE_RESOLUTION_ADVERTISER زمان‌ها در منطقه زمانی تبلیغ‌کننده‌ای که آگهی را ارائه کرده است، تعیین می‌شود.

AgeRangeAssignedTargetingOptionDetails

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

نمایندگی JSON
{
  "ageRange": enum (AgeRange)
}
فیلدها
ageRange

enum ( AgeRange )

مورد نیاز. محدوده سنی مخاطب ما فقط از هدف قرار دادن محدوده سنی مستمر مخاطبان پشتیبانی می کنیم. بنابراین، محدوده سنی ارائه شده در این زمینه می تواند 1) صرفاً هدفمند باشد، یا، 2) بخشی از یک محدوده سنی پیوسته بزرگتر باشد. با هدف قرار دادن مخاطبان با سن ناشناخته، می توان دامنه هدف گذاری مستمر محدوده سنی را افزایش داد.

RegionalLocationListAssignedTargetingOptionDetails

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

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

string ( int64 format)

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

negative

boolean

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

ProximityLocationListAssignedTargetingOptionDetails

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

نمایندگی JSON
{
  "proximityLocationListId": string,
  "proximityRadius": number,
  "proximityRadiusUnit": enum (ProximityRadiusUnit)
}
فیلدها
proximityLocationListId

string ( int64 format)

مورد نیاز. شناسه فهرست مکان مجاورت. باید به قسمت locationListId یک منبع LocationList که نوع آن TARGETING_LOCATION_TYPE_PROXIMITY است مراجعه کند.

proximityRadius

number

مورد نیاز. شعاع در واحدهای فاصله تنظیم شده در proximityRadiusUnit بیان می شود. این نشان دهنده اندازه منطقه اطراف یک مکان انتخابی است که هدف قرار خواهد گرفت. شعاع باید بین 1 تا 500 مایل یا 800 کیلومتر باشد.

proximityRadiusUnit

enum ( ProximityRadiusUnit )

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

واحد رادیوس نزدیکی

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

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

Details GenderAssignedTargetingOption

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

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

enum ( Gender )

مورد نیاز. جنسیت مخاطب.

VideoPlayerSizeAssignedTargetingOptionDetails

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

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

enum ( VideoPlayerSize )

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

UserRewardedContentAssignedTargetingOptionDetails

جزئیات گزینه هدف گذاری محتوای پاداش داده شده توسط کاربر. زمانی که targetingType TARGETING_TYPE_USER_REWARDED_CONTENT باشد، در قسمت userRewardedContentDetails پر می شود.

نمایندگی JSON
{
  "targetingOptionId": string,
  "userRewardedContent": enum (UserRewardedContent)
}
فیلدها
targetingOptionId

string

مورد نیاز. فیلد targetingOptionId هنگام targetingType TARGETING_TYPE_USER_REWARDED_CONTENT است.

userRewardedContent

enum ( UserRewardedContent )

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

ParentalStatusAssignedTargetingOptionDetails

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

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

enum ( ParentalStatus )

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

ContentInstreamPositionAssignedTargetingOptionDetails

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

نمایندگی 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 باشد، این تنظیم توسط مورد خط جدید به ارث می رسد.

نوع تبلیغ

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

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

ContentOutstreamPositionAssignedTargetingOptionDetails

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

نمایندگی 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 باشد، این تنظیم توسط مورد خط جدید به ارث می رسد.

DeviceTypeAssignedTargetingOptionDetails

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

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

enum ( DeviceType )

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

youtubeAndPartnersBidMultiplier

number

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

برای مثال، اگر قیمت پیشنهادی بدون ضریب 10.0 دلار و ضریب 1.5 برای تبلت باشد، قیمت پیشنهادی حاصل برای تبلت 15 دلار خواهد بود.

فقط برای موارد خط YouTube و Partners قابل اجرا است.

AudienceGroupAssignedTargetingOptionDetails

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

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

object ( GoogleAudienceGroup )

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

includedCustomListGroup

object ( CustomListGroup )

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

includedCombinedAudienceGroup

object ( CombinedAudienceGroup )

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

excludedGoogleAudienceGroup

object ( GoogleAudienceGroup )

اختیاری. شناسه مخاطبان Google گروه مخاطب Google حذف شده است. برای هدف گیری منفی استفاده می شود. مکمل اتحاد این گروه و سایر گروه های مخاطب حذف شده به عنوان یک نقطه تلاقی برای هر هدف گذاری مثبت مخاطب استفاده می شود. فقط شامل مخاطبان Google از نوع Affinity، In-market و برنامه های نصب شده است. همه موارد به طور منطقی "OR" یکدیگر هستند.

includedFirstPartyAndPartnerAudienceGroups[]

object ( FirstPartyAndPartnerAudienceGroup )

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

excludedFirstPartyAndPartnerAudienceGroup

object ( FirstPartyAndPartnerAudienceGroup )

اختیاری. شناسه‌ها و موارد اخیر مخاطبان طرف اول و شریک گروه مخاطبان شخص اول و شریک حذف شده. برای هدف گیری منفی استفاده می شود. مکمل اتحاد این گروه و سایر گروه های مخاطب حذف شده به عنوان یک نقطه تلاقی برای هر هدف گذاری مثبت مخاطب استفاده می شود. همه موارد به طور منطقی "OR" یکدیگر هستند.

GoogleAudienceGroup

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

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

object ( GoogleAudienceTargetingSetting )

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

GoogleAudienceTargetingSetting

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

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

string ( int64 format)

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

CustomListGroup

جزئیات گروه لیست سفارشی. همه تنظیمات هدف گیری لیست سفارشی به طور منطقی "OR" یکدیگر هستند.

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

object ( CustomListTargetingSetting )

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

CustomListTargetingSetting

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

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

string ( int64 format)

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

CombinedAudienceGroup

جزئیات گروه مخاطبان ترکیبی همه تنظیمات ترکیبی هدف گیری مخاطب به طور منطقی "OR" یکدیگر هستند.

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

object ( CombinedAudienceTargetingSetting )

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

CombinedAudienceTargetingSetting

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

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

string ( int64 format)

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

FirstPartyAndPartnerAudienceGroup

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

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

object ( FirstPartyAndPartnerAudienceTargetingSetting )

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

FirstPartyAndPartnerAudienceTargetingSetting

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

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

string ( int64 format)

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

recency

enum ( Recency )

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

تازگی

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

Enums
RECENCY_NO_LIMIT محدودیتی برای تازگی وجود ندارد.
RECENCY_1_MINUTE آخرین زمان 1 دقیقه است.
RECENCY_5_MINUTES آخرین زمان 5 دقیقه است.
RECENCY_10_MINUTES آخرین زمان 10 دقیقه است.
RECENCY_15_MINUTES آخرین زمان 15 دقیقه است.
RECENCY_30_MINUTES آخرین زمان 30 دقیقه است.
RECENCY_1_HOUR آخرین زمان 1 ساعت است.
RECENCY_2_HOURS آخرین 2 ساعت است.
RECENCY_3_HOURS آخرین زمان 3 ساعت است.
RECENCY_6_HOURS آخرین زمان 6 ساعت است.
RECENCY_12_HOURS آخرین ساعت 12 ساعت است.
RECENCY_1_DAY آخرین 1 روز است.
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 روز است.

BrowserAssignedTargetingOptionDetails

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

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

string

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

targetingOptionId

string

مورد نیاز. targetingOptionId یک TargetingOption از نوع TARGETING_TYPE_BROWSER .

negative

boolean

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

HouseholdIncomeAssignedTargetingOptionDetails

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

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

enum ( HouseholdIncome )

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

OnScreenPositionAssignedTargetingOptionDetails

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

نمایندگی 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

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

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

string

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

targetingOptionId

string

مورد نیاز. targetingOptionId یک TargetingOption از نوع TARGETING_TYPE_CARRIER_AND_ISP .

negative

boolean

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

KeywordAssignedTargetingOptionDetails

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

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

string

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

کلمه کلیدی مثبت نمی تواند کلمه توهین آمیز باشد. باید UTF-8 با حداکثر اندازه 255 بایت کدگذاری شود. حداکثر تعداد کاراکترها 80 و حداکثر تعداد کلمات 10 است.

negative

boolean

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

NegativeKeywordListAssignedTargetingOptionDetails

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

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

string ( int64 format)

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

OperatingSystemAssignedTargetingOptionDetails

جزئیات گزینه هدف گذاری سیستم عامل اختصاص داده شده است. زمانی که targetingType TARGETING_TYPE_OPERATING_SYSTEM باشد، در قسمت operatingSystemDetails پر می شود.

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

string

فقط خروجی نام نمایشی سیستم عامل

targetingOptionId

string

مورد نیاز. شناسه گزینه هدف پر شده در قسمت targetingOptionId هنگام targetingType TARGETING_TYPE_OPERATING_SYSTEM است.

negative

boolean

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

DeviceMakeModelAssignedTargetingOptionDetails

جزئیات گزینه هدف گذاری ساخت و مدل دستگاه اختصاص داده شده. زمانی که targetingType TARGETING_TYPE_DEVICE_MAKE_MODEL باشد، در قسمت deviceMakeModelDetails پر می شود.

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

string

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

targetingOptionId

string

مورد نیاز. فیلد targetingOptionId هنگام targetingType TARGETING_TYPE_DEVICE_MAKE_MODEL است.

negative

boolean

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

EnvironmentAssignedTargetingOptionDetails

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

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

enum ( Environment )

مورد نیاز. محیط خدمت.

InventorySourceAssignedTargetingOptionDetails

جزئیات هدف برای منبع موجودی. زمانی که targetingType TARGETING_TYPE_INVENTORY_SOURCE باشد، در قسمت جزئیات یک AssignedTargetingOption پر می شود.

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

string ( int64 format)

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

CategoryAssignedTargetingOptionDetails

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

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

string

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

targetingOptionId

string

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

negative

boolean

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

ViewabilityAssignedTargetingOptionDetails

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

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

enum ( Viewability )

مورد نیاز. درصد قابل مشاهده پیش بینی شده

AuthorizedSellerStatusAssignedTargetingOptionDetails

نشان دهنده وضعیت فروشنده مجاز تعیین شده است. زمانی که targetingType TARGETING_TYPE_AUTHORIZED_SELLER_STATUS باشد، در قسمت جزئیات یک AssignedTargetingOption پر می شود.

اگر منبعی گزینه هدف گذاری اختصاص داده شده به TARGETING_TYPE_AUTHORIZED_SELLER_STATUS را نداشته باشد، از گزینه "فروشندگان و فروشندگان مستقیم مجاز" استفاده می کند.

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

enum ( AuthorizedSellerStatus )

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

targetingOptionId

string

مورد نیاز. targetingOptionId یک TargetingOption از نوع TARGETING_TYPE_AUTHORIZED_SELLER_STATUS .

LanguageAssignedTargetingOptionDetails

جزئیات مربوط به گزینه هدف گذاری زبان اختصاص داده شده. این امر در قسمت جزئیات یک اختصاص داده شده در هنگام targetingType TARGETING_TYPE_LANGUAGE جمع می شود.

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

string

فقط خروجی نام نمایش زبان (به عنوان مثال ، "فرانسوی").

targetingOptionId

string

مورد نیاز. targetingOptionId از یک TargetingOption نوع هدف TARGETING_TYPE_LANGUAGE .

negative

boolean

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

georegionassignedtargetingoptiondetails

جزئیات مربوط به گزینه هدف گذاری منطقه جغرافیایی اختصاص یافته. این در قسمت جزئیات یک اختصاص داده شده در هنگام targetingType TARGETING_TYPE_GEO_REGION جمع می شود.

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

string

فقط خروجی نام نمایش منطقه جغرافیایی (به عنوان مثال ، "انتاریو ، کانادا").

targetingOptionId

string

مورد نیاز. targetingOptionId از یک TargetingOption نوع Type TARGETING_TYPE_GEO_REGION .

geoRegionType

enum ( GeoRegionType )

فقط خروجی نوع هدف قرار دادن منطقه جغرافیایی.

negative

boolean

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

موجودی

هدف قرار دادن جزئیات برای گروه منبع موجودی. این امر در قسمت جزئیات یک اختصاصی اختصاص داده شده هنگامی که targetingType TARGETING_TYPE_INVENTORY_SOURCE_GROUP است ، جمع می شود.

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

string ( int64 format)

مورد نیاز. شناسه گروه منبع موجودی. باید به قسمت inventorySourceGroupId از یک منبع موجودی InventorySourceGroup مراجعه کنید.

DigitalContentLabelassignedTargetingOptionDetails

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

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

enum ( ContentRatingTier )

مورد نیاز. نام نمایشگر رتبه بندی برچسب محتوای دیجیتال ردیف است که حذف می شود.

SensitiveEcategorAssignedTargetingOptionDetails

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

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

enum ( SensitiveCategory )

مورد نیاز. enum برای محتوای مقوله حساس DV360 طبقه بندی شده برای حذف.

ContentEmeassignedTartegingOptionDetails

هدف قرار دادن جزئیات برای موضوع محتوا. این امر در قسمت جزئیات یک اختصاصی اختصاص داده شده هنگامی که targetingType TARGETING_TYPE_CONTENT_THEME_EXCLUSION است ، جمع می شود.

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

string

مورد نیاز. شناسه موضوع محتوا که مستثنی است.

contentTheme

enum ( ContentTheme )

فقط خروجی یک enum برای طبقه بندی کننده موضوع محتوای DV360.

excludedContentTheme

enum ( ContentTheme )

مورد نیاز. enum برای موضوع محتوای DV360 طبقه بندی شده است.

ExchangeAseSigeDtartegingOptionDetails

جزئیات مربوط به گزینه هدف گذاری مبادله اختصاص یافته. این امر در قسمت جزئیات یک اختصاص داده شده در هنگام targetingType TARGETING_TYPE_EXCHANGE جمع می شود.

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

enum ( Exchange )

مورد نیاز. ارزش enum برای مبادله.

SubxchangeAssigeDtargetingOptionDetails

جزئیات مربوط به گزینه هدف گذاری فرعی اختصاص داده شده. این امر در قسمت جزئیات یک اختصاص داده شده در هنگام targetingType TARGETING_TYPE_SUB_EXCHANGE جمع می شود.

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

string

مورد نیاز. targetingOptionId از TargetingOption نوع Type TARGETING_TYPE_SUB_EXCHANGE .

سوم PartyverifierSignedTargetingOptionDetails

جزئیات گزینه هدف گذاری شخص ثالث اختصاص داده شده است. این در قسمت جزئیات یک اختصاص داده شده در هنگام targetingType TARGETING_TYPE_THIRD_PARTY_VERIFIER جمع می شود.

نمایندگی JSON
{

  // Union field verifier can be only one of the following:
  "adloox": {
    object (Adloox)
  },
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  }
  // End of list of possible types for union field verifier.
}
فیلدها
verifier میدان اتحادیه. می تواند یکی از تأیید کننده های شخص ثالث را برای اجرای آستانه ایمنی برند برای برداشت ها هدف قرار دهد. verifier می تواند تنها یکی از موارد زیر باشد:
adloox

object ( Adloox )

تأیید برند شخص ثالث - Scope3 (که قبلاً به عنوان Adloox شناخته می شد).

doubleVerify

object ( DoubleVerify )

تأیید برند شخص ثالث - DoubleVerify.

integralAdScience

object ( IntegralAdScience )

تأیید برند شخص ثالث - علم تبلیغات انتگرال.

عیاشی

جزئیات Scope3 (که قبلاً به عنوان Adloox شناخته می شد) تنظیمات ایمنی برند.

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

enum ( AdlooxCategory )

دسته 3 دسته برای حذف.

excludedFraudIvtMfaCategories[]

enum ( FraudIvtMfaCategory )

اختیاری. کلاهبرداری SCOPE3 IVT دسته های MFA برای حذف.

adultExplicitSexualContent

enum ( GarmRiskExclusion )

اختیاری. ریسک محتوای جنسی بزرگسالان و صریح ، از بین می رود .

crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent

enum ( GarmRiskExclusion )

اختیاری. جنایات و اعمال مضر محتوا محدوده ریسک را از بین می برد.

armsAmmunitionContent

enum ( GarmRiskExclusion )

اختیاری. تعداد بازوها و مهمات ریسک خطرناک است.

deathInjuryMilitaryConflictContent

enum ( GarmRiskExclusion )

اختیاری. مرگ ، جراحات یا درگیری های نظامی ریسک خطرناک است.

debatedSensitiveSocialIssueContent

enum ( GarmRiskExclusion )

اختیاری. بحث و گفتگو در مورد محتوای حساسیت اجتماعی حساس ، ریسک ریسک را برای حذف مطرح می کند.

illegalDrugsTobaccoEcigarettesVapingAlcoholContent

enum ( GarmRiskExclusion )

اختیاری. مواد مخدر غیرقانونی/محتوای الکل در معرض خطر است.

onlinePiracyContent

enum ( GarmRiskExclusion )

اختیاری. محتوای دزدی دریایی آنلاین محدوده خطر GARM است.

hateSpeechActsAggressionContent

enum ( GarmRiskExclusion )

اختیاری. گفتار نفرت و اعمال محتوای پرخاشگری ، ریسک خطرناک است.

obscenityProfanityContent

enum ( GarmRiskExclusion )

اختیاری. ناعادلانه و محتوای کراهت ریسک GARM متغیر است.

spamHarmfulContent

enum ( GarmRiskExclusion )

اختیاری. هرزنامه یا محتوای مضر ریسک GARM محدود به محرومیت است.

terrorismContent

enum ( GarmRiskExclusion )

اختیاری. ریسک محتوای تروریسم محدود به محرومیت است.

misinformationContent

enum ( GarmRiskExclusion )

اختیاری. محتوای اطلاعات نادرست ریسک GARM محدود به محرومیت است.

displayIabViewability

enum ( DisplayIabViewability )

اختیاری. آستانه دید IAB برای تبلیغات نمایش.

videoIabViewability

enum ( VideoIabViewability )

اختیاری. آستانه دید IAB برای تبلیغات ویدیویی.

دسته بندی

Scope3 موجود (قبلاً به عنوان Adloox شناخته می شد).

Enums
ADLOOX_UNSPECIFIED مقدار پیش فرض هنگامی که یک دسته Scope3 مشخص نشده است یا در این نسخه ناشناخته است.
ADULT_CONTENT_HARD محتوای بزرگسالان (سخت).
ADULT_CONTENT_SOFT محتوای بزرگسالان (نرم).
ILLEGAL_CONTENT محتوای غیرقانونی
BORDERLINE_CONTENT محتوای مرزی.
DISCRIMINATORY_CONTENT محتوای تبعیض آمیز.
VIOLENT_CONTENT_WEAPONS محتوای و سلاح های خشونت آمیز.
LOW_VIEWABILITY_DOMAINS دامنه های دید کم.
FRAUD تقلب

دسته بندی کلاهبرداری

SCOPE3 موجود (که قبلاً به عنوان Adloox شناخته می شد) کلاهبرداری ، IVT ، دسته MFA.

Enums
FRAUD_IVT_MFA_CATEGORY_UNSPECIFIED مقدار پیش فرض هنگامی که یک کلاهبرداری Scope3 ، IVT ، دسته MFA مشخص نشده است یا در این نسخه ناشناخته است.
FRAUD_IVT_MFA کلاهبرداری ، IVT ، MFA.

گرمریسکسیوژن

گزینه های محرومیت سطح ریسک GARM موجود است.

Enums
GARM_RISK_EXCLUSION_UNSPECIFIED این enum فقط یک مکان نگهدارنده است و هیچ گزینه محرومیت از خطر GARM را مشخص نمی کند.
GARM_RISK_EXCLUSION_FLOOR خطر کف را حذف کنید.
GARM_RISK_EXCLUSION_HIGH خطر بالا و کف را حذف کنید.
GARM_RISK_EXCLUSION_MEDIUM خطر متوسط ​​، زیاد و کف را حذف کنید.
GARM_RISK_EXCLUSION_LOW تمام سطوح خطر (کم ، متوسط ​​، زیاد و کف) را حذف کنید.

قابلیت نمایش داده می شود

Scope3 موجود (که قبلاً به عنوان Adloox شناخته می شد) آستانه قابلیت مشاهده IAB.

Enums
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).

قابلیت مشاهده ویدیویی

SCOPE3 موجود (که قبلاً به عنوان Adloox شناخته می شد) آستانه قابلیت مشاهده ویدیویی IAB.

Enums
VIDEO_IAB_VIEWABILITY_UNSPECIFIED مقدار پیش فرض در هنگام مشخص نشده یا در این نسخه ناشناخته است.
VIDEO_IAB_VIEWABILITY_10 10 ٪+ از نظر (استاندارد مشاهده ویدیوی IAB).
VIDEO_IAB_VIEWABILITY_20 20 ٪+ از نظر (استاندارد مشاهده ویدیوی IAB).
VIDEO_IAB_VIEWABILITY_35 35 ٪+ از نظر مشاهده (استاندارد مشاهده ویدیوی IAB).
VIDEO_IAB_VIEWABILITY_50 50 ٪+ از نظر (استاندارد مشاهده ویدیوی IAB).
VIDEO_IAB_VIEWABILITY_75 75 ٪+ از نظر مشاهده (استاندارد مشاهده ویدیوی IAB).

DoubleVerify

جزئیات تنظیمات DoubleVerify.

نمایندگی JSON
{
  "brandSafetyCategories": {
    object (BrandSafetyCategories)
  },
  "avoidedAgeRatings": [
    enum (AgeRating)
  ],
  "appStarRating": {
    object (AppStarRating)
  },
  "displayViewability": {
    object (DisplayViewability)
  },
  "videoViewability": {
    object (VideoViewability)
  },
  "fraudInvalidTraffic": {
    object (FraudInvalidTraffic)
  },
  "customSegmentId": string
}
فیلدها
brandSafetyCategories

object ( BrandSafetyCategories )

کنترل ایمنی برند DV.

avoidedAgeRatings[]

enum ( AgeRating )

از پیشنهادات در برنامه ها با رتبه سنی خودداری کنید.

appStarRating

object ( AppStarRating )

از مناقصه برنامه های دارای رتبه بندی ستاره خودداری کنید.

displayViewability

object ( DisplayViewability )

نمایش تنظیمات قابلیت مشاهده (فقط برای نمایش موارد خط قابل اجرا).

videoViewability

object ( VideoViewability )

تنظیمات قابلیت مشاهده ویدیو (فقط برای موارد خط ویدیویی قابل اجرا است).

fraudInvalidTraffic

object ( FraudInvalidTraffic )

از سایت ها و برنامه ها با کلاهبرداری تاریخی و نرخ IVT خودداری کنید.

customSegmentId

string ( int64 format)

شناسه بخش سفارشی ارائه شده توسط DoubleVerify. شناسه باید با "51" شروع شود و از هشت رقم تشکیل شود. شناسه بخش سفارشی را نمی توان همراه با هر یک از قسمتهای زیر مشخص کرد:

SAFSETETYCATERIONES

تنظیمات کنترل ایمنی برند.

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

boolean

ناشناخته یا غیر قابل قبول.

avoidedHighSeverityCategories[]

enum ( HighSeverityCategory )

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

avoidedMediumSeverityCategories[]

enum ( MediumSeverityCategory )

دسته بندی اجتناب از شدت متوسط ​​ایمنی برند.

طبقه بندی

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

Enums
HIGHER_SEVERITY_UNSPECIFIED این enum فقط یک مکان نگهدارنده است و هیچ دسته از شدت بالایی را مشخص نمی کند.
ADULT_CONTENT_PORNOGRAPHY محتوای بزرگسالان: پورنوگرافی ، موضوعات بالغ و برهنگی.
COPYRIGHT_INFRINGEMENT نقض حق چاپ
SUBSTANCE_ABUSE مواد مخدر/الکل/مواد کنترل شده: سوء مصرف مواد.
GRAPHIC_VIOLENCE_WEAPONS خشونت/سلاح های گرافیکی شدید/صریح.
HATE_PROFANITY نفرت/کراهت.
CRIMINAL_SKILLS فعالیت های غیرقانونی: مهارت های جنایی.
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER تحریک شده/بدافزار/درهم و برهمی.

طبقه بندی شده

گزینه های ممکن برای دسته های شدت متوسط.

Enums
MEDIUM_SEVERITY_UNSPECIFIED این enum فقط یک مکان نگهدارنده است و هیچ دسته از شدت متوسط ​​را مشخص نمی کند.
AD_SERVERS سرورهای تبلیغاتی.
ADULT_CONTENT_SWIMSUIT محتوای بزرگسالان: لباس شنا.
ALTERNATIVE_LIFESTYLES موضوعات بحث برانگیز: سبک زندگی جایگزین.
CELEBRITY_GOSSIP موضوعات بحث برانگیز: شایعات مشهور.
GAMBLING موضوعات بحث برانگیز: قمار.
OCCULT موضوعات بحث برانگیز: غیبت.
SEX_EDUCATION موضوعات بحث برانگیز: آموزش جنسی.
DISASTER_AVIATION فاجعه: حمل و نقل هوایی.
DISASTER_MAN_MADE فاجعه: دست ساز.
DISASTER_NATURAL فاجعه: طبیعی.
DISASTER_TERRORIST_EVENTS فاجعه: رویدادهای تروریستی.
DISASTER_VEHICLE فاجعه: وسیله نقلیه.
ALCOHOL مواد مخدر/الکل/مواد کنترل شده: الکل.
SMOKING مواد مخدر/الکل/مواد کنترل شده: سیگار کشیدن.
NEGATIVE_NEWS_FINANCIAL اخبار منفی: مالی.
NON_ENGLISH محتوای غیر STD: غیر انگلیسی.
PARKING_PAGE محتوای غیر STD: صفحه پارکینگ.
UNMODERATED_UGC UGC Underated: انجمن ها ، تصاویر و فیلم.
INFLAMMATORY_POLITICS_AND_NEWS موضوعات بحث برانگیز: سیاست التهابی و اخبار.
NEGATIVE_NEWS_PHARMACEUTICAL اخبار منفی: دارویی.

پرشور

گزینه های ممکن برای رتبه بندی سنی.

Enums
AGE_RATING_UNSPECIFIED این enum فقط یک مکان نگهدارنده است و هیچ گزینه رتبه بندی سنی را مشخص نمی کند.
APP_AGE_RATE_UNKNOWN برنامه هایی با رتبه سنی ناشناخته.
APP_AGE_RATE_4_PLUS برنامه هایی که برای همه رتبه بندی شده اند (4+).
APP_AGE_RATE_9_PLUS برنامه هایی که برای همه رتبه بندی شده اند (9+).
APP_AGE_RATE_12_PLUS برنامه هایی که برای نوجوانان رتبه بندی شده اند (12+).
APP_AGE_RATE_17_PLUS برنامه های دارای امتیاز برای بالغ (17+).
APP_AGE_RATE_18_PLUS برنامه های فقط برای بزرگسالان (18+).

متقاضی

جزئیات تنظیمات رتبه بندی ستاره DoubleVerify.

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

enum ( StarRating )

از مناقصه برنامه های دارای رتبه بندی ستاره خودداری کنید.

avoidInsufficientStarRating

boolean

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

بی نظیر

گزینه های ممکن برای رتبه بندی ستاره ها.

Enums
APP_STAR_RATE_UNSPECIFIED این enum فقط یک مکان نگهدارنده است و هیچ گزینه رتبه بندی ستاره برنامه را مشخص نمی کند.
APP_STAR_RATE_1_POINT_5_LESS برنامه های رسمی با رتبه <1.5 ستاره.
APP_STAR_RATE_2_LESS برنامه های رسمی با رتبه <2 ستاره.
APP_STAR_RATE_2_POINT_5_LESS برنامه های رسمی با رتبه <2.5 ستاره.
APP_STAR_RATE_3_LESS برنامه های رسمی با رتبه <3 ستاره.
APP_STAR_RATE_3_POINT_5_LESS برنامه های رسمی با رتبه <3.5 ستاره.
APP_STAR_RATE_4_LESS برنامه های رسمی با رتبه <4 ستاره.
APP_STAR_RATE_4_POINT_5_LESS برنامه های رسمی با رتبه <4.5 ستاره.

قابلیت نمایش

جزئیات تنظیمات قابلیت مشاهده نمایش Doubleverify.

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

enum ( IAB )

موجودی وب و برنامه را برای به حداکثر رساندن نرخ قابل مشاهده IAB هدف قرار دهید.

viewableDuring

enum ( ViewableDuring )

موجودی وب و برنامه را برای به حداکثر رساندن 100 ٪ مدت قابل مشاهده هدف قرار دهید.

IAB

گزینه های ممکن برای نرخ قابل مشاهده IAB.

Enums
IAB_VIEWED_RATE_UNSPECIFIED این Enum فقط یک مکان نگهدارنده است و هیچ گزینه نرخ مشاهده 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 ٪ یا بالاتر هدف قرار دهید.

معنادار

گزینه های ممکن برای مدت زمان قابل مشاهده.

Enums
AVERAGE_VIEW_DURATION_UNSPECIFIED این enum فقط یک مکان نگهدارنده است و هیچ گزینه میانگین مدت زمان مشاهده را مشخص نمی کند.
AVERAGE_VIEW_DURATION_5_SEC موجودی وب و برنامه را برای به حداکثر رساندن 100 ٪ مدت قابل مشاهده 5 ثانیه یا بیشتر هدف قرار دهید.
AVERAGE_VIEW_DURATION_10_SEC موجودی وب و برنامه را برای به حداکثر رساندن 100 ٪ مدت قابل مشاهده 10 ثانیه یا بیشتر هدف قرار دهید.
AVERAGE_VIEW_DURATION_15_SEC موجودی وب و برنامه را برای به حداکثر رساندن 100 ٪ مدت قابل مشاهده 15 ثانیه یا بیشتر هدف قرار دهید.

قابلیت مشاهده ویدیویی

جزئیات تنظیمات قابلیت مشاهده ویدیوی DoubleVerify.

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

enum ( VideoIAB )

موجودی وب هدف را برای به حداکثر رساندن نرخ قابل مشاهده IAB.

videoViewableRate

enum ( VideoViewableRate )

موجودی وب را هدف قرار دهید تا نرخ کاملاً قابل مشاهده را به حداکثر برسانید.

playerImpressionRate

enum ( PlayerImpressionRate )

موجودی هدف را برای به حداکثر رساندن برداشت ها با اندازه 400x300 یا اندازه بیشتر پخش کنید.

ویدیوی

گزینه های احتمالی نرخ قابل مشاهده IAB.

Enums
VIDEO_IAB_UNSPECIFIED این Enum فقط یک مکان نگهدارنده است و هیچ گزینه ویدیویی را با نرخ قابل مشاهده 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

گزینه های ممکن با نرخ کاملاً قابل مشاهده.

Enums
VIDEO_VIEWABLE_RATE_UNSPECIFIED این enum فقط یک مکان نگهدارنده است و هیچ گزینه نرخ مشاهده ویدیویی را مشخص نمی کند.
VIEWED_PERFORMANCE_40_PERCENT_HIGHER موجودی وب را هدف قرار دهید تا حداکثر نرخ کاملاً قابل مشاهده 40 ٪ یا بالاتر باشد.
VIEWED_PERFORMANCE_35_PERCENT_HIGHER موجودی وب را هدف قرار دهید تا حداکثر نرخ کاملاً قابل مشاهده 35 ٪ یا بالاتر باشد.
VIEWED_PERFORMANCE_30_PERCENT_HIGHER موجودی وب را هدف قرار دهید تا حداکثر نرخ کاملاً قابل مشاهده 30 ٪ یا بالاتر باشد.
VIEWED_PERFORMANCE_25_PERCENT_HIGHER موجودی وب را هدف قرار دهید تا حداکثر نرخ کاملاً قابل مشاهده 25 ٪ یا بالاتر باشد.
VIEWED_PERFORMANCE_20_PERCENT_HIGHER موجودی وب را هدف قرار دهید تا نرخ کاملاً قابل مشاهده 20 ٪ یا بالاتر باشد.
VIEWED_PERFORMANCE_10_PERCENT_HIGHER موجودی وب هدف را برای به حداکثر رساندن نرخ کاملاً قابل مشاهده 10 ٪ یا بالاتر.

بازیکن

گزینه های احتمالی برداشت ها.

Enums
PLAYER_SIZE_400X300_UNSPECIFIED این enum فقط یک مکان نگهدارنده است و هیچ گزینه ای از برداشت ها را مشخص نمی کند.
PLAYER_SIZE_400X300_95 سایت هایی با 95 ٪+ برداشت.
PLAYER_SIZE_400X300_70 سایت هایی با 70 ٪+ برداشت.
PLAYER_SIZE_400X300_25 سایت هایی با 25 ٪+ برداشت.
PLAYER_SIZE_400X300_5 سایت هایی با 5 ٪+ برداشت.

مربوط به

تقلب را دو برابر کنید و تنظیمات ترافیک را نامعتبر کنید.

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

enum ( FraudOption )

از سایت ها و برنامه ها با کلاهبرداری تاریخی و IVT خودداری کنید.

avoidInsufficientOption

boolean

کلاهبرداری تاریخی کافی و آمار IVT.

کلاهبرداری

گزینه های احتمالی کلاهبرداری تاریخی و نرخ IVT.

Enums
FRAUD_UNSPECIFIED این enum فقط یک مکان نگهدارنده است و هیچ گونه کلاهبرداری و گزینه های ترافیکی نامعتبر را مشخص نمی کند.
AD_IMPRESSION_FRAUD_100 100 ٪ کلاهبرداری و IVT.
AD_IMPRESSION_FRAUD_50 50 ٪ یا کلاهبرداری بالاتر و IVT.
AD_IMPRESSION_FRAUD_25 25 ٪ یا بالاتر کلاهبرداری و IVT.
AD_IMPRESSION_FRAUD_10 10 ٪ یا کلاهبرداری بالاتر و IVT.
AD_IMPRESSION_FRAUD_8 کلاهبرداری 8 ٪ یا بالاتر و IVT.
AD_IMPRESSION_FRAUD_6 کلاهبرداری 6 ٪ یا بالاتر و IVT.
AD_IMPRESSION_FRAUD_4 کلاهبرداری 4 ٪ یا بالاتر و IVT.
AD_IMPRESSION_FRAUD_2 تقلب 2 ٪ یا بالاتر و IVT.

itudaladScience

جزئیات تنظیمات علمی آگهی انتگرال.

نمایندگی JSON
{
  "traqScoreOption": enum (TRAQScore),
  "excludeUnrateable": boolean,
  "excludedAdultRisk": enum (Adult),
  "excludedAlcoholRisk": enum (Alcohol),
  "excludedIllegalDownloadsRisk": enum (IllegalDownloads),
  "excludedDrugsRisk": enum (Drugs),
  "excludedHateSpeechRisk": enum (HateSpeech),
  "excludedOffensiveLanguageRisk": enum (OffensiveLanguage),
  "excludedViolenceRisk": enum (Violence),
  "excludedGamblingRisk": enum (Gambling),
  "excludedAdFraudRisk": enum (AdFraudPrevention),
  "displayViewability": enum (DisplayViewability),
  "videoViewability": enum (VideoViewability),
  "customSegmentId": [
    string
  ],
  "qualitySyncCustomSegmentId": [
    string
  ]
}
فیلدها
traqScoreOption

enum ( TRAQScore )

کیفیت تبلیغات واقعی (فقط برای نمایش موارد خط قابل اجرا است).

excludeUnrateable

boolean

ایمنی برند - غیرقابل توصیف .

excludedAdultRisk

enum ( Adult )

ایمنی برند - محتوای بزرگسالان .

excludedAlcoholRisk

enum ( Alcohol )

ایمنی برند - الکل .

excludedIllegalDownloadsRisk

enum ( IllegalDownloads )

ایمنی برند - بارگیری های غیرقانونی .

excludedDrugsRisk

enum ( Drugs )

ایمنی برند - داروها .

excludedHateSpeechRisk

enum ( HateSpeech )

ایمنی برند - گفتار نفرت .

excludedOffensiveLanguageRisk

enum ( OffensiveLanguage )

ایمنی برند - زبان توهین آمیز .

excludedViolenceRisk

enum ( Violence )

ایمنی برند - خشونت .

excludedGamblingRisk

enum ( Gambling )

ایمنی برند - قمار .

excludedAdFraudRisk

enum ( AdFraudPrevention )

تنظیمات تقلب در تبلیغات.

displayViewability

enum ( DisplayViewability )

بخش نمایندگی نمایش (فقط برای نمایش موارد خط قابل اجرا است).

videoViewability

enum ( VideoViewability )

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

customSegmentId[]

string ( int64 format)

شناسه بخش سفارشی ارائه شده توسط انتگرال AD Science. شناسه باید بین 1000001 تا 1999999 یا 3000001 و 3999999 باشد.

qualitySyncCustomSegmentId[]

string ( int64 format)

اختیاری. شناسه بخش سفارشی همگام سازی کیفیت ارائه شده توسط انتگرال AD Science. شناسه باید بین 3000000 تا 4999999 باشد.

تقیه

نمره نمره احتمالی AD Science TRAQ (کیفیت تبلیغات واقعی).

Enums
TRAQ_UNSPECIFIED این enum فقط یک مکان نگهدارنده است و هیچ نمره ای با کیفیت تبلیغات واقعی را مشخص نمی کند.
TRAQ_250 امتیاز TRAQ 250-1000.
TRAQ_500 امتیاز TRAQ 500-1000.
TRAQ_600 امتیاز TRAQ 600-1000.
TRAQ_700 امتیاز TRAQ 700-1000.
TRAQ_750 امتیاز TRAQ 750-1000.
TRAQ_875 امتیاز TRAQ 875-1000.
TRAQ_1000 امتیاز TRAQ 1000.

بالغ

گزینه های بزرگسالان آگهی یکپارچه ممکن است.

Enums
ADULT_UNSPECIFIED این Enum فقط یک مکان نگهدارنده است و هیچ گزینه بزرگسالان را مشخص نمی کند.
ADULT_HR بزرگسالان - ریسک بالا را حذف کنید.
ADULT_HMR بزرگسالان - خطر زیاد و متوسط ​​را حذف کنید.

الکل

گزینه های الکل علمی یکپارچه ممکن است.

Enums
ALCOHOL_UNSPECIFIED این enum فقط یک مکان نگهدارنده است و هیچ گزینه الکل را مشخص نمی کند.
ALCOHOL_HR الکل - ریسک بالا را حذف کنید.
ALCOHOL_HMR الکل - خطر زیاد و متوسط ​​را حذف کنید.

بارهای غیرقانونی

گزینه های بارگیری غیرقانونی آگهی انتگرال ممکن است.

Enums
ILLEGAL_DOWNLOADS_UNSPECIFIED این enum فقط یک مکان نگهدارنده است و گزینه های بارگیری غیرقانونی را مشخص نمی کند.
ILLEGAL_DOWNLOADS_HR بارگیری های غیرقانونی - ریسک بالا را حذف کنید.
ILLEGAL_DOWNLOADS_HMR بارگیری های غیرقانونی - ریسک بالا و متوسط ​​را حذف کنید.

مواد مخدر

گزینه های احتمالی داروهای علمی آگهی یکپارچه.

Enums
DRUGS_UNSPECIFIED این enum فقط یک مکان نگهدارنده است و هیچ گزینه دارویی را مشخص نمی کند.
DRUGS_HR مواد مخدر - ریسک بالا را حذف کنید.
DRUGS_HMR مواد مخدر - خطر زیاد و متوسط ​​را حذف کنید.

متنفر

گزینه های گفتاری نفرت از آگهی انتگرال احتمالی.

Enums
HATE_SPEECH_UNSPECIFIED این enum فقط یک مکان نگهدارنده است و هیچ گزینه گفتار نفرت را مشخص نمی کند.
HATE_SPEECH_HR گفتار نفرت - ریسک بالا را حذف کنید.
HATE_SPEECH_HMR گفتار نفرت - خطر زیاد و متوسط ​​را حذف کنید.

زار

گزینه های احتمالی آگهی یکپارچه سازی علوم توهین آمیز.

Enums
OFFENSIVE_LANGUAGE_UNSPECIFIED این enum فقط یک مکان نگهدارنده است و هیچ گزینه زبانی را مشخص نمی کند.
OFFENSIVE_LANGUAGE_HR زبان توهین آمیز - ریسک بالا را حذف کنید.
OFFENSIVE_LANGUAGE_HMR زبان توهین آمیز - ریسک بالا و متوسط ​​را حذف کنید.

خشونت

گزینه های خشونت علمی آگهی یکپارچه احتمالی.

Enums
VIOLENCE_UNSPECIFIED این enum فقط یک مکان نگهدارنده است و هیچ گزینه خشونت را مشخص نمی کند.
VIOLENCE_HR خشونت - ریسک بالا را حذف کنید.
VIOLENCE_HMR خشونت - خطر زیاد و متوسط ​​را حذف کنید.

قمار

گزینه های قمار علمی آگهی احتمالی.

Enums
GAMBLING_UNSPECIFIED این enum فقط یک مکان نگهدارنده است و هیچ گزینه قمار را مشخص نمی کند.
GAMBLING_HR قمار - ریسک بالا را حذف کنید.
GAMBLING_HMR قمار - خطر بالا و متوسط ​​را حذف کنید.

پیشگیری از تجدیدنظر

گزینه های پیشگیری از تقلب در آگهی تبلیغاتی احتمالی.

Enums
SUSPICIOUS_ACTIVITY_UNSPECIFIED این enum فقط یک مکان نگهدارنده است و هیچ گزینه پیشگیری از کلاهبرداری تبلیغاتی را مشخص نمی کند.
SUSPICIOUS_ACTIVITY_HR تقلب در تبلیغ - ریسک بالا را حذف کنید.
SUSPICIOUS_ACTIVITY_HMR تقلب در تبلیغ - ریسک بالا و متوسط ​​را حذف کنید.

قابلیت نمایش

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

Enums
PERFORMANCE_VIEWABILITY_UNSPECIFIED این enum فقط یک مکان نگهدارنده است و هیچ گزینه قابلیت مشاهده صفحه نمایش را مشخص نمی کند.
PERFORMANCE_VIEWABILITY_40 میزان مشاهده 40 ٪ یا بالاتر را هدف قرار دهید.
PERFORMANCE_VIEWABILITY_50 میزان مشاهده 50 ٪ یا بالاتر را هدف قرار دهید.
PERFORMANCE_VIEWABILITY_60 مشاهده 60 ٪ قابل مشاهده یا بالاتر.
PERFORMANCE_VIEWABILITY_70 70 ٪ قابل مشاهده یا بالاتر را هدف قرار دهید.

قابلیت مشاهده ویدیویی

گزینه های قابل مشاهده ویدیوی علمی یکپارچه ممکن است.

Enums
VIDEO_VIEWABILITY_UNSPECIFIED این enum فقط یک مکان نگهدارنده است و هیچ گزینه قابلیت مشاهده ویدیویی را مشخص نمی کند.
VIDEO_VIEWABILITY_40 40 ٪+ از نظر (استاندارد مشاهده ویدیوی IAB).
VIDEO_VIEWABILITY_50 50 ٪+ از نظر (استاندارد مشاهده ویدیوی IAB).
VIDEO_VIEWABILITY_60 60 ٪+ از نظر (استاندارد مشاهده ویدیوی IAB).
VIDEO_VIEWABILITY_70 70 ٪+ از نظر مشاهده (استاندارد مشاهده ویدیوی IAB).

PoiassignedTargetingOptionDetails

جزئیات مربوط به گزینه هدف گذاری POI اختصاص یافته. این در قسمت جزئیات یک اختصاص داده شده در هنگام targetingType TARGETING_TYPE_POI جمع می شود.

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

string

فقط خروجی نام نمایش یک POI ، به عنوان مثال "Times Square" ، "Seadle Space" و در صورت وجود آدرس کامل آن.

targetingOptionId

string

مورد نیاز. targetingOptionId از یک TargetingOption نوع TARGETING_TYPE_POI .

شناسه های گزینه هدفمند POI پذیرفته شده را می توان با استفاده از targetingTypes.targetingOptions.search بازیابی کرد.

اگر هدف قرار دادن یک مختصات خاص عرض جغرافیایی/طول جغرافیایی که از یک آدرس یا نام POI حذف شده است ، می توانید با گرداندن مقادیر مختصات مورد نظر به مکان اعشاری ششم ، حذف اعشار ، و به هم پیوستن مقادیر رشته ای که توسط یک رنگ آمیزی جدا شده است ، شناسه گزینه هدفمند را ایجاد کنید. به عنوان مثال ، شما می توانید جفت عرض جغرافیایی/طول جغرافیایی 40.7414691 ، -74.003387 را با استفاده از شناسه گزینه هدفمند "40741469 ؛ -74003387" هدف قرار دهید. پس از ایجاد ، اگر فقط مختصات عرض جغرافیایی و طول جغرافیایی ارائه شود ، این مقدار فیلد به روز می شود تا مقدار هش نیمه رنگ و الفبایی را اضافه کند .

latitude

number

فقط خروجی عرض جغرافیایی POI گرد تا مکان اعشاری 6.

longitude

number

فقط خروجی طول جغرافیایی POI دور تا مکان اعشاری 6.

proximityRadiusAmount

number

مورد نیاز. شعاع منطقه اطراف POI که هدف قرار خواهد گرفت. واحدهای شعاع توسط proximityRadiusUnit مشخص شده است. باید 1 تا 800 باشد اگر واحد DISTANCE_UNIT_KILOMETERS و 1 تا 500 اگر واحد DISTANCE_UNIT_MILES است.

proximityRadiusUnit

enum ( DistanceUnit )

مورد نیاز. واحد مسافتی که شعاع هدفمند آن اندازه گیری می شود.

فاصله دور

گزینه های واحد مسافت احتمالی.

Enums
DISTANCE_UNIT_UNSPECIFIED مقدار نوع مشخص نشده یا در این نسخه ناشناخته است.
DISTANCE_UNIT_MILES مایل.
DISTANCE_UNIT_KILOMETERS کیلومتر

BusinessChainAssignedTargetingOptionDetails

جزئیات مربوط به گزینه هدف گذاری زنجیره تجاری اختصاص داده شده. این امر در قسمت جزئیات یک اختصاص داده شده در هنگام targetingType TARGETING_TYPE_BUSINESS_CHAIN جمع خواهد شد.

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

string

فقط خروجی نام نمایش یک زنجیره تجاری ، به عنوان مثال "KFC" ، "Chase Bank".

targetingOptionId

string

مورد نیاز. targetingOptionId از یک TargetingOption نوع Type 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

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

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

string

مورد نیاز. قسمت targetingOptionId هنگامی که targetingType TARGETING_TYPE_CONTENT_DURATION است.

contentDuration

enum ( ContentDuration )

فقط خروجی مدت زمان محتوا

ContentStreamTypeAssigeDtartePtionOptionDetails

جزئیات مربوط به گزینه Type Type Type اختصاص داده شده. هنگامی که targetingType TARGETING_TYPE_CONTENT_STREAM_TYPE باشد ، در قسمت contentStreamTypeDetails جمع می شود. به صراحت هدف قرار دادن همه گزینه ها پشتیبانی نمی شود. برای دستیابی به این اثر ، کلیه گزینه های هدف گذاری نوع جریان محتوا را حذف کنید.

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

string

مورد نیاز. قسمت targetingOptionId هنگامی که targetingType TARGETING_TYPE_CONTENT_STREAM_TYPE است.

contentStreamType

enum ( ContentStreamType )

فقط خروجی نوع جریان محتوا

nativeContentPositionAssignedTargetingOptionDetails

جزئیات مربوط به موقعیت محتوای بومی اختصاص داده شده. هنگامی که targetingType TARGETING_TYPE_NATIVE_CONTENT_POSITION باشد ، در قسمت nativeContentPositionDetails جمع می شود. به صراحت هدف قرار دادن همه گزینه ها پشتیبانی نمی شود. برای دستیابی به این اثر ، تمام گزینه های هدف گذاری موقعیت محتوای بومی را حذف کنید.

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

enum ( NativeContentPosition )

مورد نیاز. موقعیت محتوا

omidassignedtargetingoptionsetails

یک نوع موجودی فعال شده با اندازه گیری باز هدفمند را نشان می دهد. این امر در قسمت جزئیات یک اختصاص داده شده در هنگام targetingType TARGETING_TYPE_OMID جمع می شود.

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

enum ( Omid )

مورد نیاز. نوع موجودی اندازه گیری باز.

audioiocontenttypeaseStareTargetingOptionDetails

جزئیات مربوط به گزینه Type Type Audio Type اختصاص داده شده. هنگامی که targetingType TARGETING_TYPE_AUDIO_CONTENT_TYPE باشد ، در قسمت audioContentTypeDetails جمع می شود. به صراحت هدف قرار دادن همه گزینه ها پشتیبانی نمی شود. برای دستیابی به این اثر ، تمام گزینه های هدفگذاری نوع محتوای صوتی را حذف کنید.

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

enum ( AudioContentType )

مورد نیاز. نوع محتوای صوتی.

ContentGenereAssignedTargetingOptionDetails

جزئیات مربوط به ژانر محتوا اختصاص داده شده. هنگامی که targetingType TARGETING_TYPE_CONTENT_GENRE باشد ، در قسمت contentGenreDetails جمع می شود. به صراحت هدف قرار دادن همه گزینه ها پشتیبانی نمی شود. برای دستیابی به این اثر ، کلیه گزینه های هدفمند ژانر محتوا را حذف کنید.

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

string

مورد نیاز. قسمت targetingOptionId هنگامی که targetingType TARGETING_TYPE_CONTENT_GENRE است.

displayName

string

فقط خروجی نام نمایش ژانر محتوا.

negative

boolean

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

youtubevideoassignedtargetingoptiondetails

جزئیات مربوط به ویدیوی YouTube به گزینه هدف گذاری اختصاص داده شده است. هنگامی که targetingType TARGETING_TYPE_YOUTUBE_VIDEO باشد ، در قسمت youtubeVideoDetails جمع می شود.

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

string

شناسه ویدیوی YouTube همانطور که در صفحه Watch YouTube ظاهر می شود.

negative

boolean

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

YouTubeChannelAssignedTargetingOptionDetails

جزئیات مربوط به گزینه هدف گذاری کانال YouTube. هنگامی که targetingType TARGETING_TYPE_YOUTUBE_CHANNEL باشد ، در قسمت youtubeChannelDetails جمع می شود.

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

string

شناسه کانال بارگذاری YouTube یا کد کانال یک کانال YouTube.

negative

boolean

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

SessionSpositionAssignedTargetingOptionDetails

جزئیات مربوط به موقعیت جلسه اختصاص داده شده اختصاص داده شده. هنگامی که targetingType TARGETING_TYPE_SESSION_POSITION باشد ، این در قسمت sessionPositionDetails جمع خواهد شد.

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

enum ( SessionPosition )

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

موقعیت جلسه

موقعیت های احتمالی در یک جلسه.

Enums
SESSION_POSITION_UNSPECIFIED این یک مکان نگهدارنده است ، هیچ موقعیتی را نشان نمی دهد.
SESSION_POSITION_FIRST_IMPRESSION اولین برداشت از جلسه.

روش ها

get

یک گزینه هدفمند واحد را به یک گروه تبلیغاتی اختصاص می دهد.

list

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

منبع: اختصاص داده شده

یک گزینه هدفمند اختصاص داده شده ، که وضعیت گزینه هدف گذاری برای یک نهاد را با تنظیمات هدفمند تعریف می کند.

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

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

string

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

assignedTargetingOptionId

string

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

assignedTargetingOptionIdAlias

string

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

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

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

این قسمت همچنین برای موارد خطی که گزینه های هدفگذاری از انواع هدف قرار دادن زیر را نشان می دهد پشتیبانی می شود:

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum ( TargetingType )

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

inheritance

enum ( Inheritance )

فقط خروجی وضعیت وراثت گزینه هدف گذاری اختصاص یافته.

details حوزه اتحادیه. اطلاعات دقیق در مورد گزینه هدف گذاری اختصاص داده شده است. فقط یک قسمت در جزئیات ممکن است پر شود ، و باید با targeting_type مطابقت داشته باشد. details فقط می تواند یکی از موارد زیر باشد:
channelDetails

object ( ChannelAssignedTargetingOptionDetails )

جزئیات کانال این قسمت زمانی جمع می شود که targetingType TARGETING_TYPE_CHANNEL باشد.

appCategoryDetails

object ( AppCategoryAssignedTargetingOptionDetails )

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

appDetails

object ( AppAssignedTargetingOptionDetails )

جزئیات برنامه این قسمت زمانی جمع می شود که targetingType TARGETING_TYPE_APP باشد.

urlDetails

object ( UrlAssignedTargetingOptionDetails )

جزئیات URL این قسمت زمانی جمع می شود که targetingType TARGETING_TYPE_URL باشد.

dayAndTimeDetails

object ( DayAndTimeAssignedTargetingOptionDetails )

جزئیات روز و زمان این قسمت زمانی جمع می شود که targetingType TARGETING_TYPE_DAY_AND_TIME باشد.

ageRangeDetails

object ( AgeRangeAssignedTargetingOptionDetails )

جزئیات دامنه سنی. این قسمت زمانی جمع می شود که targetingType TARGETING_TYPE_AGE_RANGE باشد.

regionalLocationListDetails

object ( RegionalLocationListAssignedTargetingOptionDetails )

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

proximityLocationListDetails

object ( ProximityLocationListAssignedTargetingOptionDetails )

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

genderDetails

object ( GenderAssignedTargetingOptionDetails )

جزئیات جنسیتی این قسمت زمانی جمع می شود که targetingType TARGETING_TYPE_GENDER باشد.

videoPlayerSizeDetails

object ( VideoPlayerSizeAssignedTargetingOptionDetails )

جزئیات اندازه پخش کننده ویدیو. این قسمت زمانی جمع می شود که targetingType TARGETING_TYPE_VIDEO_PLAYER_SIZE باشد.

userRewardedContentDetails

object ( UserRewardedContentAssignedTargetingOptionDetails )

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

parentalStatusDetails

object ( ParentalStatusAssignedTargetingOptionDetails )

جزئیات وضعیت والدین. این قسمت زمانی جمع می شود که targetingType TARGETING_TYPE_PARENTAL_STATUS باشد.

contentInstreamPositionDetails

object ( ContentInstreamPositionAssignedTargetingOptionDetails )

جزئیات موقعیت موقعیت یابی محتوا. این قسمت زمانی جمع می شود که targetingType TARGETING_TYPE_CONTENT_INSTREAM_POSITION باشد.

contentOutstreamPositionDetails

object ( ContentOutstreamPositionAssignedTargetingOptionDetails )

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

deviceTypeDetails

object ( DeviceTypeAssignedTargetingOptionDetails )

جزئیات نوع دستگاه این قسمت زمانی جمع می شود که targetingType TARGETING_TYPE_DEVICE_TYPE باشد.

audienceGroupDetails

object ( AudienceGroupAssignedTargetingOptionDetails )

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

browserDetails

object ( BrowserAssignedTargetingOptionDetails )

جزئیات مرورگر. این قسمت زمانی جمع می شود که targetingType TARGETING_TYPE_BROWSER باشد.

householdIncomeDetails

object ( HouseholdIncomeAssignedTargetingOptionDetails )

جزئیات درآمد خانوار. این قسمت زمانی جمع می شود که targetingType TARGETING_TYPE_HOUSEHOLD_INCOME باشد.

onScreenPositionDetails

object ( OnScreenPositionAssignedTargetingOptionDetails )

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

carrierAndIspDetails

object ( CarrierAndIspAssignedTargetingOptionDetails )

جزئیات حامل و ISP. این قسمت زمانی جمع می شود که targetingType TARGETING_TYPE_CARRIER_AND_ISP را هدف قرار دهد.

keywordDetails

object ( KeywordAssignedTargetingOptionDetails )

جزئیات کلمه کلیدی این قسمت زمانی جمع می شود که targetingType TARGETING_TYPE_KEYWORD باشد.

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

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

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

If a resource doesn't have an authorized seller status option, all authorized sellers indicated as DIRECT or RESELLER in the ads.txt file are targeted by default.

languageDetails

object ( LanguageAssignedTargetingOptionDetails )

Language details. This field will be populated when the targetingType is TARGETING_TYPE_LANGUAGE .

geoRegionDetails

object ( GeoRegionAssignedTargetingOptionDetails )

Geographic region details. This field will be populated when the targetingType is TARGETING_TYPE_GEO_REGION .

inventorySourceGroupDetails

object ( InventorySourceGroupAssignedTargetingOptionDetails )

Inventory source group details. This field will be populated when the targetingType is TARGETING_TYPE_INVENTORY_SOURCE_GROUP .

digitalContentLabelExclusionDetails

object ( DigitalContentLabelAssignedTargetingOptionDetails )

Digital content label details. This field will be populated when the targetingType is TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION .

Digital content labels are targeting exclusions. Advertiser level digital content label exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content labels in addition to advertiser exclusions, but can't override them. A line item won't serve if all the digital content labels are excluded.

sensitiveCategoryExclusionDetails

object ( SensitiveCategoryAssignedTargetingOptionDetails )

Sensitive category details. This field will be populated when the targetingType is TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION .

Sensitive categories are targeting exclusions. Advertiser level sensitive category exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude sensitive categories in addition to advertiser exclusions, but can't override them.

contentThemeExclusionDetails

object ( ContentThemeAssignedTargetingOptionDetails )

Content theme details. This field will be populated when the targetingType is TARGETING_TYPE_CONTENT_THEME_EXCLUSION .

Content theme are targeting exclusions. Advertiser level content theme exclusions, if set, are always applied in serving (even though they aren't visible in resource settings). Resource settings can exclude content theme in addition to advertiser exclusions.

exchangeDetails

object ( ExchangeAssignedTargetingOptionDetails )

Exchange details. This field will be populated when the targetingType is TARGETING_TYPE_EXCHANGE .

subExchangeDetails

object ( SubExchangeAssignedTargetingOptionDetails )

Sub-exchange details. This field will be populated when the targetingType is TARGETING_TYPE_SUB_EXCHANGE .

thirdPartyVerifierDetails

object ( ThirdPartyVerifierAssignedTargetingOptionDetails )

Third party verification details. This field will be populated when the targetingType is TARGETING_TYPE_THIRD_PARTY_VERIFIER .

poiDetails

object ( PoiAssignedTargetingOptionDetails )

POI details. This field will be populated when the targetingType is TARGETING_TYPE_POI .

businessChainDetails

object ( BusinessChainAssignedTargetingOptionDetails )

Business chain details. This field will be populated when the targetingType is TARGETING_TYPE_BUSINESS_CHAIN .

contentDurationDetails

object ( ContentDurationAssignedTargetingOptionDetails )

Content duration details. This field will be populated when the targetingType is TARGETING_TYPE_CONTENT_DURATION .

contentStreamTypeDetails

object ( ContentStreamTypeAssignedTargetingOptionDetails )

Content duration details. This field will be populated when the TargetingType is TARGETING_TYPE_CONTENT_STREAM_TYPE .

nativeContentPositionDetails

object ( NativeContentPositionAssignedTargetingOptionDetails )

Native content position details. This field will be populated when the targetingType is TARGETING_TYPE_NATIVE_CONTENT_POSITION .

omidDetails

object ( OmidAssignedTargetingOptionDetails )

Open Measurement enabled inventory details. This field will be populated when the targetingType is TARGETING_TYPE_OMID .

audioContentTypeDetails

object ( AudioContentTypeAssignedTargetingOptionDetails )

Audio content type details. This field will be populated when the targetingType is TARGETING_TYPE_AUDIO_CONTENT_TYPE .

contentGenreDetails

object ( ContentGenreAssignedTargetingOptionDetails )

Content genre details. This field will be populated when the targetingType is TARGETING_TYPE_CONTENT_GENRE .

youtubeVideoDetails

object ( YoutubeVideoAssignedTargetingOptionDetails )

YouTube video details. This field will be populated when the targetingType is TARGETING_TYPE_YOUTUBE_VIDEO .

youtubeChannelDetails

object ( YoutubeChannelAssignedTargetingOptionDetails )

YouTube channel details. This field will be populated when the targetingType is TARGETING_TYPE_YOUTUBE_CHANNEL .

sessionPositionDetails

object ( SessionPositionAssignedTargetingOptionDetails )

Session position details. This field will be populated when the targetingType is TARGETING_TYPE_SESSION_POSITION .

ارث

Indicates whether the assigned targeting option is inherited from a higher level entity like a partner or an advertiser. Inherited assigned targeting options take precedent, are always applied in serving over targeting assigned at the current level and cannot be modified through the current entity service. They must be modified through the entity service from which they are inherited. The inheritance only applies to negatively targeted Channels, Sensitive Category exclusions and Digital Content Label exclusions if they are configured at the parent level.

Enums
INHERITANCE_UNSPECIFIED The inheritance is unspecified or unknown.
NOT_INHERITED The assigned targeting option is not inherited from higher level entity.
INHERITED_FROM_PARTNER The assigned targeting option is inherited from partner targeting settings.
INHERITED_FROM_ADVERTISER The assigned targeting option is inherited from advertiser targeting settings.

ChannelAssignedTargetingOptionDetails

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

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

string ( int64 format)

مورد نیاز. ID of the channel. Should refer to the channel ID field on a Partner-owned channel or advertiser-owned channel resource.

negative

boolean

Indicates if this option is being negatively targeted. For advertiser level assigned targeting option, this field must be true.

AppCategoryAssignedTargetingOptionDetails

Details for assigned app category targeting option. This will be populated in the appCategoryDetails field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_APP_CATEGORY .

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

string

Output only. The display name of the app category.

targetingOptionId

string

مورد نیاز. The targetingOptionId field when targetingType is TARGETING_TYPE_APP_CATEGORY .

negative

boolean

Indicates if this option is being negatively targeted.

AppAssignedTargetingOptionDetails

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

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

string

مورد نیاز. The ID of the app.

Android's Play store app uses bundle ID, for example com.google.android.gm . Apple's App store app ID uses 9 digit string, for example 422689480 .

displayName

string

Output only. The display name of the app.

negative

boolean

Indicates if this option is being negatively targeted.

appPlatform

enum ( AppPlatform )

Indicates the platform of the targeted app. If this field is not specified, the app platform will be assumed to be mobile (ie, Android or iOS), and we will derive the appropriate mobile platform from the app ID.

AppPlatform

Possible app platform targeting options.

Enums
APP_PLATFORM_UNSPECIFIED Default value when app platform is not specified in this version. This enum is a placeholder for default value and does not represent a real platform option.
APP_PLATFORM_IOS The app platform is iOS.
APP_PLATFORM_ANDROID The app platform is Android.
APP_PLATFORM_ROKU The app platform is Roku.
APP_PLATFORM_AMAZON_FIRETV The app platform is Amazon FireTV.
APP_PLATFORM_PLAYSTATION The app platform is Playstation.
APP_PLATFORM_APPLE_TV The app platform is Apple TV.
APP_PLATFORM_XBOX The app platform is Xbox.
APP_PLATFORM_SAMSUNG_TV The app platform is Samsung TV.
APP_PLATFORM_ANDROID_TV The app platform is Android TV.
APP_PLATFORM_GENERIC_CTV The app platform is a CTV platform that is not explicitly listed elsewhere.
APP_PLATFORM_LG_TV The app platform is LG TV.
APP_PLATFORM_VIZIO_TV The app platform is VIZIO TV.

UrlAssignedTargetingOptionDetails

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

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

string

مورد نیاز. The URL, for example example.com .

DV360 supports two levels of subdirectory targeting, for example www.example.com/one-subdirectory-level/second-level , and five levels of subdomain targeting, for example five.four.three.two.one.example.com .

negative

boolean

Indicates if this option is being negatively targeted.

DayAndTimeAssignedTargetingOptionDetails

Representation of a segment of time defined on a specific day of the week and with a start and end time. The time represented by startHour must be before the time represented by endHour .

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

enum ( DayOfWeek )

مورد نیاز. The day of the week for this day and time targeting setting.

startHour

integer

مورد نیاز. The start hour for day and time targeting. Must be between 0 (start of day) and 23 (1 hour before end of day).

endHour

integer

مورد نیاز. The end hour for day and time targeting. Must be between 1 (1 hour after start of day) and 24 (end of day).

timeZoneResolution

enum ( TimeZoneResolution )

مورد نیاز. The mechanism used to determine which timezone to use for this day and time targeting setting.

DayOfWeek

Represents a day of the week.

Enums
DAY_OF_WEEK_UNSPECIFIED The day of the week is unspecified.
MONDAY دوشنبه
TUESDAY سه شنبه
WEDNESDAY چهارشنبه
THURSDAY پنج شنبه
FRIDAY جمعه
SATURDAY شنبه
SUNDAY یکشنبه

TimeZoneResolution

Possible approaches to resolve the timezone.

Enums
TIME_ZONE_RESOLUTION_UNSPECIFIED Time zone resolution is either unspecific or unknown.
TIME_ZONE_RESOLUTION_END_USER Times are resolved in the time zone of the user that saw the ad.
TIME_ZONE_RESOLUTION_ADVERTISER Times are resolved in the time zone of the advertiser that served the ad.

AgeRangeAssignedTargetingOptionDetails

Represents a targetable age range. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_AGE_RANGE .

JSON representation
{
  "ageRange": enum (AgeRange)
}
فیلدها
ageRange

enum ( AgeRange )

مورد نیاز. The age range of an audience. We only support targeting a continuous age range of an audience. Thus, the age range represented in this field can be 1) targeted solely, or, 2) part of a larger continuous age range. The reach of a continuous age range targeting can be expanded by also targeting an audience of an unknown age.

RegionalLocationListAssignedTargetingOptionDetails

Targeting details for regional location list. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_REGIONAL_LOCATION_LIST .

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

string ( int64 format)

مورد نیاز. ID of the regional location list. Should refer to the locationListId field of a LocationList resource whose type is TARGETING_LOCATION_TYPE_REGIONAL .

negative

boolean

Indicates if this option is being negatively targeted.

ProximityLocationListAssignedTargetingOptionDetails

Targeting details for proximity location list. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_PROXIMITY_LOCATION_LIST .

JSON representation
{
  "proximityLocationListId": string,
  "proximityRadius": number,
  "proximityRadiusUnit": enum (ProximityRadiusUnit)
}
فیلدها
proximityLocationListId

string ( int64 format)

مورد نیاز. ID of the proximity location list. Should refer to the locationListId field of a LocationList resource whose type is TARGETING_LOCATION_TYPE_PROXIMITY .

proximityRadius

number

مورد نیاز. Radius expressed in the distance units set in proximityRadiusUnit . This represents the size of the area around a chosen location that will be targeted. Radius should be between 1 and 500 miles or 800 kilometers.

proximityRadiusUnit

enum ( ProximityRadiusUnit )

مورد نیاز. Radius distance units.

ProximityRadiusUnit

Distance units enum for ProximityRadius.

Enums
PROXIMITY_RADIUS_UNIT_UNSPECIFIED Default value when distance units is not specified in this version. This enum is a place holder for default value and does not represent a real distance unit.
PROXIMITY_RADIUS_UNIT_MILES Radius distance unit in miles.
PROXIMITY_RADIUS_UNIT_KILOMETERS Radius distance unit in kilometeres

GenderAssignedTargetingOptionDetails

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

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

enum ( Gender )

مورد نیاز. The gender of the audience.

VideoPlayerSizeAssignedTargetingOptionDetails

Video player size targeting option details. This will be populated in the videoPlayerSizeDetails field when targetingType is TARGETING_TYPE_VIDEO_PLAYER_SIZE . Explicitly targeting all options is not supported. Remove all video player size targeting options to achieve this effect.

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

enum ( VideoPlayerSize )

مورد نیاز. The video player size.

UserRewardedContentAssignedTargetingOptionDetails

User rewarded content targeting option details. This will be populated in the userRewardedContentDetails field when targetingType is TARGETING_TYPE_USER_REWARDED_CONTENT .

JSON representation
{
  "targetingOptionId": string,
  "userRewardedContent": enum (UserRewardedContent)
}
فیلدها
targetingOptionId

string

مورد نیاز. The targetingOptionId field when targetingType is TARGETING_TYPE_USER_REWARDED_CONTENT .

userRewardedContent

enum ( UserRewardedContent )

Output only. User rewarded content status for video ads.

ParentalStatusAssignedTargetingOptionDetails

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

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

enum ( ParentalStatus )

مورد نیاز. The parental status of the audience.

ContentInstreamPositionAssignedTargetingOptionDetails

Assigned content instream position targeting option details. This will be populated in the contentInstreamPositionDetails field when targetingType is TARGETING_TYPE_CONTENT_INSTREAM_POSITION .

JSON representation
{
  "contentInstreamPosition": enum (ContentInstreamPosition),
  "adType": enum (AdType)
}
فیلدها
contentInstreamPosition

enum ( ContentInstreamPosition )

مورد نیاز. The content instream position for video or audio ads.

adType

enum ( AdType )

Output only. The ad type to target. Only applicable to insertion order targeting and new line items supporting the specified ad type will inherit this targeting option by default. مقادیر ممکن عبارتند از:

  • AD_TYPE_VIDEO , the setting will be inherited by new line item when lineItemType is LINE_ITEM_TYPE_VIDEO_DEFAULT .
  • AD_TYPE_AUDIO , the setting will be inherited by new line item when lineItemType is LINE_ITEM_TYPE_AUDIO_DEFAULT .

AdType

Represents the creative type associated with the ads.

Enums
AD_TYPE_UNSPECIFIED Ad type is not specified or is unknown in this version.
AD_TYPE_DISPLAY Display creatives, eg image and HTML5.
AD_TYPE_VIDEO Video creatives, eg video ads that play during streaming content in video players.
AD_TYPE_AUDIO Audio creatives, eg audio ads that play during audio content.

ContentOutstreamPositionAssignedTargetingOptionDetails

Assigned content outstream position targeting option details. This will be populated in the contentOutstreamPositionDetails field when targetingType is TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION .

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

enum ( ContentOutstreamPosition )

مورد نیاز. The content outstream position.

adType

enum ( AdType )

Output only. The ad type to target. Only applicable to insertion order targeting and new line items supporting the specified ad type will inherit this targeting option by default. مقادیر ممکن عبارتند از:

  • AD_TYPE_DISPLAY , the setting will be inherited by new line item when lineItemType is LINE_ITEM_TYPE_DISPLAY_DEFAULT .
  • AD_TYPE_VIDEO , the setting will be inherited by new line item when lineItemType is LINE_ITEM_TYPE_VIDEO_DEFAULT .

DeviceTypeAssignedTargetingOptionDetails

Targeting details for device type. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_DEVICE_TYPE .

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

enum ( DeviceType )

مورد نیاز. The display name of the device type.

youtubeAndPartnersBidMultiplier

number

Output only. Bid multiplier allows you to show your ads more or less frequently based on the device type. It will apply a multiplier on the original bid price. When this field is 0, it indicates this field is not applicable instead of multiplying 0 on the original bid price.

For example, if the bid price without multiplier is $10.0 and the multiplier is 1.5 for Tablet, the resulting bid price for Tablet will be $15.0.

Only applicable to YouTube and Partners line items.

AudienceGroupAssignedTargetingOptionDetails

Assigned audience group targeting option details. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_AUDIENCE_GROUP . The relation between each group is UNION, except for excludedFirstAndThirdPartyAudienceGroup and excludedGoogleAudienceGroup, of which COMPLEMENT is used as an INTERSECTION with other groups.

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

object ( GoogleAudienceGroup )

اختیاری. The Google audience ids of the included Google audience group. Contains Google audience ids only.

includedCustomListGroup

object ( CustomListGroup )

اختیاری. The custom list ids of the included custom list group. Contains custom list ids only.

includedCombinedAudienceGroup

object ( CombinedAudienceGroup )

اختیاری. The combined audience ids of the included combined audience group. Contains combined audience ids only.

excludedGoogleAudienceGroup

object ( GoogleAudienceGroup )

اختیاری. The Google audience ids of the excluded Google audience group. Used for negative targeting. The COMPLEMENT of the UNION of this group and other excluded audience groups is used as an INTERSECTION to any positive audience targeting. Only contains Affinity, In-market and Installed-apps type Google audiences. All items are logically 'OR' of each other.

includedFirstPartyAndPartnerAudienceGroups[]

object ( FirstPartyAndPartnerAudienceGroup )

اختیاری. The first party and partner audience ids and recencies of included first party and partner audience groups. Each first party and partner audience group contains first party and partner audience ids only. The relation between each first party and partner audience group is INTERSECTION, and the result is UNION'ed with other audience groups. Repeated groups with the same settings will be ignored.

excludedFirstPartyAndPartnerAudienceGroup

object ( FirstPartyAndPartnerAudienceGroup )

اختیاری. The first party and partner audience ids and recencies of the excluded first party and partner audience group. Used for negative targeting. The COMPLEMENT of the UNION of this group and other excluded audience groups is used as an INTERSECTION to any positive audience targeting. All items are logically 'OR' of each other.

GoogleAudienceGroup

Details of Google audience group. All Google audience targeting settings are logically 'OR' of each other.

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

object ( GoogleAudienceTargetingSetting )

مورد نیاز. All Google audience targeting settings in Google audience group. Repeated settings with the same id will be ignored.

GoogleAudienceTargetingSetting

Details of Google audience targeting setting.

JSON representation
{
  "googleAudienceId": string
}
فیلدها
googleAudienceId

string ( int64 format)

مورد نیاز. Google audience id of the Google audience targeting setting. This id is googleAudienceId .

CustomListGroup

Details of custom list group. All custom list targeting settings are logically 'OR' of each other.

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

object ( CustomListTargetingSetting )

مورد نیاز. All custom list targeting settings in custom list group. Repeated settings with the same id will be ignored.

CustomListTargetingSetting

Details of custom list targeting setting.

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

string ( int64 format)

مورد نیاز. Custom id of custom list targeting setting. This id is customListId .

CombinedAudienceGroup

Details of combined audience group. All combined audience targeting settings are logically 'OR' of each other.

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

object ( CombinedAudienceTargetingSetting )

مورد نیاز. All combined audience targeting settings in combined audience group. Repeated settings with the same id will be ignored. The number of combined audience settings should be no more than five, error will be thrown otherwise.

CombinedAudienceTargetingSetting

Details of combined audience targeting setting.

JSON representation
{
  "combinedAudienceId": string
}
فیلدها
combinedAudienceId

string ( int64 format)

مورد نیاز. Combined audience id of combined audience targeting setting. This id is combinedAudienceId .

FirstPartyAndPartnerAudienceGroup

Details of first party and partner audience group. All first party and partner audience targeting settings are logically 'OR' of each other.

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

object ( FirstPartyAndPartnerAudienceTargetingSetting )

مورد نیاز. All first party and partner audience targeting settings in first party and partner audience group. Repeated settings with the same id are not allowed.

FirstPartyAndPartnerAudienceTargetingSetting

Details of first party and partner audience targeting setting.

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

string ( int64 format)

مورد نیاز. First party and partner audience id of the first party and partner audience targeting setting. This id is firstPartyAndPartnerAudienceId .

recency

enum ( Recency )

مورد نیاز. The recency of the first party and partner audience targeting setting. Only applicable to first party audiences, otherwise will be ignored. For more info, refer to https://support.google.com/displayvideo/answer/2949947#recency When unspecified, no recency limit will be used.

تازگی

All supported first party and partner audience recency values.

Enums
RECENCY_NO_LIMIT No limit of recency.
RECENCY_1_MINUTE Recency is 1 minute.
RECENCY_5_MINUTES Recency is 5 minutes.
RECENCY_10_MINUTES Recency is 10 minutes.
RECENCY_15_MINUTES Recency is 15 minutes.
RECENCY_30_MINUTES Recency is 30 minutes.
RECENCY_1_HOUR Recency is 1 hour.
RECENCY_2_HOURS Recency is 2 hours.
RECENCY_3_HOURS Recency is 3 hours.
RECENCY_6_HOURS Recency is 6 hours.
RECENCY_12_HOURS Recency is 12 hours.
RECENCY_1_DAY Recency is 1 day.
RECENCY_2_DAYS Recency is 2 days.
RECENCY_3_DAYS Recency is 3 days.
RECENCY_5_DAYS Recency is 5 days.
RECENCY_7_DAYS Recency is 7 days.
RECENCY_10_DAYS Recency is 10 days.
RECENCY_14_DAYS Recency is 14 days.
RECENCY_15_DAYS Recency is 15 days.
RECENCY_21_DAYS Recency is 21 days.
RECENCY_28_DAYS Recency is 28 days.
RECENCY_30_DAYS Recency is 30 days.
RECENCY_40_DAYS Recency is 40 days.
RECENCY_45_DAYS Recency is 45 days.
RECENCY_60_DAYS Recency is 60 days.
RECENCY_90_DAYS Recency is 90 days.
RECENCY_120_DAYS Recency is 120 days.
RECENCY_180_DAYS Recency is 180 days.
RECENCY_270_DAYS Recency is 270 days.
RECENCY_365_DAYS Recency is 365 days.

BrowserAssignedTargetingOptionDetails

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

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

string

Output only. The display name of the browser.

targetingOptionId

string

مورد نیاز. The targetingOptionId of a TargetingOption of type TARGETING_TYPE_BROWSER .

negative

boolean

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

HouseholdIncomeAssignedTargetingOptionDetails

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

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

enum ( HouseholdIncome )

مورد نیاز. The household income of the audience.

OnScreenPositionAssignedTargetingOptionDetails

On screen position targeting option details. This will be populated in the onScreenPositionDetails field when targetingType is TARGETING_TYPE_ON_SCREEN_POSITION .

JSON representation
{
  "targetingOptionId": string,
  "onScreenPosition": enum (OnScreenPosition),
  "adType": enum (AdType)
}
فیلدها
targetingOptionId

string

مورد نیاز. The targetingOptionId field when targetingType is TARGETING_TYPE_ON_SCREEN_POSITION .

onScreenPosition

enum ( OnScreenPosition )

Output only. The on screen position.

adType

enum ( AdType )

Output only. The ad type to target. Only applicable to insertion order targeting and new line items supporting the specified ad type will inherit this targeting option by default. مقادیر ممکن عبارتند از:

  • AD_TYPE_DISPLAY , the setting will be inherited by new line item when lineItemType is LINE_ITEM_TYPE_DISPLAY_DEFAULT .
  • AD_TYPE_VIDEO , the setting will be inherited by new line item when lineItemType is LINE_ITEM_TYPE_VIDEO_DEFAULT .

CarrierAndIspAssignedTargetingOptionDetails

Details for assigned carrier and ISP targeting option. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_CARRIER_AND_ISP .

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

string

Output only. The display name of the carrier or ISP.

targetingOptionId

string

مورد نیاز. The targetingOptionId of a TargetingOption of type TARGETING_TYPE_CARRIER_AND_ISP .

negative

boolean

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

KeywordAssignedTargetingOptionDetails

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

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

string

مورد نیاز. The keyword, for example car insurance .

Positive keyword cannot be offensive word. Must be UTF-8 encoded with a maximum size of 255 bytes. Maximum number of characters is 80. Maximum number of words is 10.

negative

boolean

Indicates if this option is being negatively targeted.

NegativeKeywordListAssignedTargetingOptionDetails

Targeting details for negative keyword list. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_NEGATIVE_KEYWORD_LIST .

JSON representation
{
  "negativeKeywordListId": string
}
فیلدها
negativeKeywordListId

string ( int64 format)

مورد نیاز. ID of the negative keyword list. Should refer to the negativeKeywordListId field of a NegativeKeywordList resource.

OperatingSystemAssignedTargetingOptionDetails

Assigned operating system targeting option details. This will be populated in the operatingSystemDetails field when targetingType is TARGETING_TYPE_OPERATING_SYSTEM .

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

string

Output only. The display name of the operating system.

targetingOptionId

string

مورد نیاز. The targeting option ID populated in targetingOptionId field when targetingType is TARGETING_TYPE_OPERATING_SYSTEM .

negative

boolean

Indicates if this option is being negatively targeted.

DeviceMakeModelAssignedTargetingOptionDetails

Assigned device make and model targeting option details. This will be populated in the deviceMakeModelDetails field when targetingType is TARGETING_TYPE_DEVICE_MAKE_MODEL .

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

string

Output only. The display name of the device make and model.

targetingOptionId

string

مورد نیاز. The targetingOptionId field when targetingType is TARGETING_TYPE_DEVICE_MAKE_MODEL .

negative

boolean

Indicates if this option is being negatively targeted.

EnvironmentAssignedTargetingOptionDetails

Assigned environment targeting option details. This will be populated in the details field of an AssignedTargetingOption when targetingType is TARGETING_TYPE_ENVIRONMENT .

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

enum ( Environment )

مورد نیاز. The serving environment.

InventorySourceAssignedTargetingOptionDetails

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

JSON representation
{
  "inventorySourceId": string
}
فیلدها
inventorySourceId

string ( int64 format)

مورد نیاز. ID of the inventory source. Should refer to the inventorySourceId field of an InventorySource resource.

CategoryAssignedTargetingOptionDetails

Assigned category targeting option details. This will be populated in the categoryDetails field when targetingType is TARGETING_TYPE_CATEGORY .

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

string

Output only. The display name of the category.

targetingOptionId

string

مورد نیاز. The targetingOptionId field when targetingType is TARGETING_TYPE_CATEGORY .

negative

boolean

Indicates if this option is being negatively targeted.

ViewabilityAssignedTargetingOptionDetails

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

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

enum ( Viewability )

مورد نیاز. 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 representation
{
  "authorizedSellerStatus": enum (AuthorizedSellerStatus),
  "targetingOptionId": string
}
فیلدها
authorizedSellerStatus

enum ( AuthorizedSellerStatus )

Output only. The authorized seller status to target.

targetingOptionId

string

مورد نیاز. 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 representation
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
فیلدها
displayName

string

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

targetingOptionId

string

مورد نیاز. 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 representation
{
  "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

مورد نیاز. 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 representation
{
  "inventorySourceGroupId": string
}
فیلدها
inventorySourceGroupId

string ( int64 format)

مورد نیاز. 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 representation
{
  "excludedContentRatingTier": enum (ContentRatingTier)
}
فیلدها
excludedContentRatingTier

enum ( ContentRatingTier )

مورد نیاز. 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 representation
{
  "excludedSensitiveCategory": enum (SensitiveCategory)
}
فیلدها
excludedSensitiveCategory

enum ( SensitiveCategory )

مورد نیاز. 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 representation
{
  "excludedTargetingOptionId": string,
  "contentTheme": enum (ContentTheme),
  "excludedContentTheme": enum (ContentTheme)
}
فیلدها
excludedTargetingOptionId

string

مورد نیاز. ID of the content theme to be EXCLUDED.

contentTheme

enum ( ContentTheme )

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

excludedContentTheme

enum ( ContentTheme )

مورد نیاز. 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 representation
{
  "exchange": enum (Exchange)
}
فیلدها
exchange

enum ( Exchange )

مورد نیاز. 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 representation
{
  "targetingOptionId": string
}
فیلدها
targetingOptionId

string

مورد نیاز. 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 representation
{

  // 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 representation
{
  "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 )

اختیاری. Scope3's fraud IVT MFA categories to exclude.

adultExplicitSexualContent

enum ( GarmRiskExclusion )

اختیاری. Adult and Explicit Sexual Content GARM risk ranges to exclude.

crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent

enum ( GarmRiskExclusion )

اختیاری. Crime and Harmful Acts Content GARM risk ranges to exclude.

armsAmmunitionContent

enum ( GarmRiskExclusion )

اختیاری. Arms and Ammunition Content GARM risk ranges to exclude.

deathInjuryMilitaryConflictContent

enum ( GarmRiskExclusion )

اختیاری. Death, Injury, or Military Conflict Content GARM risk ranges to exclude.

debatedSensitiveSocialIssueContent

enum ( GarmRiskExclusion )

اختیاری. Debated Sensitive Social Issue Content GARM risk ranges to exclude.

illegalDrugsTobaccoEcigarettesVapingAlcoholContent

enum ( GarmRiskExclusion )

اختیاری. Illegal Drugs/Alcohol Content GARM risk ranges to exclude.

onlinePiracyContent

enum ( GarmRiskExclusion )

اختیاری. Online Piracy Content GARM risk ranges to exclude.

hateSpeechActsAggressionContent

enum ( GarmRiskExclusion )

اختیاری. Hate Speech and Acts of Aggression Content GARM risk ranges to exclude.

obscenityProfanityContent

enum ( GarmRiskExclusion )

اختیاری. Obscenity and Profanity Content GARM risk ranges to exclude.

spamHarmfulContent

enum ( GarmRiskExclusion )

اختیاری. Spam or Harmful Content GARM risk ranges to exclude.

terrorismContent

enum ( GarmRiskExclusion )

اختیاری. Terrorism Content GARM risk ranges to exclude.

misinformationContent

enum ( GarmRiskExclusion )

اختیاری. Misinformation Content GARM risk ranges to exclude.

displayIabViewability

enum ( DisplayIabViewability )

اختیاری. IAB viewability threshold for display ads.

videoIabViewability

enum ( VideoIabViewability )

اختیاری. IAB viewability threshold for video ads.

AdlooxCategory

Available Scope3 (previously known as Adloox) categories.

Enums
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 تقلب

FraudIvtMfaCategory

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

Enums
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.

Enums
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.

Enums
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.

Enums
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).

DoubleVerify

Details of DoubleVerify settings.

JSON representation
{
  "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 representation
{
  "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.

Enums
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 نقض حق چاپ
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.

Enums
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.

Enums
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 representation
{
  "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.

Enums
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 representation
{
  "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.

IAB

Possible options for IAB viewable rate.

Enums
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.

Enums
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 representation
{
  "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.

Enums
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.

Enums
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.

Enums
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 representation
{
  "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.

Enums
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 representation
{
  "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)

اختیاری. 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.

Enums
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.

Enums
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.

Enums
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.

Enums
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.

Enums
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.

Enums
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.

Enums
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.

Enums
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.

Enums
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.

Enums
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.

DisplayViewability

Possible Integral Ad Science Display viewability options.

Enums
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.

Enums
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 representation
{
  "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

مورد نیاز. 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

مورد نیاز. 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 )

مورد نیاز. The unit of distance by which the targeting radius is measured.

DistanceUnit

Possible distance unit options.

Enums
DISTANCE_UNIT_UNSPECIFIED Type value is not specified or is unknown in this version.
DISTANCE_UNIT_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 representation
{
  "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

مورد نیاز. The targetingOptionId of a TargetingOption of type TARGETING_TYPE_BUSINESS_CHAIN .

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

proximityRadiusAmount

number

مورد نیاز. 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 )

مورد نیاز. 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 representation
{
  "targetingOptionId": string,
  "contentDuration": enum (ContentDuration)
}
فیلدها
targetingOptionId

string

مورد نیاز. 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 representation
{
  "targetingOptionId": string,
  "contentStreamType": enum (ContentStreamType)
}
فیلدها
targetingOptionId

string

مورد نیاز. 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 representation
{
  "contentPosition": enum (NativeContentPosition)
}
فیلدها
contentPosition

enum ( NativeContentPosition )

مورد نیاز. 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 representation
{
  "omid": enum (Omid)
}
فیلدها
omid

enum ( Omid )

مورد نیاز. 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 representation
{
  "audioContentType": enum (AudioContentType)
}
فیلدها
audioContentType

enum ( AudioContentType )

مورد نیاز. 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 representation
{
  "targetingOptionId": string,
  "displayName": string,
  "negative": boolean
}
فیلدها
targetingOptionId

string

مورد نیاز. 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 representation
{
  "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 representation
{
  "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.

Enums
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.