REST Resource: advertisers.adGroups.targetingTypes.assignedTargetingOptions

منبع: AssignedTargetingOption

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "channelDetails": {
    object (ChannelAssignedTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryAssignedTargetingOptionDetails)
  },
  "appDetails": {
    object (AppAssignedTargetingOptionDetails)
  },
  "urlDetails": {
    object (UrlAssignedTargetingOptionDetails)
  },
  "dayAndTimeDetails": {
    object (DayAndTimeAssignedTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeAssignedTargetingOptionDetails)
  },
  "regionalLocationListDetails": {
    object (RegionalLocationListAssignedTargetingOptionDetails)
  },
  "proximityLocationListDetails": {
    object (ProximityLocationListAssignedTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderAssignedTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeAssignedTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentAssignedTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusAssignedTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionAssignedTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionAssignedTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeAssignedTargetingOptionDetails)
  },
  "audienceGroupDetails": {
    object (AudienceGroupAssignedTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserAssignedTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeAssignedTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionAssignedTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspAssignedTargetingOptionDetails)
  },
  "keywordDetails": {
    object (KeywordAssignedTargetingOptionDetails)
  },
  "negativeKeywordListDetails": {
    object (NegativeKeywordListAssignedTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemAssignedTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelAssignedTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentAssignedTargetingOptionDetails)
  },
  "inventorySourceDetails": {
    object (InventorySourceAssignedTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryAssignedTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityAssignedTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusAssignedTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageAssignedTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionAssignedTargetingOptionDetails)
  },
  "inventorySourceGroupDetails": {
    object (InventorySourceGroupAssignedTargetingOptionDetails)
  },
  "digitalContentLabelExclusionDetails": {
    object (DigitalContentLabelAssignedTargetingOptionDetails)
  },
  "sensitiveCategoryExclusionDetails": {
    object (SensitiveCategoryAssignedTargetingOptionDetails)
  },
  "contentThemeExclusionDetails": {
    object (ContentThemeAssignedTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeAssignedTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeAssignedTargetingOptionDetails)
  },
  "thirdPartyVerifierDetails": {
    object (ThirdPartyVerifierAssignedTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiAssignedTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainAssignedTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationAssignedTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeAssignedTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionAssignedTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidAssignedTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeAssignedTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreAssignedTargetingOptionDetails)
  },
  "youtubeVideoDetails": {
    object (YoutubeVideoAssignedTargetingOptionDetails)
  },
  "youtubeChannelDetails": {
    object (YoutubeChannelAssignedTargetingOptionDetails)
  },
  "sessionPositionDetails": {
    object (SessionPositionAssignedTargetingOptionDetails)
  },
  "lookalikeAudienceDetails": {
    object (LookalikeAudienceAssignedTargetingOptionDetails)
  },
  "googleAudienceDetails": {
    object (GoogleAudienceAssignedTargetingOptionDetails)
  },
  "customListDetails": {
    object (CustomListAssignedTargetingOptionDetails)
  },
  "combinedAudienceDetails": {
    object (CombinedAudienceAssignedTargetingOptionDetails)
  },
  "firstPartyAndPartnerAudienceDetails": {
    object (FirstPartyAndPartnerAudienceAssignedTargetingOptionDetails)
  },
  "auctionPackageDetails": {
    object (AuctionPackageAssignedTargetingOptionDetails)
  },
  "youtubeChannelPackDetails": {
    object (YoutubeChannelPackAssignedTargetingOptionDetails)
  }
  // End of mutually exclusive fields.
}
فیلدها
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)

فقط خروجی. وضعیت موروثی گزینه هدف‌یابی اختصاص‌داده‌شده.
اطلاعات دقیق درباره گزینه هدف‌یابی که اختصاص داده می‌شود. فقط یک فیلد در جزئیات می‌تواند پر شود و باید با targeting_type مطابقت داشته باشد؛ در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
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)

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

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

object (NegativeKeywordListAssignedTargetingOptionDetails)

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

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

object (OperatingSystemAssignedTargetingOptionDetails)

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

object (DeviceMakeModelAssignedTargetingOptionDetails)

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

object (EnvironmentAssignedTargetingOptionDetails)

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

object (InventorySourceAssignedTargetingOptionDetails)

جزئیات منبع فضای آگهی. وقتی targetingType TARGETING_TYPE_INVENTORY_SOURCE_DEAL باشد، این فیلد پر خواهد شد.
categoryDetails

object (CategoryAssignedTargetingOptionDetails)

جزئیات دسته. وقتی targetingType TARGETING_TYPE_CATEGORY باشد، این فیلد پر خواهد شد.

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

object (ViewabilityAssignedTargetingOptionDetails)

جزئیات رؤیت‌پذیری. وقتی targetingType TARGETING_TYPE_VIEWABILITY باشد، این فیلد پر خواهد شد.

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

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

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

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

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

object (LanguageAssignedTargetingOptionDetails)

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

object (GeoRegionAssignedTargetingOptionDetails)

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

object (InventorySourceGroupAssignedTargetingOptionDetails)

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

object (DigitalContentLabelAssignedTargetingOptionDetails)

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

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

object (SensitiveCategoryAssignedTargetingOptionDetails)

جزئیات دسته حساس. وقتی targetingType TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION باشد، این فیلد پر خواهد شد.

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

object (ContentThemeAssignedTargetingOptionDetails)

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

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

object (ExchangeAssignedTargetingOptionDetails)

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

object (SubExchangeAssignedTargetingOptionDetails)

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

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

جزئیات درستی‌سنجی طرف سوم. وقتی targetingType TARGETING_TYPE_THIRD_PARTY_VERIFIER باشد، این فیلد پر خواهد شد.
poiDetails

object (PoiAssignedTargetingOptionDetails)

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

object (BusinessChainAssignedTargetingOptionDetails)

جزئیات کسب‌وکار زنجیره‌ای. وقتی targetingType TARGETING_TYPE_BUSINESS_CHAIN باشد، این فیلد پر خواهد شد.
contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

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

object (ContentStreamTypeAssignedTargetingOptionDetails)

جزئیات مدت محتوا. وقتی TargetingType (نوع هدف‌یابی) TARGETING_TYPE_CONTENT_STREAM_TYPE باشد، این فیلد پر خواهد شد.
nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

جزئیات جایگاه محتوای بومی. وقتی targetingType TARGETING_TYPE_NATIVE_CONTENT_POSITION باشد، این فیلد پر خواهد شد.
omidDetails

object (OmidAssignedTargetingOptionDetails)

جزئیات فضای آگهی فعال‌شده برای Open Measurement. وقتی targetingType TARGETING_TYPE_OMID باشد، این فیلد پر خواهد شد.
audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

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

object (ContentGenreAssignedTargetingOptionDetails)

جزئیات ژانر محتوا. وقتی targetingType TARGETING_TYPE_CONTENT_GENRE باشد، این فیلد پر خواهد شد.
youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

جزئیات ویدیو YouTube. وقتی targetingType TARGETING_TYPE_YOUTUBE_VIDEO باشد، این فیلد پر خواهد شد.
youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

جزئیات کانال YouTube. وقتی targetingType TARGETING_TYPE_YOUTUBE_CHANNEL باشد، این فیلد پر خواهد شد.
sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

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

object (LookalikeAudienceAssignedTargetingOptionDetails)

جزئیات مخاطبان مشابه. وقتی targetingType TARGETING_TYPE_LOOKALIKE_AUDIENCE باشد، این فیلد پر خواهد شد.
googleAudienceDetails

object (GoogleAudienceAssignedTargetingOptionDetails)

جزئیات مخاطبان Google. وقتی targetingType TARGETING_TYPE_GOOGLE_AUDIENCE باشد، این فیلد پر خواهد شد.
customListDetails

