REST Resource: advertisers.targetingTypes.assignedTargetingOptions

منبع: AssignedTargetingOption

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

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

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

string

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

assignedTargetingOptionId

string

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

assignedTargetingOptionIdAlias

string

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

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

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

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

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum ( TargetingType )

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

inheritance

enum ( Inheritance )

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

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

object ( ChannelAssignedTargetingOptionDetails )

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

appCategoryDetails

object ( AppCategoryAssignedTargetingOptionDetails )

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

appDetails

object ( AppAssignedTargetingOptionDetails )

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

urlDetails

object ( UrlAssignedTargetingOptionDetails )

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

dayAndTimeDetails

object ( DayAndTimeAssignedTargetingOptionDetails )

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

ageRangeDetails

object ( AgeRangeAssignedTargetingOptionDetails )

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

regionalLocationListDetails

object ( RegionalLocationListAssignedTargetingOptionDetails )

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

proximityLocationListDetails

object ( ProximityLocationListAssignedTargetingOptionDetails )

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

genderDetails

object ( GenderAssignedTargetingOptionDetails )

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

videoPlayerSizeDetails

object ( VideoPlayerSizeAssignedTargetingOptionDetails )

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

userRewardedContentDetails

object ( UserRewardedContentAssignedTargetingOptionDetails )

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

parentalStatusDetails

object ( ParentalStatusAssignedTargetingOptionDetails )

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

contentInstreamPositionDetails

object ( ContentInstreamPositionAssignedTargetingOptionDetails )

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

contentOutstreamPositionDetails

object ( ContentOutstreamPositionAssignedTargetingOptionDetails )

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

deviceTypeDetails

object ( DeviceTypeAssignedTargetingOptionDetails )

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

audienceGroupDetails

object ( AudienceGroupAssignedTargetingOptionDetails )

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

browserDetails

object ( BrowserAssignedTargetingOptionDetails )

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

householdIncomeDetails

object ( HouseholdIncomeAssignedTargetingOptionDetails )

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

onScreenPositionDetails

object ( OnScreenPositionAssignedTargetingOptionDetails )

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

carrierAndIspDetails

object ( CarrierAndIspAssignedTargetingOptionDetails )

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

keywordDetails

object ( KeywordAssignedTargetingOptionDetails )

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

حداکثر 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 باشد.

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

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 باشد، این فیلد پر می شود.

روش ها

create

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

delete

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

get

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

list

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