REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

منبع: AssignedTargetingOption

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

نمایندگی JSON
{
  "name": string,
  "assignedTargetingOptionId": 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)
  }
  // End of list of possible types for union field details.
}
فیلدها
name

string

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

assignedTargetingOptionId

string

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

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

ارث

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

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 است که به صراحت در جای دیگری فهرست نشده است.

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),
  "targetingOptionId": string
}
فیلدها
ageRange

enum ( AgeRange )

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

خروجی فقط در v1. مورد نیاز در v2.

targetingOptionId

string

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

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,
  "proximityRadiusRange": enum (ProximityRadiusRange)
}
فیلدها
proximityLocationListId

string ( int64 format)

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

proximityRadiusRange

enum ( ProximityRadiusRange )

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

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

محدوده شعاع نزدیکی

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

Enums
PROXIMITY_RADIUS_RANGE_UNSPECIFIED محدوده شعاع هدف مشخص نشده یا ناشناخته است. مقدار پیش فرض زمانی که محدوده شعاع در این نسخه مشخص نشده است. این enum یک مکان نگهدار برای مقدار پیش فرض است و گزینه محدوده شعاع واقعی را نشان نمی دهد.
PROXIMITY_RADIUS_RANGE_SMALL محدوده شعاع هدف کوچک است.
PROXIMITY_RADIUS_RANGE_MEDIUM محدوده شعاع هدف متوسط ​​است.
PROXIMITY_RADIUS_RANGE_LARGE محدوده شعاع هدف بزرگ است.

Details GenderAssignedTargetingOption

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

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

enum ( Gender )

جنسیت مخاطب.

خروجی فقط در v1. مورد نیاز در v2.

targetingOptionId

string

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

VideoPlayerSizeAssignedTargetingOptionDetails

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

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

string

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

videoPlayerSize

enum ( VideoPlayerSize )

اندازه پخش کننده ویدیو

خروجی فقط در v1. مورد نیاز در v2.

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),
  "targetingOptionId": string
}
فیلدها
parentalStatus

enum ( ParentalStatus )

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

خروجی فقط در v1. مورد نیاز در v2.

targetingOptionId

string

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

ContentInstreamPositionAssignedTargetingOptionDetails

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

نمایندگی JSON
{
  "targetingOptionId": string,
  "contentInstreamPosition": enum (ContentInstreamPosition),
  "adType": enum (AdType)
}
فیلدها
targetingOptionId

string

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

contentInstreamPosition

enum ( ContentInstreamPosition )

موقعیت محتوای درون جریان برای تبلیغات ویدیویی یا صوتی.

خروجی فقط در v1. مورد نیاز در v2.

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
{
  "targetingOptionId": string,
  "contentOutstreamPosition": enum (ContentOutstreamPosition),
  "adType": enum (AdType)
}
فیلدها
targetingOptionId

string

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

contentOutstreamPosition

enum ( ContentOutstreamPosition )

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

خروجی فقط در v1. مورد نیاز در v2.

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
{
  "targetingOptionId": string,
  "deviceType": enum (DeviceType)
}
فیلدها
targetingOptionId

string

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

deviceType

enum ( DeviceType )

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

خروجی فقط در v1. مورد نیاز در v2.

AudienceGroupAssignedTargetingOptionDetails

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

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

object ( FirstAndThirdPartyAudienceGroup )

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

includedGoogleAudienceGroup

object ( GoogleAudienceGroup )

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

includedCustomListGroup

object ( CustomListGroup )

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

includedCombinedAudienceGroup

object ( CombinedAudienceGroup )

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

excludedFirstAndThirdPartyAudienceGroup

object ( FirstAndThirdPartyAudienceGroup )

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

excludedGoogleAudienceGroup

object ( GoogleAudienceGroup )

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

FirstAndThirdPartyAudienceGroup

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

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

object ( FirstAndThirdPartyAudienceTargetingSetting )

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

FirstAndThirdPartyAudienceTargetingSetting

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

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

string ( int64 format)

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

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 روز است.

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 است.

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),
  "targetingOptionId": string
}
فیلدها
householdIncome