object (CustomListAssignedTargetingOptionDetails)

جزئیات فهرست سفارشی. وقتی targetingType TARGETING_TYPE_CUSTOM_LIST باشد، این فیلد پر خواهد شد.
combinedAudienceDetails

object (CombinedAudienceAssignedTargetingOptionDetails)

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

object (FirstPartyAndPartnerAudienceAssignedTargetingOptionDetails)

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

object (AuctionPackageAssignedTargetingOptionDetails)

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

object (YoutubeChannelPackAssignedTargetingOptionDetails)

جزئیات بسته کانال YouTube. وقتی targetingType TARGETING_TYPE_YOUTUBE_CHANNEL_PACK باشد، این فیلد پر خواهد شد.
پایان فیلدهای متقابلاً انحصاری.

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 store متعلق به Apple از رشته ۹ رقمی استفاده می‌کند، برای مثال 422689480.
displayName

string

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

boolean

نشان می‌دهد که آیا این گزینه هدف‌گیری منفی شده است یا نه.
appPlatform

enum (AppPlatform)

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

AppPlatform

گزینه‌های ممکن برای هدف‌یابی پلاتفرم برنامه.

شمارشی‌ها
APP_PLATFORM_UNSPECIFIED مقدار پیش‌فرض وقتی پلاتفرم برنامه در این نسخه مشخص نشده است. این enum جای‌بانی برای مقدار پیش‌فرض است و گزینه پلاتفرم واقعی را نشان نمی‌دهد.
APP_PLATFORM_IOS پلاتفرم برنامه iOS است.
APP_PLATFORM_ANDROID پلاتفرم برنامه Android است.
APP_PLATFORM_ROKU پلاتفرم برنامه Roku است.
APP_PLATFORM_AMAZON_FIRETV پلاتفرم برنامه Amazon FireTV است.
APP_PLATFORM_PLAYSTATION پلاتفرم برنامه Playstation است.
APP_PLATFORM_APPLE_TV پلاتفرم برنامه Apple TV است.
APP_PLATFORM_XBOX پلاتفرم برنامه Xbox است.
APP_PLATFORM_SAMSUNG_TV پلاتفرم برنامه Samsung TV است.
APP_PLATFORM_ANDROID_TV پلاتفرم برنامه Android TV است.
APP_PLATFORM_GENERIC_CTV پلاتفرم برنامه پلاتفرم تلویزیون متصل است که به‌طور صریح در جای دیگری فهرست نشده است.
APP_PLATFORM_LG_TV پلاتفرم برنامه LG TV است.
APP_PLATFORM_VIZIO_TV پلاتفرم برنامه VIZIO TV است.
APP_PLATFORM_VIDAA پلاتفرم برنامه Vidaa است.

UrlAssignedTargetingOptionDetails

جزئیات گزینه هدف‌یابی نشانی وب اختصاص‌داده‌شده. وقتی targetingType TARGETING_TYPE_URL باشد، این مقدار در فیلد جزئیات AssignedTargetingOption درج می‌شود.

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

string

الزامی. نشانی وب، برای مثال 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

الزامی. ساعت شروع برای هدف‌یابی روز و زمان. باید بین ۰ (شروع روز) و ۲۳ (۱ ساعت قبل‌از پایان روز) باشد.
endHour

integer

الزامی. ساعت پایان برای هدف‌یابی روز و زمان. باید بین ۱ (۱ ساعت پس‌از شروع روز) و ۲۴ (پایان روز) باشد.
timeZoneResolution

enum (TimeZoneResolution)

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

برای ردیف‌های «تولید تقاضا»، این فیلد همیشه TIME_ZONE_RESOLUTION_ADVERTISER است.

DayOfWeek

نشان‌دهنده روزی از هفته است.

شمارشی‌ها
DAY_OF_WEEK_UNSPECIFIED روز هفته مشخص نشده است.
MONDAY ﺪﻮﺷﻨﺑﮫ
TUESDAY سه‌شنبه
WEDNESDAY چهارشنبه
THURSDAY پنج‌شنبه
FRIDAY جمعه
SATURDAY شنبه
SUNDAY یک‌شنبه

TimeZoneResolution

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

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

AgeRangeAssignedTargetingOptionDetails

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

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

enum (AgeRange)

الزامی. محدوده سنی مخاطبان. ما فقط از هدف‌یابی محدوده سنی پیوسته مخاطبان پشتیبانی می‌کنیم. بنابراین، محدوده سنی نشان‌داده‌شده در این فیلد می‌تواند ۱) به‌تنهایی هدف‌یابی شود، یا ۲) بخشی از محدوده سنی پیوسته بزرگ‌تری باشد. دسترسی هدف‌یابی محدوده سنی پیوسته را می‌توان با هدف‌یابی مخاطبان با سن نامشخص نیز گسترش داد.

RegionalLocationListAssignedTargetingOptionDetails

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

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

string (int64 format)

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

boolean

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

ProximityLocationListAssignedTargetingOptionDetails

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

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

string (int64 format)

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

number

الزامی. شعاع بیان‌شده در واحدهای فاصله تنظیم‌شده در proximityRadiusUnit. این نشان‌دهنده اندازه منطقه اطراف مکان انتخاب‌شده است که هدف‌یابی خواهد شد. شعاع باید بین ۱ تا ۵۰۰ مایل یا ۸۰۰ کیلومتر باشد.
proximityRadiusUnit

enum (ProximityRadiusUnit)

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

ProximityRadiusUnit

شمارش واحدهای فاصله برای ProximityRadius.

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

GenderAssignedTargetingOptionDetails

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

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

enum (Gender)

الزامی. جنسیت مخاطب.

VideoPlayerSizeAssignedTargetingOptionDetails

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

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

enum (VideoPlayerSize)

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

UserRewardedContentAssignedTargetingOptionDetails

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

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

string

الزامی. فیلد targetingOptionId وقتی targetingType TARGETING_TYPE_USER_REWARDED_CONTENT است.
userRewardedContent

enum (UserRewardedContent)

فقط خروجی. وضعیت محتوای پاداش‌دار کاربر برای آگهی‌های ویدیویی.

ParentalStatusAssignedTargetingOptionDetails

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

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

enum (ParentalStatus)

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

ContentInstreamPositionAssignedTargetingOptionDetails

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

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

enum (ContentInstreamPosition)

الزامی. موقعیت درون جاری‌سازی محتوا برای آگهی‌های ویدیویی یا صوتی.
adType

enum (AdType)

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

  • ‫AD_TYPE_VIDEO، وقتی lineItemType LINE_ITEM_TYPE_VIDEO_DEFAULT باشد، این تنظیمات توسط مورد خط جدید به ارث برده خواهد شد.
  • ‫AD_TYPE_AUDIO، وقتی lineItemType LINE_ITEM_TYPE_AUDIO_DEFAULT باشد، این تنظیمات توسط مورد خط جدید به ارث برده خواهد شد.

AdType

نشان‌دهنده نوع طرح‌آگهی مرتبط با آگهی‌ها است.

شمارشی‌ها
AD_TYPE_UNSPECIFIED نوع آگهی در این نسخه مشخص نشده است یا نامشخص است.
AD_TYPE_DISPLAY طرح‌آگهی‌های نمایشی، مثلاً تصویر و HTML5.
AD_TYPE_VIDEO طرح‌آگهی‌های ویدیویی، مثلاً آگهی‌های ویدیویی که درطول جاری‌سازی محتوا در پخش‌کننده‌های ویدیو پخش می‌شوند.
AD_TYPE_AUDIO طرح‌آگهی‌های صوتی، مثلاً آگهی‌های صوتی که درطول محتوای صوتی پخش می‌شوند.

