REST Resource: targetingTypes.targetingOptions

منبع: TargetingOption

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

نمایندگی JSON
{
  "name": string,
  "targetingOptionId": string,
  "targetingType": enum (TargetingType),

  // Union field details can be only one of the following:
  "digitalContentLabelDetails": {
    object (DigitalContentLabelTargetingOptionDetails)
  },
  "sensitiveCategoryDetails": {
    object (SensitiveCategoryTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreTargetingOptionDetails)
  }
  // End of list of possible types for union field details.
}
فیلدها
name

string

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

targeting Option Id

string

فقط خروجی یک شناسه منحصر به فرد برای این گزینه هدف گیری. تاپل { targetingType , targetingOptionId } منحصر به فرد خواهد بود.

targeting Type

enum ( TargetingType )

فقط خروجی نوع این گزینه هدف گیری.

details فیلد اتحادیه اطلاعات دقیق در مورد گزینه های هدف گیری. فقط یک فیلد با جزئیات ممکن است پر شود و باید با targeting_type مطابقت داشته باشد. details فقط می تواند یکی از موارد زیر باشد:
digital Content Label Details

object ( DigitalContentLabelTargetingOptionDetails )

جزئیات برچسب محتوای دیجیتال

sensitive Category Details

object ( SensitiveCategoryTargetingOptionDetails )

جزئیات رده حساس

app Category Details

object ( AppCategoryTargetingOptionDetails )

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

on Screen Position Details

object ( OnScreenPositionTargetingOptionDetails )

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

content Outstream Position Details

object ( ContentOutstreamPositionTargetingOptionDetails )

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

content Instream Position Details

object ( ContentInstreamPositionTargetingOptionDetails )

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

video Player Size Details

object ( VideoPlayerSizeTargetingOptionDetails )

جزئیات اندازه پخش کننده ویدیو

age Range Details

object ( AgeRangeTargetingOptionDetails )

جزئیات محدوده سنی

parental Status Details

object ( ParentalStatusTargetingOptionDetails )

جزئیات وضعیت والدین

user Rewarded Content Details

object ( UserRewardedContentTargetingOptionDetails )

جزئیات محتوای پاداش داده شده توسط کاربر

household Income Details

object ( HouseholdIncomeTargetingOptionDetails )

جزئیات درآمد خانوار

gender Details

object ( GenderTargetingOptionDetails )

جزئیات جنسیت

device Type Details

object ( DeviceTypeTargetingOptionDetails )

جزئیات نوع دستگاه

browser Details

object ( BrowserTargetingOptionDetails )

جزئیات مرورگر

carrier And Isp Details

object ( CarrierAndIspTargetingOptionDetails )

جزئیات اپراتور و ISP.

environment Details

object ( EnvironmentTargetingOptionDetails )

جزئیات محیطی

operating System Details

object ( OperatingSystemTargetingOptionDetails )

جزئیات منابع سیستم عامل

device Make Model Details

object ( DeviceMakeModelTargetingOptionDetails )

جزئیات منبع ساخت و مدل دستگاه

viewability Details

object ( ViewabilityTargetingOptionDetails )

جزئیات منبع قابلیت مشاهده

category Details

object ( CategoryTargetingOptionDetails )

جزئیات منابع دسته

language Details

object ( LanguageTargetingOptionDetails )

جزئیات منبع زبان

authorized Seller Status Details

object ( AuthorizedSellerStatusTargetingOptionDetails )

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

geo Region Details

object ( GeoRegionTargetingOptionDetails )

جزئیات منابع منطقه جغرافیایی

exchange Details

object ( ExchangeTargetingOptionDetails )

تبادل جزئیات

sub Exchange Details

object ( SubExchangeTargetingOptionDetails )

جزئیات بورس فرعی

poi Details

object ( PoiTargetingOptionDetails )

جزئیات منبع POI

business Chain Details

object ( BusinessChainTargetingOptionDetails )

جزئیات منابع زنجیره کسب و کار

content Duration Details

object ( ContentDurationTargetingOptionDetails )

جزئیات منبع مدت زمان محتوا