enum ( HouseholdIncome )

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

خروجی فقط در v1. مورد نیاز در v2.

targetingOptionId

string

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

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),
  "targetingOptionId": string
}
فیلدها
environment

enum ( Environment )

محیط خدمت.

خروجی فقط در v1. مورد نیاز در v2.

targetingOptionId

string

مورد نیاز. targetingOptionId یک TargetingOption از نوع TARGETING_TYPE_ENVIRONMENT (به عنوان مثال، "508010" برای هدف قرار دادن گزینه ENVIRONMENT_WEB_OPTIMIZED ).

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),
  "targetingOptionId": string
}
فیلدها
viewability

enum ( Viewability )

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

خروجی فقط در v1. مورد نیاز در v2.

targetingOptionId

string

مورد نیاز. targetingOptionId یک TargetingOption از نوع TARGETING_TYPE_VIEWABILITY (به عنوان مثال، "509010" برای هدف قرار دادن گزینه VIEWABILITY_10_PERCENT_OR_MORE ).

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 باشد، در قسمت جزئیات یک AssignedTargetingOption پر می شود.

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

string

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

targetingOptionId

string

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

negative

boolean

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

GeoRegionAssignedTargetingOptionDetails

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

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

string

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

targetingOptionId

string

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

geoRegionType

enum ( GeoRegionType )

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

negative

boolean

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

InventorySourceGroupAssignedTargetingOptionDetails

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

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

string ( int64 format)

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

DigitalContentLabelAssignedTargetingOptionDetails

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

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

string

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

contentRatingTier

enum ( ContentRatingTier )

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

SensitiveCategoryAssignedTargetingOptionDetails

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

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

string

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

sensitiveCategory

enum ( SensitiveCategory )

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

ExchangeAssignedTargetingOptionDetails

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

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

string

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

SubExchangeAssignedTargetingOptionDetails

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

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

string

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

ThirdPartyVerifierAssignedTargetingOptionDetails

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

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

تأیید کننده برند شخص ثالث - Adloox.

doubleVerify

object ( DoubleVerify )

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

integralAdScience

object ( IntegralAdScience )

تأیید کننده برند شخص ثالث - علم تبلیغات یکپارچه.

Adloox

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

نمایندگی JSON
{
  "excludedAdlooxCategories": [
    enum (AdlooxCategory)
  ]
}
فیلدها
excludedAdlooxCategories[]

enum ( AdlooxCategory )

تنظیمات ایمنی برند Adloox.

Adloox Category

گزینه های ممکن Adloox

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

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" شروع شود و شامل هشت رقم باشد. شناسه بخش سفارشی را نمی توان همراه با هیچ یک از فیلدهای زیر مشخص کرد:

دسته بندی های ایمنی برند

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

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

boolean

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

avoidedHighSeverityCategories[]

enum ( HighSeverityCategory )

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

avoidedMediumSeverityCategories[]

enum ( MediumSeverityCategory )

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

دسته بندی با شدت بالا

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

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

دسته بندی با شدت متوسط

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

Enums
MEDIUM_SEVERITY_UNSPECIFIED این فهرست فقط یک مکان نگهدار است و هیچ دسته بندی با شدت متوسط ​​را مشخص نمی کند.
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 کنترل نشده: انجمن ها، تصاویر و ویدیوها.
INFLAMMATORY_POLITICS_AND_NEWS موضوعات بحث برانگیز: سیاست التهابی و اخبار.
NEGATIVE_NEWS_PHARMACEUTICAL اخبار منفی: دارویی.

رتبه بندی سنی

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

Enums
AGE_RATING_UNSPECIFIED این فهرست فقط یک مکان نگهدار است و هیچ گزینه رده بندی سنی را مشخص نمی کند.
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 برنامه‌های دارای رتبه‌بندی فقط برای بزرگسالان (۱۸+).

AppStarRating

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

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

enum ( StarRating )

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

avoidInsufficientStarRating

boolean

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

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

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

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

VideoIAB

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

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

Player ImpressionRate

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

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

FraudInvalidTraffic

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

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