ContentOutstreamPositionAssignedTargetingOptionDetails

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

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

enum (ContentOutstreamPosition)

الزامی. جایگاه برون‌جاری محتوا.
adType

enum (AdType)

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

  • ‫AD_TYPE_DISPLAY، وقتی lineItemType LINE_ITEM_TYPE_DISPLAY_DEFAULT باشد، این تنظیمات توسط ردیف جدید به ارث برده خواهد شد.
  • ‫AD_TYPE_VIDEO، وقتی lineItemType LINE_ITEM_TYPE_VIDEO_DEFAULT باشد، این تنظیمات توسط مورد خط جدید به ارث برده خواهد شد.

DeviceTypeAssignedTargetingOptionDetails

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

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

enum (DeviceType)

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

number

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

برای مثال، اگر قیمت پیشنهادی بدون ضریب ۱۰ دلار باشد و ضریب برای رایانه لوحی ۱٫۵ باشد، قیمت پیشنهادی حاصل برای رایانه لوحی ۱۵ دلار خواهد بود.

فقط برای موارد خطی YouTube و «شرکا» قابل‌اجرا است.

AudienceGroupAssignedTargetingOptionDetails

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

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

object (GoogleAudienceGroup)

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

object (CustomListGroup)

اختیاری. شناسه‌های فهرست سفارشی گروه فهرست سفارشی گنجانده‌شده. فقط حاوی شناسه‌های فهرست سفارشی است.
includedCombinedAudienceGroup

object (CombinedAudienceGroup)

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

object (GoogleAudienceGroup)

اختیاری. شناسه‌های مخاطب Google مربوط به گروه مخاطب Google مستثنی‌شده. برای هدف‌یابی منفی استفاده می‌شود. «متمم» «اجتماع» این گروه و دیگر گروه‌های مخاطب مستثنی‌شده به‌عنوان «اشتراک» برای هر هدف‌یابی مخاطب مثبت استفاده می‌شود. فقط شامل مخاطبان Google از نوع «همگرا»، «جویای خرید»، و «برنامه‌های نصب‌شده» است. همه موارد به‌طور منطقی «یا» یکدیگر هستند.
includedFirstPartyAndPartnerAudienceGroups[]

object (FirstPartyAndPartnerAudienceGroup)

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

object (FirstPartyAndPartnerAudienceGroup)

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

GoogleAudienceGroup

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

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

object (GoogleAudienceTargetingSetting)

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

GoogleAudienceTargetingSetting

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

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

string (int64 format)

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

CustomListGroup

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

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

object (CustomListTargetingSetting)

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

CustomListTargetingSetting

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

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

string (int64 format)

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

CombinedAudienceGroup

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

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

object (CombinedAudienceTargetingSetting)

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

CombinedAudienceTargetingSetting

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

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

string (int64 format)

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

FirstPartyAndPartnerAudienceGroup

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

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

object (FirstPartyAndPartnerAudienceTargetingSetting)

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

FirstPartyAndPartnerAudienceTargetingSetting

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

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

string (int64 format)

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

enum (Recency)

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

تازگی

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

شمارشی‌ها
RECENCY_NO_LIMIT محدودیتی برای تازگی وجود ندارد.
RECENCY_1_MINUTE تازگی ۱ دقیقه است.
RECENCY_5_MINUTES تازگی ۵ دقیقه است.
RECENCY_10_MINUTES تازگی ۱۰ دقیقه است.
RECENCY_15_MINUTES تازگی ۱۵ دقیقه است.
RECENCY_30_MINUTES تازگی ۳۰ دقیقه است.
RECENCY_1_HOUR تازگی ۱ ساعت است.
RECENCY_2_HOURS تازگی ۲ ساعت است.
RECENCY_3_HOURS تازگی ۳ ساعت است.
RECENCY_6_HOURS تازگی ۶ ساعت است.
RECENCY_12_HOURS تازگی ۱۲ ساعت است.
RECENCY_1_DAY تازگی ۱ روز است.
RECENCY_2_DAYS تازگی ۲ روز است.
RECENCY_3_DAYS تازگی ۳ روز است.
RECENCY_5_DAYS تازگی ۵ روز است.
RECENCY_7_DAYS تازگی ۷ روز است.
RECENCY_10_DAYS تازگی ۱۰ روز است.
RECENCY_14_DAYS تازگی ۱۴ روز است.
RECENCY_15_DAYS تازگی ۱۵ روز است.
RECENCY_21_DAYS تازگی ۲۱ روز است.
RECENCY_28_DAYS تازگی ۲۸ روز است.
RECENCY_30_DAYS تازگی ۳۰ روز است.
RECENCY_40_DAYS تازگی ۴۰ روز است.
RECENCY_45_DAYS تازگی ۴۵ روز است.
RECENCY_60_DAYS تازگی ۶۰ روز است.
RECENCY_90_DAYS تازگی ۹۰ روز است.
RECENCY_120_DAYS تازگی ۱۲۰ روز است.
RECENCY_180_DAYS تازگی ۱۸۰ روز است.
RECENCY_270_DAYS تازگی ۲۷۰ روز است.
RECENCY_365_DAYS تازگی ۳۶۵ روز است.

BrowserAssignedTargetingOptionDetails

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

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

string

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

string

الزامی. targetingOptionId مربوط به TargetingOption از نوع TARGETING_TYPE_BROWSER.
negative

boolean

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

HouseholdIncomeAssignedTargetingOptionDetails

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

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

enum (HouseholdIncome)

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

OnScreenPositionAssignedTargetingOptionDetails

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

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

string

الزامی. فیلد targetingOptionId وقتی targetingType TARGETING_TYPE_ON_SCREEN_POSITION است.
onScreenPosition

enum (OnScreenPosition)

فقط خروجی. جایگاه روی صفحه.
adType

enum (AdType)

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

  • ‫AD_TYPE_DISPLAY، وقتی lineItemType LINE_ITEM_TYPE_DISPLAY_DEFAULT باشد، این تنظیمات توسط مورد خط جدید به ارث برده خواهد شد.
  • ‫AD_TYPE_VIDEO، وقتی lineItemType LINE_ITEM_TYPE_VIDEO_DEFAULT باشد، این تنظیمات توسط مورد خط جدید به ارث برده خواهد شد.

CarrierAndIspAssignedTargetingOptionDetails

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

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

string

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

string

الزامی. targetingOptionId مربوط به TargetingOption از نوع TARGETING_TYPE_CARRIER_AND_ISP.
negative

boolean

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

KeywordAssignedTargetingOptionDetails

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

نمایش JSON 
{
  "keyword": string,
  "negative": boolean,
  "exemptedPolicyNames": [
    string
  ]
}
فیلدها
keyword

string

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

کلیدواژه مثبت نمی‌تواند کلمه توهین‌آمیز باشد. باید با UTF-8 کدبندی شده باشد و حداکثر اندازه آن ۲۵۵ بایت باشد. حداکثر تعداد نویسه ۸۰ است. حداکثر تعداد کلمات ۱۰ است.
negative

boolean

نشان می‌دهد که آیا این گزینه هدف‌گیری منفی شده است یا نه.
exemptedPolicyNames[]

string

اختیاری. نام خط‌مشی‌هایی که کلیدواژه از آن‌ها معاف می‌شود.

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

این فیلد فقط برای کلیدواژه‌های هدف‌یابی‌شده مثبت که به منابع «تولید تقاضا» اختصاص داده شده‌اند قابل‌اعمال است.

NegativeKeywordListAssignedTargetingOptionDetails

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

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

string (int64 format)

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

OperatingSystemAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

DeviceMakeModelAssignedTargetingOptionDetails

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

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

string

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

string

الزامی. فیلد targetingOptionId وقتی targetingType TARGETING_TYPE_DEVICE_MAKE_MODEL است.
negative