content Stream Type Details

object ( ContentStreamTypeTargetingOptionDetails )

جزئیات منبع نوع جریان محتوا.

native Content Position Details

object ( NativeContentPositionTargetingOptionDetails )

جزئیات موقعیت محتوای بومی

omid Details

object ( OmidTargetingOptionDetails )

جزئیات موجودی را با قابلیت اندازه‌گیری باز کنید.

audio Content Type Details

object ( AudioContentTypeTargetingOptionDetails )

جزئیات نوع محتوای صوتی

content Genre Details

object ( ContentGenreTargetingOptionDetails )

جزئیات منبع ژانر محتوا

DigitalContentLabelTargetingOptionDetails

نشان دهنده یک ردیف رتبه بندی برچسب محتوای دیجیتال قابل هدف است. هنگامی که targetingType TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION باشد، در قسمت digitalContentLabelDetails در TargetingOption پر می شود.

نمایندگی JSON
{
  "contentRatingTier": enum (ContentRatingTier)
}
فیلدها
content Rating Tier

enum ( ContentRatingTier )

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

SensitiveCategoryTargetingOptionDetails

یک دسته حساس قابل هدف را نشان می دهد. زمانی که targetingType TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION باشد، در قسمت sensitiveCategoryDetails در TargetingOption پر می شود.

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

enum ( SensitiveCategory )

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

AppCategoryTargetingOptionDetails

مجموعه ای قابل هدف از برنامه ها را نشان می دهد. مجموعه‌ای به شما امکان می‌دهد گروه‌های پویا از برنامه‌های مرتبط را که توسط پلتفرم نگهداری می‌شوند، هدف قرار دهید، برای مثال All Apps/Google Play/Games . هنگامی که targetingType TARGETING_TYPE_APP_CATEGORY باشد، در قسمت appCategoryDetails پر می شود.

نمایندگی JSON
{
  "displayName": string
}
فیلدها
display Name

string

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

OnScreenPositionTargetingOptionDetails

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

نمایندگی JSON
{
  "onScreenPosition": enum (OnScreenPosition)
}
فیلدها
on Screen Position

enum ( OnScreenPosition )

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

ContentOutstreamPositionTargetingOptionDetails

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

نمایندگی JSON
{
  "contentOutstreamPosition": enum (ContentOutstreamPosition)
}
فیلدها
content Outstream Position

enum ( ContentOutstreamPosition )

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

ContentInstreamPositionTargetingOptionDetails

نشان دهنده یک موقعیت محتوای قابل هدف در جریان است که می تواند توسط تبلیغات ویدیویی و صوتی استفاده شود. هنگامی که targetingType TARGETING_TYPE_CONTENT_INSTREAM_POSITION باشد، در قسمت contentInstreamPositionDetails پر می‌شود.

نمایندگی JSON
{
  "contentInstreamPosition": enum (ContentInstreamPosition)
}
فیلدها
content Instream Position

enum ( ContentInstreamPosition )

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

VideoPlayerSizeTargetingOptionDetails

اندازه پخش کننده ویدیویی قابل هدف را نشان می دهد. زمانی که targetingType TARGETING_TYPE_VIDEO_PLAYER_SIZE باشد، در قسمت videoPlayerSizeDetails پر می شود.

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

enum ( VideoPlayerSize )

فقط خروجی اندازه پخش کننده ویدیو

AgeRangeTargetingOptionDetails

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

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

enum ( AgeRange )

فقط خروجی محدوده سنی مخاطب

ParentalStatusTargetingOptionDetails

وضعیت والدین قابل هدف را نشان می دهد. هنگامی که targetingType TARGETING_TYPE_PARENTAL_STATUS باشد، در قسمت parentalStatusDetails یک TargetingOption پر می شود.

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

enum ( ParentalStatus )

فقط خروجی وضعیت والدین یک مخاطب.

UserRewardedContentTargetingOptionDetails

نشان‌دهنده وضعیت محتوای پاداش‌دهی شده کاربر قابل هدف فقط برای تبلیغات ویدیویی است. زمانی که targetingType TARGETING_TYPE_USER_REWARDED_CONTENT باشد، در قسمت userRewardedContentDetails پر می شود.

