REST Resource: advertisers.insertionOrders.targetingTypes.assignedTargetingOptions

منبع: AssignedTargetingOption

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

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

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

string

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

assignedTargetingOptionId

string

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

assignedTargetingOptionIdAlias

string

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

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

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

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

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum ( TargetingType )

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

inheritance

enum ( Inheritance )

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

details فیلد Union. اطلاعات دقیق در مورد گزینه هدف‌گیری اختصاص داده شده. فقط یک فیلد در details می‌تواند پر شود و باید با targeting_type مطابقت داشته باشد؛ details فقط می‌تواند یکی از موارد زیر باشد:
channelDetails

object ( ChannelAssignedTargetingOptionDetails )

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

appCategoryDetails

object ( AppCategoryAssignedTargetingOptionDetails )

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

appDetails

object ( AppAssignedTargetingOptionDetails )

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

urlDetails

object ( UrlAssignedTargetingOptionDetails )

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

dayAndTimeDetails

object ( DayAndTimeAssignedTargetingOptionDetails )

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

ageRangeDetails

object ( AgeRangeAssignedTargetingOptionDetails )

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

regionalLocationListDetails

object ( RegionalLocationListAssignedTargetingOptionDetails )

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

proximityLocationListDetails

object ( ProximityLocationListAssignedTargetingOptionDetails )

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

genderDetails

object ( GenderAssignedTargetingOptionDetails )

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

videoPlayerSizeDetails

object ( VideoPlayerSizeAssignedTargetingOptionDetails )

Video player size details. This field will be populated when the targetingType is TARGETING_TYPE_VIDEO_PLAYER_SIZE .

userRewardedContentDetails

object ( UserRewardedContentAssignedTargetingOptionDetails )

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

parentalStatusDetails

object ( ParentalStatusAssignedTargetingOptionDetails )

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

contentInstreamPositionDetails

object ( ContentInstreamPositionAssignedTargetingOptionDetails )

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

contentOutstreamPositionDetails

object ( ContentOutstreamPositionAssignedTargetingOptionDetails )

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

deviceTypeDetails

object ( DeviceTypeAssignedTargetingOptionDetails )

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

audienceGroupDetails

object ( AudienceGroupAssignedTargetingOptionDetails )

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

browserDetails

object ( BrowserAssignedTargetingOptionDetails )

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

householdIncomeDetails

object ( HouseholdIncomeAssignedTargetingOptionDetails )

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

onScreenPositionDetails

object ( OnScreenPositionAssignedTargetingOptionDetails )

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

carrierAndIspDetails

object ( CarrierAndIspAssignedTargetingOptionDetails )

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

keywordDetails

object ( KeywordAssignedTargetingOptionDetails )

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

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

negativeKeywordListDetails

object ( NegativeKeywordListAssignedTargetingOptionDetails )

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

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

operatingSystemDetails

object ( OperatingSystemAssignedTargetingOptionDetails )

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

deviceMakeModelDetails

object ( DeviceMakeModelAssignedTargetingOptionDetails )

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

environmentDetails

object ( EnvironmentAssignedTargetingOptionDetails )

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

inventorySourceDetails

object ( InventorySourceAssignedTargetingOptionDetails )

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

categoryDetails

object ( CategoryAssignedTargetingOptionDetails )

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

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

viewabilityDetails

object ( ViewabilityAssignedTargetingOptionDetails )

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

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

authorizedSellerStatusDetails

object ( AuthorizedSellerStatusAssignedTargetingOptionDetails )

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

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

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

languageDetails

object ( LanguageAssignedTargetingOptionDetails )

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

geoRegionDetails

object ( GeoRegionAssignedTargetingOptionDetails )

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

inventorySourceGroupDetails

object ( InventorySourceGroupAssignedTargetingOptionDetails )

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

digitalContentLabelExclusionDetails

object ( DigitalContentLabelAssignedTargetingOptionDetails )

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

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

sensitiveCategoryExclusionDetails

object ( SensitiveCategoryAssignedTargetingOptionDetails )

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

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

contentThemeExclusionDetails

object ( ContentThemeAssignedTargetingOptionDetails )

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

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

exchangeDetails

object ( ExchangeAssignedTargetingOptionDetails )

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

subExchangeDetails

object ( SubExchangeAssignedTargetingOptionDetails )

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

thirdPartyVerifierDetails

object ( ThirdPartyVerifierAssignedTargetingOptionDetails )

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

poiDetails

object ( PoiAssignedTargetingOptionDetails )

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

businessChainDetails

object ( BusinessChainAssignedTargetingOptionDetails )

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

contentDurationDetails

object ( ContentDurationAssignedTargetingOptionDetails )

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

contentStreamTypeDetails

object ( ContentStreamTypeAssignedTargetingOptionDetails )

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

nativeContentPositionDetails

object ( NativeContentPositionAssignedTargetingOptionDetails )

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

omidDetails

object ( OmidAssignedTargetingOptionDetails )

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

audioContentTypeDetails

object ( AudioContentTypeAssignedTargetingOptionDetails )

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

contentGenreDetails

object ( ContentGenreAssignedTargetingOptionDetails )

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

youtubeVideoDetails

object ( YoutubeVideoAssignedTargetingOptionDetails )

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

youtubeChannelDetails

object ( YoutubeChannelAssignedTargetingOptionDetails )

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

sessionPositionDetails

object ( SessionPositionAssignedTargetingOptionDetails )

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

روش‌ها

create

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

delete

 یک گزینه هدف‌گیری اختصاص داده شده را از ترتیب درج حذف می‌کند.

get

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

list

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