boolean

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

EnvironmentAssignedTargetingOptionDetails

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

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

enum (Environment)

الزامی. محیط ارائه.

InventorySourceAssignedTargetingOptionDetails

جزئیات هدف‌یابی برای منبع موجودی. وقتی targetingType TARGETING_TYPE_INVENTORY_SOURCE_DEAL باشد، این مقدار در فیلد جزئیات AssignedTargetingOption درج می‌شود.

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

string (int64 format)

الزامی. شناسه منبع موجودی. باید به فیلد inventorySourceId از منبع InventorySource ارجاع دهد.

CategoryAssignedTargetingOptionDetails

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

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

string

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

string

الزامی. فیلد targetingOptionId وقتی targetingType TARGETING_TYPE_CATEGORY است.
negative

boolean

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

ViewabilityAssignedTargetingOptionDetails

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

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

enum (Viewability)

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

AuthorizedSellerStatusAssignedTargetingOptionDetails

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

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

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

enum (AuthorizedSellerStatus)

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

string

الزامی. targetingOptionId مربوط به TargetingOption از نوع TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

LanguageAssignedTargetingOptionDetails

جزئیات گزینه هدف‌یابی زبانی واگذارشده. وقتی targetingType TARGETING_TYPE_LANGUAGE باشد، این مقدار در فیلد جزئیات 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 
{
  "excludedContentRatingTier": enum (ContentRatingTier)
}
فیلدها
excludedContentRatingTier

enum (ContentRatingTier)

الزامی. نام نمایشی سطح رده‌بندی برچسب محتوای دیجیتال که باید مستثنی شود.

این فیلد فقط مقدار CONTENT_RATING_TIER_UNRATED را می‌پذیرد.

SensitiveCategoryAssignedTargetingOptionDetails

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

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

enum (SensitiveCategory)

الزامی. یک enum برای محتوای دسته حساس Display & Video 360 که برای «مستثنی شدن» طبقه‌بندی شده است.

این فیلد فقط مقادیر زیر را می‌پذیرد:

  • SENSITIVE_CATEGORY_EMBEDDED_VIDEO
  • SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO

ContentThemeAssignedTargetingOptionDetails

جزئیات هدف‌یابی برای موضوع محتوا. وقتی targetingType TARGETING_TYPE_CONTENT_THEME_EXCLUSION باشد، این مقدار در فیلد جزئیات AssignedTargetingOption درج می‌شود.

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

string

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

enum (ContentTheme)

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

enum (ContentTheme)

الزامی. یک enum برای موضوع محتوای DV360 که به‌عنوان «مستثناشده» طبقه‌بندی شده است.

ExchangeAssignedTargetingOptionDetails

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

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

enum (Exchange)

الزامی. مقدار enum برای صرافی.

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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  },
  "peer39": {
    object (Peer39)
  }
  // End of mutually exclusive fields.
}
فیلدها
می‌تواند یکی از تأییدکننده‌های شخص ثالث را برای اعمال آستانه‌های ایمنی نمانام برای ظهورها هدف‌یابی کند. در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
doubleVerify

object (DoubleVerify)

درستی‌سنج نمانام طرف سوم -- DoubleVerify.
integralAdScience

object (IntegralAdScience)

درستی‌سنج نمانام طرف سوم -- Integral Ad Science.
peer39

object (Peer39)

درستی‌سنج نمانام طرف سوم -- Peer39.
پایان فیلدهای متقابلاً انحصاری.

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)

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

string (int64 format)

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

BrandSafetyCategories

تنظیمات کنترل‌های ایمنی نمانام.

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

boolean

ناشناخته یا غیرقابل رده‌بندی.
avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

دسته‌های اجتناب از ایمنی نمانام با شدت بالا.
avoidedMediumSeverityCategories[]

enum (MediumSeverityCategory)

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

HighSeverityCategory

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

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

MediumSeverityCategory

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

شمارشی‌ها
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 Non-Std Content: Non-English.
PARKING_PAGE محتوای غیراستاندارد: صفحه پارکینگ.
UNMODERATED_UGC محتوای تولیدشده توسط کاربر بدون ناظر: تالارهای گفتمان، تصاویر، و ویدیو.
INFLAMMATORY_POLITICS_AND_NEWS موضوعات بحث‌برانگیز: اخبار و سیاست تحریک‌آمیز.
NEGATIVE_NEWS_PHARMACEUTICAL اخبار منفی: داروسازی.

AgeRating

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

شمارشی‌ها
AGE_RATING_UNSPECIFIED این enum فقط یک جای‌بان است و هیچ گزینه رده‌بندی سنی را مشخص نمی‌کند.
APP_AGE_RATE_UNKNOWN برنامه‌هایی با رده‌بندی سنی نامشخص.
APP_AGE_RATE_4_PLUS برنامه‌هایی که برای «همه» (۴ سال به بالا) رده‌بندی شده‌اند.
APP_AGE_RATE_9_PLUS برنامه‌های رده‌بندی‌شده برای «همه» (۹ سال به بالا).
APP_AGE_RATE_12_PLUS برنامه‌های رده‌بندی‌شده برای نوجوانان (۱۲ سال به بالا).
APP_AGE_RATE_17_PLUS برنامه‌های رده‌بندی‌شده برای بزرگسالان (۱۷ سال به بالا).
APP_AGE_RATE_18_PLUS برنامه‌هایی که برای بزرگسالان (۱۸ سال به بالا) رده‌بندی شده‌اند.

AppStarRating

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

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

enum (StarRating)

از پیشنهاد قیمت برای برنامه‌های دارای رده‌بندی ستاره‌ای اجتناب کنید.
avoidInsufficientStarRating

boolean

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

StarRating

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

شمارشی‌ها
APP_STAR_RATE_UNSPECIFIED این enum فقط یک جای‌بان است و هیچ گزینه رده‌بندی ستاره‌ای برنامه را مشخص نمی‌کند.
APP_STAR_RATE_1_POINT_5_LESS برنامه‌های رسمی با رده‌بندی کمتر از ۱٫۵ ستاره.
APP_STAR_RATE_2_LESS برنامه‌های رسمی با رده‌بندی کمتر از ۲ ستاره.
APP_STAR_RATE_2_POINT_5_LESS برنامه‌های رسمی با رده‌بندی کمتر از ۲٫۵ ستاره.
APP_STAR_RATE_3_LESS برنامه‌های رسمی با رده‌بندی کمتر از ۳ ستاره.
APP_STAR_RATE_3_POINT_5_LESS برنامه‌های رسمی با رده‌بندی کمتر از ۳٫۵ ستاره.
APP_STAR_RATE_4_LESS برنامه‌های رسمی با رده‌بندی کمتر از ۴ ستاره.
APP_STAR_RATE_4_POINT_5_LESS برنامه‌های رسمی با رده‌بندی کمتر از ۴.۵ ستاره.

DisplayViewability

جزئیات تنظیمات رؤیت‌پذیری نمایش DoubleVerify.

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

enum (IAB)

فضای آگهی وب و برنامه را هدف قرار دهید تا نرخ قابل‌مشاهده IAB را به حداکثر برسانید.
viewableDuring

enum (ViewableDuring)

فضای آگهی وب و برنامه را هدف‌یابی کنید تا مدت‌زمان قابل‌مشاهده بودن را به ۱۰۰٪ برسانید.

IAB

گزینه‌های ممکن برای نرخ مشاهده‌پذیری IAB.