نمایندگی JSON
{
  "userRewardedContent": enum (UserRewardedContent)
}
فیلدها
user Rewarded Content

enum ( UserRewardedContent )

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

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

نشان دهنده درآمد قابل هدف خانوار است. زمانی که targetingType TARGETING_TYPE_HOUSEHOLD_INCOME باشد، این در قسمت householdIncomeDetails یک TargetingOption پر می‌شود.

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

enum ( HouseholdIncome )

فقط خروجی درآمد خانوار مخاطب

جزئیات گزینه جنسیت Targeting

نشان دهنده یک جنسیت قابل هدف است. هنگامی که targetingType TARGETING_TYPE_GENDER باشد، در قسمت genderDetails یک TargetingOption پر می شود.

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

enum ( Gender )

فقط خروجی جنسیت مخاطب

DeviceTypeTargetingOptionDetails

یک نوع دستگاه قابل هدف را نشان می دهد. هنگامی که targetingType TARGETING_TYPE_DEVICE_TYPE باشد، در قسمت deviceTypeDetails یک TargetingOption پر می شود.

نمایندگی JSON
{
  "deviceType": enum (DeviceType)
}
فیلدها
device Type

enum ( DeviceType )

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

BrowserTargetingOptionDetails

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

نمایندگی JSON
{
  "displayName": string
}
فیلدها
display Name

string

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

CarrierAndIspTargetingOptionDetails

نشان دهنده یک حامل یا ISP قابل هدف است. هنگامی که targetingType TARGETING_TYPE_CARRIER_AND_ISP باشد، در قسمت carrierAndIspDetails یک TargetingOption پر می شود.

نمایندگی JSON
{
  "displayName": string,
  "type": enum (CarrierAndIspType)
}
فیلدها
display Name

string

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

type

enum ( CarrierAndIspType )

فقط خروجی نوع نشان می دهد که حامل یا ISP است.

CarrierAndIspType

نوع CarrierAndIspTargetingOption.

Enums
CARRIER_AND_ISP_TYPE_UNSPECIFIED مقدار پیش‌فرض زمانی که نوع در این نسخه مشخص نشده است یا ناشناخته است.
CARRIER_AND_ISP_TYPE_ISP نشان می دهد که این منبع هدف به یک ISP اشاره دارد.
CARRIER_AND_ISP_TYPE_CARRIER نشان می دهد که این منبع هدف به یک شرکت مخابراتی تلفن همراه اشاره دارد.

EnvironmentTargetingOptionDetails

یک محیط قابل هدف را نشان می دهد. هنگامی که targetingType TARGETING_TYPE_ENVIRONMENT باشد، این در فیلد environmentDetails یک TargetingOption پر می شود.

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

enum ( Environment )

فقط خروجی محیط خدمت.

OperatingSystemTargetingOptionDetails

یک سیستم عامل قابل هدف را نشان می دهد. هنگامی که targetingType TARGETING_TYPE_OPERATING_SYSTEM باشد، در قسمت operatingSystemDetails یک TargetingOption پر می شود.

نمایندگی JSON
{
  "displayName": string
}
فیلدها
display Name

string

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

DeviceMakeModelTargetingOptionDetails

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

نمایندگی JSON
{
  "displayName": string
}
فیلدها
display Name

string

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

ViewabilityTargetingOptionDetails

نمایانگر قابلیت مشاهده قابل هدف است. هنگامی که targetingType TARGETING_TYPE_VIEWABILITY باشد، در قسمت viewabilityDetails یک TargetingOption پر می شود.

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

enum ( Viewability )

فقط خروجی درصد قابل مشاهده پیش بینی شده

CategoryTargetingOptionDetails

یک دسته قابل هدف را نشان می دهد. هنگامی که targetingType TARGETING_TYPE_CATEGORY باشد، در قسمت categoryDetails یک TargetingOption پر می شود.

نمایندگی JSON
{
  "displayName": string
}
فیلدها
display Name