enum ( FraudOption )

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

avoidInsufficientOption

boolean

آمار تقلب تاریخی و IVT ناکافی است.

گزینه تقلب

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

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

IntegralAdScience

جزئیات تنظیمات Integral Ad Science.

نمایندگی 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
  ]
}
فیلدها
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)

شناسه بخش سفارشی ارائه شده توسط Integral Ad Science. شناسه باید بین 1000001 و 1999999 باشد.

TRAQScore

محدوده امتیاز احتمالی TRAQ علم تبلیغات یکپارچه (کیفیت تبلیغات واقعی).

Enums
TRAQ_UNSPECIFIED این فهرست فقط یک مکان نگهدار است و هیچ امتیاز واقعی کیفیت تبلیغات را مشخص نمی کند.
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 این فهرست فقط یک مکان نگهدار است و هیچ گزینه بزرگسالی را مشخص نمی کند.
ADULT_HR بزرگسالان - خطر بالا را حذف کنید.
ADULT_HMR بزرگسالان - خطر بالا و متوسط ​​را حذف کنید.

الکل

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

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

دانلودهای غیر قانونی

گزینه‌های دانلود غیرقانونی علوم آگهی جامع.

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

مواد مخدر

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

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

گفتار نفرت

گزینه‌های احتمالی سخنان نفرت‌آمیز علوم تبلیغاتی جامع.

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

زبان توهین آمیز

گزینه‌های زبان توهین‌آمیز علوم تبلیغاتی یکپارچه.

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

خشونت

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

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

قمار

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

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

AdFraud Prevention

گزینه های احتمالی پیشگیری از کلاهبرداری تبلیغات یکپارچه علم تبلیغات.

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

نمایش قابلیت نمایش

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

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

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

گزینه‌های امکان مشاهده‌پذیری ویدیوی علوم آگهی یکپارچه.

Enums
VIDEO_VIEWABILITY_UNSPECIFIED این فهرست فقط یک مکان نگهدار است و هیچ گزینه قابل مشاهده ویدیو را مشخص نمی کند.
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 باشد، در قسمت جزئیات یک AssignedTargetingOption پر می شود.

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

string

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

targetingOptionId

string

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

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

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

latitude

number

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

longitude

number

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

proximityRadiusAmount

number

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

proximityRadiusUnit

enum ( DistanceUnit )

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

واحد فاصله

گزینه های واحد فاصله ممکن

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

BusinessChainAssignedTargetingOptionDetails

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

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

string

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

targetingOptionId

string

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

شناسه های گزینه هدف گذاری زنجیره کسب و کار پذیرفته شده را می توان با استفاده از SearchTargetingOptions بازیابی کرد.

proximityRadiusAmount

number

مورد نیاز. شعاع منطقه اطراف زنجیره کسب و کار که هدف قرار خواهد گرفت. واحدهای شعاع توسط proximityRadiusUnit مشخص می شوند. اگر واحد DISTANCE_UNIT_KILOMETERS باشد باید از 1 تا 800 و اگر واحد DISTANCE_UNIT_MILES است از 1 تا 500 باشد. حداقل افزایش برای هر دو مورد 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 )

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

ContentStreamTypeAssignedTargetingOptionDetails

جزئیات برای نوع جریان محتوا گزینه هدف گذاری اختصاص داده شده است. زمانی که 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
{
  "targetingOptionId": string,
  "contentPosition": enum (NativeContentPosition)
}
فیلدها
targetingOptionId

string

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

contentPosition

enum ( NativeContentPosition )

موقعیت محتوا

خروجی فقط در v1. مورد نیاز در v2.

OmidAssignedTargetingOptionDetails

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

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

enum ( Omid )

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

خروجی فقط در v1. مورد نیاز در v2.

targetingOptionId

string

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

AudioContentTypeAssignedTargetingOptionDetails

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

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

string

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

audioContentType

enum ( AudioContentType )

نوع محتوای صوتی

خروجی فقط در v1. مورد نیاز در v2.

ContentGenreAssignedTargetingOptionDetails

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

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

روش ها

get

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

list

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