شمارشی‌ها
IAB_VIEWED_RATE_UNSPECIFIED این enum فقط یک جای‌بان است و هیچ گزینه نرخ مشاهده‌شده IAB را مشخص نمی‌کند.
IAB_VIEWED_RATE_80_PERCENT_HIGHER فضای آگهی وب و برنامه را هدف قرار دهید تا نرخ قابل‌مشاهده IAB را به ۸۰٪ یا بالاتر برسانید.
IAB_VIEWED_RATE_75_PERCENT_HIGHER فضای آگهی وب و برنامه را هدف قرار دهید تا نرخ قابل‌مشاهده IAB را به ۷۵٪ یا بالاتر برسانید.
IAB_VIEWED_RATE_70_PERCENT_HIGHER فضای آگهی وب و برنامه را هدف قرار دهید تا نرخ قابل‌مشاهده IAB را به ۷۰٪ یا بیشتر برسانید.
IAB_VIEWED_RATE_65_PERCENT_HIGHER فضای آگهی وب و برنامه را هدف قرار دهید تا نرخ قابل‌مشاهده IAB را به ۶۵٪ یا بالاتر برسانید.
IAB_VIEWED_RATE_60_PERCENT_HIGHER فضای آگهی وب و برنامه را هدف‌یابی کنید تا نرخ قابل‌مشاهده IAB را به ۶۰٪ یا بالاتر برسانید.
IAB_VIEWED_RATE_55_PERCENT_HIGHER فضای آگهی وب و برنامه را هدف قرار دهید تا نرخ قابل‌مشاهده IAB را به ۵۵٪ یا بالاتر برسانید.
IAB_VIEWED_RATE_50_PERCENT_HIGHER فضای آگهی وب و برنامه را هدف قرار دهید تا نرخ قابل‌مشاهده IAB را به ۵۰٪ یا بیشتر برسانید.
IAB_VIEWED_RATE_40_PERCENT_HIGHER فضای آگهی وب و برنامه را هدف قرار دهید تا نرخ قابل‌مشاهده IAB را به ۴۰٪ یا بیشتر افزایش دهید.
IAB_VIEWED_RATE_30_PERCENT_HIGHER فضای آگهی وب و برنامه را هدف قرار دهید تا نرخ قابل‌مشاهده IAB را به ‎٪۳۰ یا بالاتر افزایش دهید.

ViewableDuring

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

شمارشی‌ها
AVERAGE_VIEW_DURATION_UNSPECIFIED این enum فقط یک جای‌بان است و هیچ گزینه میانگین مدت مشاهده‌ای را مشخص نمی‌کند.
AVERAGE_VIEW_DURATION_5_SEC فهرستگان وب و برنامه را هدف قرار دهید تا مدت‌زمان قابل‌مشاهده ۱۰۰٪ را به ۵ ثانیه یا بیشتر افزایش دهید.
AVERAGE_VIEW_DURATION_10_SEC فضای آگهی وب و برنامه را هدف قرار دهید تا مدت‌زمان قابل‌مشاهده ۱۰۰٪ را به ۱۰ ثانیه یا بیشتر افزایش دهید.
AVERAGE_VIEW_DURATION_15_SEC فهرستگان وب و برنامه را هدف قرار دهید تا مدت‌زمان قابل‌مشاهده ۱۰۰٪ را به ۱۵ ثانیه یا بیشتر افزایش دهید.

VideoViewability

جزئیات تنظیمات رؤیت‌پذیری ویدیو DoubleVerify.

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

enum (VideoIAB)

موجودی وب را هدف قرار دهید تا نرخ قابل‌مشاهده IAB را بیشینه کنید.
videoViewableRate

enum (VideoViewableRate)

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

enum (PlayerImpressionRate)

فضای آگهی را هدف قرار دهید تا با اندازه پخش‌کننده ۴۰۰x۳۰۰ یا بزرگ‌تر، ظهورها را به حداکثر برسانید.

VideoIAB

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

شمارشی‌ها
VIDEO_IAB_UNSPECIFIED این enum فقط یک جای‌بان است و هیچ گزینه نرخ قابل‌مشاهده IAB ویدیو را مشخص نمی‌کند.
IAB_VIEWABILITY_80_PERCENT_HIGHER فضای آگهی وب و برنامه را هدف قرار دهید تا نرخ قابل‌مشاهده IAB را به ۸۰٪ یا بالاتر برسانید.
IAB_VIEWABILITY_75_PERCENT_HIGHER فضای آگهی وب و برنامه را هدف قرار دهید تا نرخ قابل‌مشاهده IAB را به ۷۵٪ یا بالاتر برسانید.
IAB_VIEWABILITY_70_PERCENT_HIGHER فضای آگهی وب و برنامه را هدف قرار دهید تا نرخ قابل‌مشاهده IAB را به ۷۰٪ یا بیشتر برسانید.
IAB_VIEWABILITY_65_PERCENT_HIHGER فضای آگهی وب و برنامه را هدف قرار دهید تا نرخ قابل‌مشاهده IAB را به ۶۵٪ یا بالاتر برسانید.
IAB_VIEWABILITY_60_PERCENT_HIGHER فضای آگهی وب و برنامه را هدف‌یابی کنید تا نرخ قابل‌مشاهده IAB را به ۶۰٪ یا بالاتر برسانید.
IAB_VIEWABILITY_55_PERCENT_HIHGER فضای آگهی وب و برنامه را هدف قرار دهید تا نرخ قابل‌مشاهده IAB را به ۵۵٪ یا بالاتر برسانید.
IAB_VIEWABILITY_50_PERCENT_HIGHER فضای آگهی وب و برنامه را هدف قرار دهید تا نرخ قابل‌مشاهده IAB را به ۵۰٪ یا بیشتر برسانید.
IAB_VIEWABILITY_40_PERCENT_HIHGER فضای آگهی وب و برنامه را هدف قرار دهید تا نرخ قابل‌مشاهده IAB را به ۴۰٪ یا بیشتر افزایش دهید.
IAB_VIEWABILITY_30_PERCENT_HIHGER فضای آگهی وب و برنامه را هدف قرار دهید تا نرخ قابل‌مشاهده IAB را به ‎٪۳۰ یا بالاتر افزایش دهید.

VideoViewableRate

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

شمارشی‌ها
VIDEO_VIEWABLE_RATE_UNSPECIFIED این شمارش فقط یک جای‌بان است و هیچ گزینه نرخ قابل‌مشاهده بودن ویدیو را مشخص نمی‌کند.
VIEWED_PERFORMANCE_40_PERCENT_HIGHER موجودی وب را هدف قرار دهید تا نرخ کاملاً قابل‌مشاهده را به ۴۰٪ یا بیشتر برسانید.
VIEWED_PERFORMANCE_35_PERCENT_HIGHER موجودی وب را هدف قرار دهید تا نرخ کاملاً قابل‌مشاهده را به ۳۵٪ یا بیشتر برسانید.
VIEWED_PERFORMANCE_30_PERCENT_HIGHER موجودی وب را هدف قرار دهید تا نرخ کاملاً قابل‌مشاهده را به ‎٪۳۰ یا بیشتر افزایش دهید.
VIEWED_PERFORMANCE_25_PERCENT_HIGHER موجودی وب را هدف قرار دهید تا نرخ کاملاً قابل‌مشاهده را به ۲۵٪ یا بیشتر برسانید.
VIEWED_PERFORMANCE_20_PERCENT_HIGHER موجودی وب را هدف قرار دهید تا نرخ کاملاً قابل‌مشاهده را به ۲۰٪ یا بیشتر برسانید.
VIEWED_PERFORMANCE_10_PERCENT_HIGHER موجودی وب را هدف قرار دهید تا نرخ کاملاً قابل‌مشاهده را به ۱۰٪ یا بیشتر برسانید.

PlayerImpressionRate

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