string

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

LanguageTargetingOptionDetails

یک زبان قابل هدف را نشان می دهد. وقتی targetingType TARGETING_TYPE_LANGUAGE باشد، در قسمت languageDetails پر می‌شود.

نمایندگی JSON
{
  "displayName": string
}
فیلدها
display Name

string

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

AuthorizedSellerStatusTargetingOptionDetails

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

نمایندگی JSON
{
  "authorizedSellerStatus": enum (AuthorizedSellerStatus)
}
فیلدها
authorized Seller Status

enum ( AuthorizedSellerStatus )

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

جزئیات گزینه GeoRegionTargeting

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

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

string

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

geo Region Type

enum ( GeoRegionType )

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

ExchangeTargetingOptionDetails

یک مبادله قابل هدف را نشان می دهد. هنگامی که targetingType TARGETING_TYPE_EXCHANGE باشد، در قسمت exchangeDetails یک TargetingOption پر می شود.

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

enum ( Exchange )

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

SubExchangeTargetingOptionDetails

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

نمایندگی JSON
{
  "displayName": string
}
فیلدها
display Name

string

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

PoiTargetingOptionDetails

یک نقطه مورد نظر قابل هدف (POI) را نشان می دهد. زمانی که targetingType TARGETING_TYPE_POI باشد، در قسمت poiDetails پر می شود.

نمایندگی JSON
{
  "latitude": number,
  "longitude": number,
  "displayName": string
}
فیلدها
latitude

number

فقط خروجی عرض جغرافیایی POI به رقم ششم اعشار گرد می شود.

longitude

number

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

display Name

string

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

جزئیات گزینه BusinessChainTargeting

نشان دهنده یک زنجیره تجاری قابل هدف در یک منطقه جغرافیایی است. زمانی که targetingType TARGETING_TYPE_BUSINESS_CHAIN ​​باشد، در قسمت businessChainDetails پر می‌شود.

نمایندگی JSON
{
  "businessChain": string,
  "geoRegion": string,
  "geoRegionType": enum (GeoRegionType)
}
فیلدها
business Chain

string

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

geo Region

string

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

geo Region Type

enum ( GeoRegionType )

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

ContentDurationTargetingOptionDetails

مدت زمان محتوای قابل هدف را نشان می دهد. زمانی که targetingType TARGETING_TYPE_CONTENT_DURATION باشد، در قسمت contentDurationDetails پر می‌شود.

نمایندگی JSON
{
  "contentDuration": enum (ContentDuration)
}
فیلدها
content Duration

enum ( ContentDuration )

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

ContentStreamTypeTargetingOptionDetails

یک نوع جریان محتوای قابل هدف را نشان می دهد. زمانی که targetingType TARGETING_TYPE_CONTENT_STREAM_TYPE باشد، در قسمت contentStreamTypeDetails پر می شود.

نمایندگی JSON
{
  "contentStreamType": enum (ContentStreamType)
}
فیلدها
content Stream Type

enum ( ContentStreamType )

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

NativeContentPositionTargetingOptionDetails

یک موقعیت محتوای بومی قابل هدف را نشان می دهد. هنگامی که targetingType TARGETING_TYPE_NATIVE_CONTENT_POSITION باشد، در قسمت nativeContentPositionDetails پر می شود.

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

enum ( NativeContentPosition )

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

OmidTargetingOptionDetails

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

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

enum ( Omid )

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

AudioContentTypeTargetingOptionDetails

یک نوع محتوای صوتی قابل هدف را نشان می دهد. زمانی که targetingType TARGETING_TYPE_AUDIO_CONTENT_TYPE باشد، در قسمت audioContentTypeDetails پر می شود.

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

enum ( AudioContentType )

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

ContentGenreTargetingOptionDetails

یک ژانر محتوای قابل هدف را نشان می دهد. زمانی که targetingType TARGETING_TYPE_CONTENT_GENRE باشد، در قسمت contentGenreDetails پر می شود.

نمایندگی JSON
{
  "displayName": string
}
فیلدها
display Name

string

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

روش ها

get

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

list

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