شمارشی‌ها
PLAYER_SIZE_400X300_UNSPECIFIED این شمارش فقط یک جای‌بان است و هیچ گزینه ظهور را مشخص نمی‌کند.
PLAYER_SIZE_400X300_95 سایت‌هایی با بیش‌از ۹۵٪ ظهور.
PLAYER_SIZE_400X300_70 سایت‌هایی با بیش‌از ۷۰٪ ظهور.
PLAYER_SIZE_400X300_25 سایت‌هایی با بیش‌از ۲۵٪ ظهور.
PLAYER_SIZE_400X300_5 سایت‌هایی با بیش‌از ۵٪ ظهور.

FraudInvalidTraffic

تنظیمات «ترافیک نامعتبر و کلاهبرداری DoubleVerify».

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

enum (FraudOption)

از سایت‌ها و برنامه‌هایی که سابقه کلاهبرداری و ترافیک نامعتبر دارند اجتناب کنید.
avoidInsufficientOption

boolean

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

FraudOption

گزینه‌های احتمالی نرخ «کلاهبرداری» و «ترافیک نامعتبر» در گذشته.

شمارشی‌ها
FRAUD_UNSPECIFIED این شمارش فقط یک جای‌بان است و هیچ گزینه ترافیک نامعتبر و کلاهبرداری را مشخص نمی‌کند.
AD_IMPRESSION_FRAUD_100 ‫٪۱۰۰ کلاهبرداری و ترافیک نامعتبر.
AD_IMPRESSION_FRAUD_75 ‫۷۵٪ یا بیشتر کلاهبرداری و ترافیک نامعتبر.
AD_IMPRESSION_FRAUD_50 ‫۵۰٪ یا بیشتر کلاهبرداری و ترافیک نامعتبر.
AD_IMPRESSION_FRAUD_25 ‫۲۵٪ یا بیشتر کلاهبرداری و ترافیک نامعتبر.
AD_IMPRESSION_FRAUD_10 ‫۱۰٪ یا بیشتر کلاهبرداری و ترافیک نامعتبر.
AD_IMPRESSION_FRAUD_8 ‫۸٪ یا بیشتر تقلب و ترافیک نامعتبر.
AD_IMPRESSION_FRAUD_6 ‫٪۶ یا بیشتر کلاهبرداری و ترافیک نامعتبر.
AD_IMPRESSION_FRAUD_4 ‫۴٪ یا بیشتر کلاهبرداری و ترافیک نامعتبر.
AD_IMPRESSION_FRAUD_2 ‫٪۲ یا بیشتر کلاهبرداری و ترافیک نامعتبر.

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
  ],
  "qualitySyncCustomSegmentId": [
    string
  ]
}
فیلدها
traqScoreOption

enum (TRAQScore)

کیفیت تبلیغات واقعی (فقط برای سطرهای آگهی «نمایشی» قابل‌اعمال است).
excludeUnrateable

boolean

ایمنی نمانام - غیرقابل رده‌بندی.
excludedAdultRisk

enum (Adult)

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

enum (Alcohol)

ایمنی نمانام - الکل.
excludedIllegalDownloadsRisk

enum (IllegalDownloads)

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

enum (Drugs)

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

enum (HateSpeech)

ایمنی نمانام - نفرت‌پراکنی.
excludedOffensiveLanguageRisk

enum (OffensiveLanguage)

ایمنی نمانام - کلمات توهین‌آمیز.
excludedViolenceRisk

enum (Violence)

ایمنی نمانام - خشونت.
excludedGamblingRisk

enum (Gambling)

ایمنی نمانام - قمار.
excludedAdFraudRisk

enum (AdFraudPrevention)

تنظیمات «تقلب در آگهی».
displayViewability

enum (DisplayViewability)

بخش «رؤیت‌پذیری نمایش» (فقط برای ردیف‌های نمایشی قابل‌اعمال است).
videoViewability

enum (VideoViewability)

بخش قابل‌مشاهده بودن ویدیو (فقط برای سطرهای هدف ویدیویی قابل اعمال است).
customSegmentId[]

string (int64 format)

شناسه بخش سفارشی ارائه‌شده توسط Integral Ad Science. شناسه باید بین 1000001 و 1999999 یا 3000001 و 3999999، فراگیر باشد.
qualitySyncCustomSegmentId[]

string (int64 format)

اختیاری. شناسه بخش سفارشی همگام‌سازی کیفیت که Integral Ad Science ارائه کرده است. شناسه باید مساوی یا بین 3000000 و 4999999 باشد.

TRAQScore

محدوده امتیازهای احتمالی Integral Ad Science TRAQ (کیفیت واقعی تبلیغات).

شمارشی‌ها
TRAQ_UNSPECIFIED این شمارش فقط یک جای‌بان است و هیچ امتیاز واقعی کیفیت تبلیغات را مشخص نمی‌کند.
TRAQ_250 امتیاز TRAQ بین ۲۵۰ تا ۱۰۰۰.
TRAQ_500 امتیاز TRAQ بین ۵۰۰ تا ۱۰۰۰.
TRAQ_600 امتیاز TRAQ بین ۶۰۰ تا ۱۰۰۰.
TRAQ_700 امتیاز TRAQ بین ۷۰۰ تا ۱۰۰۰.
TRAQ_750 امتیاز TRAQ بین ۷۵۰ تا ۱۰۰۰.
TRAQ_875 امتیاز TRAQ بین ۸۷۵ تا ۱۰۰۰.
TRAQ_1000 امتیاز TRAQ ۱۰۰۰.

بزرگسال

گزینه‌های احتمالی Integral Ad Science Adult.

شمارشی‌ها
ADULT_UNSPECIFIED این شمارش فقط یک جای‌بان است و هیچ گزینه بزرگسالی را مشخص نمی‌کند.
ADULT_HR بزرگسالان - مستثنی کردن پرخطر.
ADULT_HMR بزرگسال - مستثنی کردن ریسک بالا و متوسط.

الکل

گزینه‌های احتمالی Integral Ad Science Alcohol.

شمارشی‌ها
ALCOHOL_UNSPECIFIED این شمارش فقط یک جای‌بان است و هیچ گزینه الکلی را مشخص نمی‌کند.
ALCOHOL_HR الکل - مستثنی کردن پرخطر.
ALCOHOL_HMR الکل - مستثنی کردن ریسک بالا و متوسط.

IllegalDownloads

گزینه‌های احتمالی بارگیری‌های غیرقانونی Integral Ad Science.

شمارشی‌ها
ILLEGAL_DOWNLOADS_UNSPECIFIED این شمارش فقط یک جای‌بان است و هیچ گزینه بارگیری غیرقانونی را مشخص نمی‌کند.
ILLEGAL_DOWNLOADS_HR بارگیری‌های غیرقانونی - مستثنی کردن پرخطر.
ILLEGAL_DOWNLOADS_HMR بارگیری‌های غیرقانونی - ریسک بالا و متوسط را مستثنی کنید.

مواد مخدر

گزینه‌های ممکن Integral Ad Science Drugs.

شمارشی‌ها
DRUGS_UNSPECIFIED این شمارش فقط یک جای‌بان است و هیچ گزینه دارویی را مشخص نمی‌کند.
DRUGS_HR مواد مخدر - مستثنی کردن پرخطر.
DRUGS_HMR مواد مخدر - خطر زیاد و متوسط را مستثنی کنید.

HateSpeech

گزینه‌های احتمالی سخنان مشوق عداوت و تنفر Integral Ad Science.

شمارشی‌ها
HATE_SPEECH_UNSPECIFIED این enum فقط یک جای‌بان است و هیچ گزینه سخنان مشوق عداوت و تنفر را مشخص نمی‌کند.
HATE_SPEECH_HR Hate Speech - Exclude High Risk.
HATE_SPEECH_HMR سخنان مشوق عداوت و تنفر - حذف ریسک بالا و متوسط.

OffensiveLanguage

گزینه‌های احتمالی کلمات توهین‌آمیز Integral Ad Science.

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

خشونت

گزینه‌های احتمالی خشونت Integral Ad Science.

شمارشی‌ها
VIOLENCE_UNSPECIFIED این enum فقط یک جای‌بان است و هیچ گزینه خشونتی را مشخص نمی‌کند.
VIOLENCE_HR خشونت - پرخطر مستثنی شود.
VIOLENCE_HMR خشونت - مستثنی کردن خطر زیاد و متوسط.

قمار

گزینه‌های احتمالی قمار Integral Ad Science.

شمارشی‌ها
GAMBLING_UNSPECIFIED این شمارش فقط یک جای‌بان است و هیچ گزینه قماربازی را مشخص نمی‌کند.
GAMBLING_HR قمار - مستثنی کردن پرخطر.
GAMBLING_HMR قمار - مستثنی کردن ریسک بالا و متوسط.

AdFraudPrevention

گزینه‌های ممکن برای جلوگیری از تقلب در آگهی Integral Ad Science.

شمارشی‌ها
SUSPICIOUS_ACTIVITY_UNSPECIFIED این شمارش فقط یک جای‌بان است و هیچ گزینه جلوگیری از کلاهبرداری در آگهی را مشخص نمی‌کند.
SUSPICIOUS_ACTIVITY_HR تقلب در آگهی - مستثنی کردن پرخطر.
SUSPICIOUS_ACTIVITY_HMR تقلب در آگهی - مستثنی کردن ریسک بالا و متوسط.
SUSPICIOUS_ACTIVITY_FD تقلب در آگهی - مستثنی کردن دستگاه کلاهبردار.

DisplayViewability

گزینه‌های احتمالی رؤیت‌پذیری Integral Ad Science Display.

شمارشی‌ها
PERFORMANCE_VIEWABILITY_UNSPECIFIED این enum فقط یک جای‌بان است و هیچ گزینه رؤیت‌پذیری نمایشی را مشخص نمی‌کند.
PERFORMANCE_VIEWABILITY_40 هدف‌گذاری رؤیت‌پذیری ۴۰٪ یا بالاتر.
PERFORMANCE_VIEWABILITY_50 هدف‌گذاری ۵۰٪ رؤیت‌پذیری یا بالاتر.
PERFORMANCE_VIEWABILITY_60 هدف‌گذاری ۶۰٪ رؤیت‌پذیری یا بالاتر.
PERFORMANCE_VIEWABILITY_70 هدف‌گذاری ۷۰٪ رؤیت‌پذیری یا بالاتر.

VideoViewability

گزینه‌های احتمالی رؤیت‌پذیری ویدیو Integral Ad Science.

شمارشی‌ها
VIDEO_VIEWABILITY_UNSPECIFIED این enum فقط یک جای‌بان است و هیچ گزینه قابل‌مشاهده بودن ویدیو را مشخص نمی‌کند.
VIDEO_VIEWABILITY_40 بیش‌از ۴۰٪ در نما (استاندارد قابل‌مشاهده بودن ویدیو IAB).
VIDEO_VIEWABILITY_50 بیش‌از ۵۰٪ در نما (استاندارد قابل‌مشاهده بودن ویدیو IAB).
VIDEO_VIEWABILITY_60 ‫٪۶۰+ در دید (استاندارد رؤیت‌پذیری ویدیو IAB).
VIDEO_VIEWABILITY_70 بیش‌از ۷۰٪ در نمای دید (استاندارد رؤیت‌پذیری ویدیو IAB).

Peer39

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

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

enum (FraudIvtMfaCategory)

اختیاری. دسته‌های کلاهبرداری IVT MFA مربوط به Peer39 برای مستثنی کردن.
adultExplicitSexualContent

enum (GarmRiskExclusion)

اختیاری. محدوده‌های ریسک GARM برای محتوای جنسی صریح و بزرگسالان برای مستثنی کردن.
crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent

enum (GarmRiskExclusion)

اختیاری. محدوده‌های خطر GARM برای محتوای مربوط به جرم و اعمال مضر که باید مستثنی شوند.
armsAmmunitionContent

enum (GarmRiskExclusion)

اختیاری. محدوده‌های خطر GARM برای محتوای مربوط به سلاح و مهمات که باید مستثنی شود.
deathInjuryMilitaryConflictContent

enum (GarmRiskExclusion)

اختیاری. محدوده خطر GARM برای مستثنی کردن محتوای مربوط به مرگ، جراحت، یا درگیری نظامی.
debatedSensitiveSocialIssueContent

enum (GarmRiskExclusion)

اختیاری. محدوده‌های ریسک GARM برای محتوای مسائل اجتماعی حساس موردبحث برای مستثنی کردن.
illegalDrugsTobaccoEcigarettesVapingAlcoholContent

enum (GarmRiskExclusion)

اختیاری. محدوده‌های خطر GARM برای محتوای مربوط به الکل/مواد مخدر غیرقانونی که باید مستثنی شود.
onlinePiracyContent

enum (GarmRiskExclusion)

اختیاری. محدوده‌های خطر GARM برای محتوای دزدی آنلاین که باید مستثنی شوند.
hateSpeechActsAggressionContent

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

اختیاری. محدوده‌های خطر GARM برای محتوای مستهجن و ناسزا که باید مستثنی شود.
spamHarmfulContent

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

اختیاری. محدوده‌های خطر GARM محتوای تروریستی برای مستثنی کردن.
misinformationContent

enum (GarmRiskExclusion)

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

enum (DisplayIabViewability)

اختیاری. آستانه قابل‌مشاهده بودن IAB برای آگهی‌های تصویری.
videoIabViewability

enum (VideoIabViewability)

اختیاری. آستانه قابل‌مشاهده بودن IAB برای آگهی‌های ویدیویی.

FraudIvtMfaCategory

دسته‌های موجود Peer39 Fraud،‏ IVT،‏ MFA.

شمارشی‌ها
FRAUD_IVT_MFA_CATEGORY_UNSPECIFIED مقدار پیش‌فرض وقتی دسته Peer39 Fraud،‏ IVT،‏ MFA در این نسخه مشخص نشده یا ناشناخته است.
FRAUD_IVT_MFA کلاهبرداری، ترافیک نامعتبر، وب‌سایت‌های ساخته‌شده برای آگهی.

GarmRiskExclusion

گزینه‌های حذف سطح خطر GARM دردسترس است.

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

DisplayIabViewability

آستانه‌های رؤیت‌پذیری نمایش IAB Peer39 دردسترس.

شمارشی‌ها
DISPLAY_IAB_VIEWABILITY_UNSPECIFIED مقدار پیش‌فرض وقتی مشخص نشده باشد یا در این نسخه ناشناخته باشد.
DISPLAY_IAB_VIEWABILITY_10 ‫۱۰٪+ در نما (استاندارد رؤیت‌پذیری نمایش IAB).
DISPLAY_IAB_VIEWABILITY_20 بیش‌از ۲۰٪ در دید (استاندارد رؤیت‌پذیری نمایش IAB).
DISPLAY_IAB_VIEWABILITY_35 ‫۳۵٪+ در نما (استاندارد رؤیت‌پذیری نمایش IAB).
DISPLAY_IAB_VIEWABILITY_50 ‫۵۰٪+ در نما (استاندارد رؤیت‌پذیری نمایش IAB).
DISPLAY_IAB_VIEWABILITY_75 ‫٪۷۵+ در نما (استاندارد رؤیت‌پذیری نمایش IAB).

VideoIabViewability

آستانه‌های قابل‌مشاهده بودن ویدیو Peer39 IAB دردسترس.

شمارشی‌ها
VIDEO_IAB_VIEWABILITY_UNSPECIFIED مقدار پیش‌فرض وقتی مشخص نشده باشد یا در این نسخه ناشناخته باشد.
VIDEO_IAB_VIEWABILITY_10 ‫۱۰٪+ در نمای (استاندارد قابل‌مشاهده بودن ویدیو IAB).
VIDEO_IAB_VIEWABILITY_20 بیش‌از ۲۰٪ در دید (استاندارد قابل‌مشاهده بودن ویدیو IAB).
VIDEO_IAB_VIEWABILITY_35 ‫۳۵٪+ در نمای (استاندارد رؤیت‌پذیری ویدیو IAB).
VIDEO_IAB_VIEWABILITY_50 بیش‌از ۵۰٪ در نما (استاندارد قابل‌مشاهده بودن ویدیو IAB).
VIDEO_IAB_VIEWABILITY_75 ‫٪۷۵+ در نمای (استاندارد رؤیت‌پذیری ویدیو IAB).

PoiAssignedTargetingOptionDetails

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

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

string

فقط خروجی. نام نمایشی نقطه موردعلاقه، مثلاً «میدان تایمز»، «اسپیس نیدل»، و به‌دنبال آن نشانی کامل آن درصورت دردسترس بودن.
targetingOptionId

string

الزامی. targetingOptionId مربوط به TargetingOption از نوع TARGETING_TYPE_POI.

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

اگر مختصات طول/عرض جغرافیایی خاصی را هدف‌یابی می‌کنید که از نام نقطه موردعلاقه یا نشانی حذف شده است، می‌توانید شناسه گزینه هدف‌یابی لازم را با گرد کردن مقادیر مختصات موردنظر تا رقم ششم اعشار، حذف اعشار، و پیوند دادن مقادیر رشته‌ای جداشده با نقطه‌ویرگول تولید کنید. برای مثال، می‌توانید جفت عرض/طول جغرافیایی 40.7414691, -74.003387 را بااستفاده از شناسه گزینه هدف‌یابی «40741469;-74003387» هدف‌یابی کنید. پس‌از ایجاد، مقدار این فیلد به‌روزرسانی می‌شود تا یک نقطه‌ویرگول و مقدار درهم‌سازی الفبایی-عددی اضافه شود، اگر فقط مختصات عرض جغرافیایی/طول جغرافیایی ارائه شده باشد.
latitude

number

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

number

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

number

الزامی. شعاع ناحیه اطراف نقطه موردعلاقه که هدف‌یابی خواهد شد. واحد شعاع با proximityRadiusUnit مشخص می‌شود. اگر واحد DISTANCE_UNIT_KILOMETERS باشد، باید ۱ تا ۸۰۰ باشد و اگر واحد DISTANCE_UNIT_MILES باشد، باید ۱ تا ۵۰۰ باشد.
proximityRadiusUnit

enum (DistanceUnit)

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

DistanceUnit

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

شمارشی‌ها
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 باشد، باید ۱ تا ۸۰۰ باشد و اگر واحد DISTANCE_UNIT_MILES باشد، باید ۱ تا ۵۰۰ باشد. حداقل افزایش برای هر دو مورد ۰٫۱ است. اگر ورودی‌ها بیش‌ازحد جزئی باشند، به نزدیک‌ترین مقدار قابل‌قبول گرد می‌شوند، مثلاً ۱۵٫۵۷ به ۱۵٫۶ تبدیل می‌شود.
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 
{
  "contentPosition": enum (NativeContentPosition)
}
فیلدها
contentPosition

enum (NativeContentPosition)

الزامی. جایگاه محتوا.

OmidAssignedTargetingOptionDetails

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

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

enum (Omid)

الزامی. نوع فضای آگهی فعال‌شده با «اندازه‌گیری باز».

AudioContentTypeAssignedTargetingOptionDetails

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

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

enum (AudioContentType)

الزامی. نوع محتوای صوتی.

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

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

YoutubeVideoAssignedTargetingOptionDetails

جزئیات گزینه هدف‌یابی اختصاص‌داده‌شده به ویدیو YouTube. وقتی targetingType TARGETING_TYPE_YOUTUBE_VIDEO باشد، این مورد در فیلد youtubeVideoDetails پر می‌شود.

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

string

شناسه ویدیو YouTube همان‌طور که در صفحه تماشای YouTube نشان داده می‌شود.
negative

boolean

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

YoutubeChannelAssignedTargetingOptionDetails

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

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

string

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

boolean

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

SessionPositionAssignedTargetingOptionDetails

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

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

enum (SessionPosition)

جایگاهی که آگهی در جلسه نشان داده خواهد شد.

SessionPosition

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

شمارشی‌ها
SESSION_POSITION_UNSPECIFIED این جای‌بان است و هیچ جایگاهی را نشان نمی‌دهد.
SESSION_POSITION_FIRST_IMPRESSION اولین ظهور جلسه.

LookalikeAudienceAssignedTargetingOptionDetails

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

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

string (int64 format)

الزامی. شناسه مخاطب مشابه.
negative

boolean

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

GoogleAudienceAssignedTargetingOptionDetails

جزئیات گزینه هدف‌یابی مخاطب Google. وقتی targetingType TARGETING_TYPE_GOOGLE_AUDIENCE باشد، این مقدار در فیلد جزئیات AssignedTargetingOption درج می‌شود.

نمایش JSON 
{
  "googleAudienceId": string,
  "googleAudienceType": enum (GoogleAudienceType),
  "negative": boolean
}
فیلدها
googleAudienceId

string (int64 format)

الزامی. شناسه مخاطب Google.
googleAudienceType

enum (GoogleAudienceType)

الزامی. نوع مخاطب Google.
negative

boolean

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

CustomListAssignedTargetingOptionDetails

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

نمایش JSON 
{
  "customListId": string,
  "customListType": enum (CustomListType)
}
فیلدها
customListId

string (int64 format)

الزامی. شناسه فهرست سفارشی.
customListType

enum (CustomListType)

الزامی. نوع فهرست سفارشی.

CustomListType

انواع ممکن فهرست سفارشی.

شمارشی‌ها
CUSTOM_LIST_TYPE_UNSPECIFIED مقدار پیش‌فرض وقتی نوع مشخص نشده یا ناشناخته است.
CUSTOM_LIST_TYPE_CUSTOM_AFFINITY فهرست سفارشی نوع همگرای سفارشی.
CUSTOM_LIST_TYPE_CUSTOM_INTENT فهرست سفارشی نوع قصد سفارشی.

CombinedAudienceAssignedTargetingOptionDetails

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

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

string (int64 format)

الزامی. شناسه مخاطب ترکیبی.

FirstPartyAndPartnerAudienceAssignedTargetingOptionDetails

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

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

string (int64 format)

الزامی. شناسه مخاطب طرف اول یا شریک.
negative

boolean

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

AuctionPackageAssignedTargetingOptionDetails

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

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

string

الزامی. targetingOptionId مربوط به TargetingOption از نوع TARGETING_TYPE_AUCTION_PACKAGE.
displayName

string

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

YoutubeChannelPackAssignedTargetingOptionDetails

جزئیات گزینه هدف‌یابی اختصاص‌داده‌شده به بسته کانال YouTube. وقتی targetingType TARGETING_TYPE_YOUTUBE_CHANNEL_PACK باشد، این مورد در فیلد youtubeChannelPackDetails پر می‌شود.

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

string (int64 format)

الزامی. شناسه بسته کانال YouTube.
negative

boolean

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

میراث

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

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

روش‌ها

create

 گزینه هدف‌یابی را به گروه آگهی اختصاص می‌دهد.

delete

 گزینه هدف‌یابی واگذارشده را از گروه آگهی حذف می‌کند.

get

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

list

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