REST Resource: curators.curatedPackages

منبع: CuratedPackage

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

نمایش JSON 
{
  "name": string,
  "displayName": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "floorPriceCpm": {
    object (Money)
  },
  "state": enum (State),
  "accessSettings": {
    object (AccessControlSettings)
  },
  "targeting": {
    object (PackageTargeting)
  },
  "curationFeeVisibility": enum (CurationFeeVisibility),

  // Union field fee can be only one of the following:
  "feeCpm": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of list of possible types for union field fee.
}
فیلدها
name

string

شناسه. نام منبع منحصر به فرد برای بسته‌ی گزینش‌شده. قالب: curators/{accountId}/curatedPackages/{curatedPackageId}

displayName

string

الزامی. نام نمایشی که توسط curator به بسته‌ی گزینش‌شده اختصاص داده شده است. می‌تواند برای فیلتر کردن پاسخ متد curatedPackages.list استفاده شود.

description

string

اختیاری. توضیحی از بسته‌ی گردآوری‌شده، که توسط متصدی ارائه می‌شود.

createTime

string ( Timestamp format)

فقط خروجی. مهر زمانی که بسته‌ی گزینش‌شده ایجاد شده است. می‌تواند برای فیلتر کردن پاسخ متد curatedPackages.list استفاده شود.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

updateTime

string ( Timestamp format)

فقط خروجی. نشانگر زمانی آخرین به‌روزرسانی بسته‌ی گزینش‌شده. می‌تواند برای فیلتر کردن پاسخ متد curatedPackages.list استفاده شود.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

floorPriceCpm

object ( Money )

اختیاری. حداقل CPM که یک خریدار برای شرکت در مزایده موجودی در این بسته انتخاب شده باید پیشنهاد دهد. می‌تواند برای فیلتر کردن پاسخ متد curatedPackages.list استفاده شود.

state

enum ( State )

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

accessSettings

object ( AccessControlSettings )

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

دسترسی به این بسته‌ی گزینش‌شده محدود به برنامه‌ریزان رسانه‌ای مجاز و خالق اثر است. خریداران و پیشنهاددهندگان نمی‌توانند برای این منبع در فهرست مجاز قرار گیرند یا به آن دسترسی مستقیم داشته باشند.

targeting

object ( PackageTargeting )

اختیاری. معیارهای هدف‌گذاری برای بسته‌ی منتخب.

curationFeeVisibility

enum ( CurationFeeVisibility )

اختیاری. تغییرناپذیر. قابل مشاهده بودن هزینه ترکیبی بسته گزینش و هزینه‌های بخش داده (کل هزینه گزینش).

fee میدانی اتحادیه. هزینه‌ای که برای این بسته به متصدی پرداخت می‌شود. fee می‌تواند فقط یکی از موارد زیر باشد:
feeCpm

object ( Money )

اختیاری. هزینه CPM که توسط متصدی از خریدارانی که از این بسته گزینش‌شده استفاده می‌کنند، دریافت می‌شود. می‌تواند برای فیلتر کردن پاسخ متد curatedPackages.list استفاده شود.

millipercentOfMediaFee

string ( int64 format)

اختیاری. هزینه به صورت درصدی از هزینه نمایش، که به صورت میلی‌پردنت نشان داده می‌شود، دریافت می‌شود. به عنوان مثال، ۱٪ معادل ۱۰۰۰ است.

ایالت

وضعیت بسته‌ی گزینش‌شده.

انوم‌ها
STATE_UNSPECIFIED مقدار پیش‌فرض.
ACTIVE بسته‌ی انتخاب‌شده فعال است.
INACTIVE بسته‌ی اصلاح‌شده غیرفعال است.

تنظیمات کنترل دسترسی

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

نمایش JSON 
{
  "allowlistedMediaPlanners": [
    string
  ]
}
فیلدها
allowlistedMediaPlanners[]

string

الزامی. تغییرناپذیر. فهرست برنامه‌ریزان رسانه‌ای که صراحتاً به آنها اجازه دسترسی به بسته‌ی گزینش‌شده داده شده است. برنامه‌ریزان رسانه‌ای واجد شرایط را می‌توان در متد mediaPlanners.list یافت. در حال حاضر فقط یک برنامه‌ریز رسانه‌ای می‌تواند مجاز به فهرست شدن باشد.

قالب: mediaPlanners/{mediaPlannerAccountId}

هدف‌گیری بسته

معیارهای هدف‌گذاری برای بسته‌های منتخب و حراجی.

نمایش JSON 
{
  "includedDeviceTypes": [
    enum (DeviceType)
  ],
  "includedEnvironment": enum (Environment),
  "includedCreativeFormat": enum (CreativeFormat),
  "includedAcceleratedMobilePageType": enum (AcceleratedMobilePageType),
  "includedAuthorizedSellerStatuses": [
    enum (AuthorizedSellerStatus)
  ],
  "includedNativeInventoryTypes": [
    enum (NativeInventoryType)
  ],
  "includedOpenMeasurementTypes": [
    enum (OpenMeasurementType)
  ],
  "includedRestrictedCategories": [
    enum (RestrictedCategory)
  ],
  "includedRewardedType": enum (RewardedType),
  "videoTargeting": {
    object (PackageVideoTargeting)
  },
  "minimumPredictedViewabilityPercentage": string,
  "languageTargeting": {
    object (StringTargetingDimension)
  },
  "includedAdSizes": [
    {
      object (AdSize)
    }
  ],
  "publisherTargeting": {
    object (StringTargetingDimension)
  },
  "minimumPredictedClickThroughRatePercentageMillis": string,
  "verticalTargeting": {
    object (CriteriaTargeting)
  },
  "geoTargeting": {
    object (CriteriaTargeting)
  },
  "includedDataSegments": [
    string
  ],
  "placementTargeting": {
    object (PackagePlacementTargeting)
  },
  "publisherProvidedSignalsTargeting": {
    object (PackagePublisherProvidedSignalsTargeting)
  }
}
فیلدها
includedDeviceTypes[]

enum ( DeviceType )

اختیاری. فهرست انواع دستگاه‌های موجود برای هدف‌گیری. اگر خالی باشد، همه انواع دستگاه‌ها هدف‌گیری می‌شوند.

includedEnvironment

enum ( Environment )

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

includedCreativeFormat

enum ( CreativeFormat )

اختیاری. قالب خلاقانه برای هدف‌گیری. اگر تنظیم نشود، همه انواع نشانه‌گذاری خلاقانه هدف‌گیری می‌شوند.

includedAcceleratedMobilePageType

enum ( AcceleratedMobilePageType )

اختیاری. نوع صفحه موبایل شتاب‌یافته هدفمند. اگر تنظیم نشود، موجودی صرف نظر از وضعیت AMP هدف قرار می‌گیرد.

includedAuthorizedSellerStatuses[]

enum ( AuthorizedSellerStatus )

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

includedNativeInventoryTypes[]

enum ( NativeInventoryType )

اختیاری. انواع موجودی بومی هدفمند. در صورت خالی بودن، موجودی صرف نظر از نوع موجودی بومی هدفمند خواهد شد.

includedOpenMeasurementTypes[]

enum ( OpenMeasurementType )

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

includedRestrictedCategories[]

enum ( RestrictedCategory )

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

includedRewardedType

enum ( RewardedType )

اختیاری. نوع پاداش هدفمند. اگر تنظیم نشود، موجودی صرف نظر از نوع پاداش، هدفمند خواهد شد.

videoTargeting

object ( PackageVideoTargeting )

اختیاری. معیارهای هدف‌گذاری خاص ویدیو.

minimumPredictedViewabilityPercentage

string ( int64 format)

اختیاری. حداقل درصد پیش‌بینی‌شده‌ی قابلیت مشاهده‌ی هدفمند.

این مقدار باید مضربی از ۱۰ بین ۱۰ تا ۹۰ (شامل) باشد. برای مثال، ۱۰ معتبر است، اما ۰، ۱۵ و ۱۰۰ معتبر نیستند. مقدار ۱۰ به این معنی است که پیکربندی فقط با تبلیغات اسلات‌هایی مطابقت دارد که حداقل ۱۰٪ قابلیت مشاهده را برای آنها پیش‌بینی می‌کنیم.

مقدار نامشخص نشان می‌دهد که موجودی صرف نظر از میزان مشاهده پیش‌بینی‌شده، هدف قرار خواهد گرفت.

languageTargeting

object ( StringTargetingDimension )

اختیاری. زبان‌های مورد نظر برای هدف‌گیری. در صورت عدم تنظیم، موجودی صرف نظر از زبان هدف‌گیری خواهد شد. برای مشاهده لیست کدهای زبان پشتیبانی شده، به https://developers.google.com/google-ads/api/data/codes-formats#languages ​​مراجعه کنید.

includedAdSizes[]

object ( AdSize )

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

بسته‌های منتخب از اندازه‌های تبلیغات PIXEL و INTERSTITIAL پشتیبانی می‌کنند.

publisherTargeting

object ( StringTargetingDimension )

اختیاری. ناشران هدف. در صورت عدم تنظیم، موجودی صرف نظر از ناشر هدف قرار می‌گیرد. ناشران با شناسه ناشر خود از ads.txt / app-ads.txt شناسایی می‌شوند. برای جزئیات بیشتر به https://iabtechlab.com/ads-txt/ و https://iabtechlab.com/app-ads-txt/ مراجعه کنید.

minimumPredictedClickThroughRatePercentageMillis

string ( int64 format)

اختیاری. حداقل نرخ کلیک پیش‌بینی‌شده‌ی هدف، که در مقادیر [10، 10000] (0.01% - 10%) متغیر است. مقدار 50 به این معنی است که پیکربندی فقط با اسلات‌های تبلیغاتی مطابقت دارد که برای آنها حداقل نرخ کلیک 0.05% پیش‌بینی می‌کنیم.

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

verticalTargeting

object ( CriteriaTargeting )

اختیاری. موارد عمودی طبق تعریف https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals لحاظ یا حذف می‌شوند. در صورت عدم تنظیم، موجودی صرف نظر از نوع عمودی هدف قرار می‌گیرد.

geoTargeting

object ( CriteriaTargeting )

اختیاری. شناسه‌های معیارهای جغرافیایی که باید لحاظ یا حذف شوند، همانطور که در https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv تعریف شده است. در صورت عدم تنظیم، موجودی صرف نظر از موقعیت جغرافیایی هدف قرار می‌گیرد.

includedDataSegments[]

string

اختیاری. بخش‌های داده فعال که باید هدف قرار گیرند. در صورت عدم تنظیم، موجودی صرف نظر از بخش‌های داده هدف قرار خواهد گرفت. قالب: curators/{accountId}/dataSegments/{data_segment_id}

placementTargeting

object ( PackagePlacementTargeting )

اختیاری. اطلاعات هدف‌گذاری جایگاه، به عنوان مثال، URL، برنامه‌های تلفن همراه.

publisherProvidedSignalsTargeting

object ( PackagePublisherProvidedSignalsTargeting )

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

نوع دستگاه

نوع کلی دستگاه مورد نظر برای هدف قرار دادن.

انوم‌ها
DEVICE_TYPE_UNSPECIFIED مقدار پیش‌فرض. نباید در مشخصات هدف‌گیری استفاده شود.
DEVICE_TYPE_PERSONAL_COMPUTER کامپیوترهای رومیزی یا لپ‌تاپ را هدف قرار می‌دهد.
DEVICE_TYPE_CONNECTED_TV تلویزیون‌های متصل را هدف قرار می‌دهد: دستگاه‌هایی که محتوای تلویزیون را پخش می‌کنند، از جمله تلویزیون‌های هوشمند، کنسول‌های بازی و جعبه‌ها/استیک‌های پخش.
DEVICE_TYPE_PHONE دستگاه‌های تلفن همراه رده بالا را هدف قرار می‌دهد.
DEVICE_TYPE_TABLET دستگاه‌های تبلت را هدف قرار می‌دهد.

محیط زیست

محیطی که باید هدف قرار گیرد.

انوم‌ها
ENVIRONMENT_UNSPECIFIED مقدار پیش‌فرض. نباید در مشخصات هدف‌گیری استفاده شود.
ENVIRONMENT_SITE موجودی ارائه شده در یک وب‌سایت دارای تبلیغات را هدف قرار می‌دهد.
ENVIRONMENT_APP موجودی را در یک برنامه تلفن همراه هدف قرار می‌دهد.

قالب خلاقانه

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

انوم‌ها
CREATIVE_FORMAT_UNSPECIFIED مقدار پیش‌فرض. نباید در مشخصات هدف‌گیری استفاده شود.
CREATIVE_FORMAT_DISPLAY جایگاه‌های تبلیغاتی در نظر گرفته شده برای تبلیغات نمایشی HTML را هدف قرار می‌دهد.
CREATIVE_FORMAT_VIDEO جایگاه‌های تبلیغاتی در نظر گرفته شده برای تولیدکنندگان ویدیو را هدف قرار می‌دهد.
CREATIVE_FORMAT_AUDIO جایگاه‌های تبلیغاتی در نظر گرفته شده برای تولیدکنندگان صدا را هدف قرار می‌دهد.

نوع صفحه موبایل شتاب‌یافته

نوع پیاده‌سازی صفحه موبایلی پرشتاب (AMP) که قرار است هدف قرار گیرد.

انوم‌ها
ACCELERATED_MOBILE_PAGE_TYPE_UNSPECIFIED مقدار پیش‌فرض. نباید در مشخصات هدف‌گیری استفاده شود.
ACCELERATED_MOBILE_PAGE_TYPE_NON_AMP موجودی را در صفحات وب استاندارد که از هیچ چارچوب AMP استفاده نمی‌کنند، هدف قرار می‌دهد.
ACCELERATED_MOBILE_PAGE_TYPE_AMP موجودی را در صفحاتی که با استفاده از چارچوب اصلی AMP HTML ساخته شده‌اند، هدف قرار می‌دهد.
ACCELERATED_MOBILE_PAGE_TYPE_AMP_STORY موجودی را در صفحاتی که از قالب AMP Story (STAMP) استفاده می‌کنند، هدف قرار می‌دهد، که برای داستان‌سرایی بصری (مثلاً تجربیات تمام صفحه قابل لمس) بهینه شده است.

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

رابطه بین ناشر و فروشنده را همانطور که در فایل ads.txt یا app-ads.txt اعلام شده است، نشان می‌دهد.

انوم‌ها
AUTHORIZED_SELLER_STATUS_UNSPECIFIED مقدار پیش‌فرض. نباید در مشخصات هدف‌گیری استفاده شود.
AUTHORIZED_SELLER_STATUS_DIRECT موجودی را هدف قرار می‌دهد که فروشنده به عنوان «مستقیم» اعلام شده است. این نشان می‌دهد که ناشر (مالک محتوا) مستقیماً حساب فروشنده را کنترل می‌کند و قرارداد تجاری مستقیمی با سیستم تبلیغاتی برای این حساب دارد.
AUTHORIZED_SELLER_STATUS_RESELLER موجودی را هدف قرار می‌دهد که فروشنده به عنوان «فروشنده‌ی واسطه» اعلام شده است. این نشان می‌دهد که ناشر به نهاد دیگری اجازه داده است تا حساب فروشنده‌ی فهرست‌شده را اداره کند و فضای تبلیغاتی خود را دوباره بفروشد.

نوع موجودی بومی

نوع رندر خلاقانه‌ای را که یک جایگاه تبلیغاتی پشتیبانی می‌کند، به‌ویژه در رابطه با تبلیغات بومی، نشان می‌دهد.

انوم‌ها
NATIVE_INVENTORY_TYPE_UNSPECIFIED مقدار پیش‌فرض. نباید در مشخصات هدف‌گیری استفاده شود.
NATIVE_INVENTORY_TYPE_NATIVE_ONLY جایگاه‌های تبلیغاتی را هدف قرار می‌دهد که فقط تبلیغات بومی را می‌پذیرند و نمایش می‌دهند.
NATIVE_INVENTORY_TYPE_NATIVE_OR_BANNER جایگاه‌های تبلیغاتی را هدف قرار می‌دهد که تبلیغات بومی یا بنری را می‌پذیرند و نمایش می‌دهند.

نوع اندازه‌گیری باز

نوع تعریف رابط اندازه‌گیری باز (OMID) که باید هدف قرار گیرد.

انوم‌ها
OPEN_MEASUREMENT_TYPE_UNSPECIFIED مقدار پیش‌فرض. نباید در مشخصات هدف‌گیری استفاده شود.
OPEN_MEASUREMENT_TYPE_OMID_V1 موجودی‌هایی را هدف قرار می‌دهد که از تعریف رابط اندازه‌گیری باز (OMID) نسخه ۱ پشتیبانی می‌کنند.

دسته‌بندی محدود

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

انوم‌ها
RESTRICTED_CATEGORY_UNSPECIFIED مقدار پیش‌فرض. نباید در مشخصات هدف‌گیری استفاده شود.
RESTRICTED_CATEGORY_ALCOHOL موجودی‌هایی را هدف قرار می‌دهد که در آنها تبلیغات الکل توسط ناشر مجاز است.
RESTRICTED_CATEGORY_GAMBLING موجودی را هدف قرار می‌دهد که در آن ناشر تبلیغات قمار را مجاز می‌داند.

نوع پاداش‌دار

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

انوم‌ها
REWARDED_TYPE_UNSPECIFIED مقدار پیش‌فرض. نباید در مشخصات هدف‌گیری استفاده شود.
REWARDED_TYPE_NON_REWARDED موجودی را هدف قرار می‌دهد که پاداش صریحی برای تماشا یا تعامل با تبلیغ به کاربر ارائه نمی‌دهد.
REWARDED_TYPE_REWARDED موجودی را هدف قرار می‌دهد که در ازای تماشا یا تعامل با تبلیغ، به کاربر پاداش می‌دهد.

هدف‌گیری ویدیویی بسته

معیارهای هدف‌گذاری خاص ویدیو.

نمایش JSON 
{
  "includedMimeTypes": [
    enum (VideoMimeType)
  ],
  "includedMaximumAdDurationTargeting": enum (MaximumVideoAdDuration),
  "includedPositionTypes": [
    enum (PositionType)
  ],
  "includedContentDeliveryMethod": enum (ContentDeliveryMethod),
  "plcmtTargeting": {
    object (VideoPlcmtTargeting)
  },
  "includedPlaybackMethods": [
    enum (PlaybackMethod)
  ],
  "minimumPredictedCompletionRatePercentage": string,
  "includedPlayerSizeTargeting": {
    object (VideoPlayerSizeTargeting)
  }
}
فیلدها
includedMimeTypes[]

enum ( VideoMimeType )

اختیاری. فهرست انواع MIME ویدیویی هدفمند با استفاده از رشته‌های MIME منتشر شده توسط IANA ( https://www.iana.org/assignments/media-types/media-types.xhtml ) . در صورت خالی بودن، فهرست صرف نظر از نوع MIME ویدیویی هدف قرار می‌گیرد.

includedMaximumAdDurationTargeting

enum ( MaximumVideoAdDuration )

اختیاری. حداکثر مدت زمان تبلیغات ویدیویی هدفمند. در صورت عدم تنظیم، موجودی صرف نظر از حداکثر مدت زمان تبلیغات ویدیویی هدفمند خواهد شد.

includedPositionTypes[]

enum ( PositionType )

اختیاری. انواع موقعیت‌های تبلیغات ویدیویی هدفمند. در صورت خالی بودن، موجودی صرف نظر از نوع موقعیت تبلیغات ویدیویی، هدفمند خواهد شد.

includedContentDeliveryMethod

enum ( ContentDeliveryMethod )

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

plcmtTargeting

object ( VideoPlcmtTargeting )

اختیاری. انواع PLCM ویدیویی هدفمند. در صورت عدم تنظیم، موجودی صرف نظر از نوع PLCM ویدیویی هدفمند خواهد شد.

includedPlaybackMethods[]

enum ( PlaybackMethod )

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

minimumPredictedCompletionRatePercentage

string ( int64 format)

اختیاری. حداقل درصد نرخ تکمیل پیش‌بینی‌شده‌ی هدف‌گذاری‌شده.

این مقدار باید مضربی از ۱۰ بین ۱۰ تا ۹۰ (شامل) باشد. برای مثال، ۱۰ معتبر است، اما ۰، ۱۵ و ۱۰۰ معتبر نیستند. مقدار ۱۰ به این معنی است که پیکربندی فقط با adslotهایی مطابقت دارد که ما حداقل ۱۰٪ نرخ تکمیل را برای آنها پیش‌بینی می‌کنیم.

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

includedPlayerSizeTargeting

object ( VideoPlayerSizeTargeting )

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

ویدئومایم‌تایپ

انواع میم ویدیویی برای هدف قرار دادن.

انوم‌ها
VIDEO_MIME_TYPE_UNSPECIFIED مقدار پیش‌فرض. نباید در مشخصات هدف‌گیری استفاده شود.
VIDEO_MIME_TYPE_THREEGPP قالب کانتینر 3GPP که در تلفن‌های 3G استفاده می‌شود.
VIDEO_MIME_TYPE_APPLICATION_MPEGURL HLS/M3U8
VIDEO_MIME_TYPE_MP4 کانتینر MPEG-4 معمولاً با کدک H.264.
VIDEO_MIME_TYPE_APPLICATION_MPEGDASH داش.
VIDEO_MIME_TYPE_APPLICATION_JAVASCRIPT جاوا اسکریپت (مورد استفاده برای تبلیغات VPAID).
VIDEO_MIME_TYPE_WEBM کانتینر WebM با فرض کدک VP9.

حداکثر مدت زمان تبلیغات ویدیویی

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

انوم‌ها
MAXIMUM_VIDEO_AD_DURATION_UNSPECIFIED مقدار پیش‌فرض. نباید در مشخصات هدف‌گیری استفاده شود.
MAXIMUM_VIDEO_AD_DURATION_FIFTEEN_SECONDS برای تبلیغات ویدیویی با مدت زمان حداکثر ۱۵ ثانیه (۰ < مدت زمان <= ۱۵ ثانیه) اعمال می‌شود.
MAXIMUM_VIDEO_AD_DURATION_TWENTY_SECONDS برای تبلیغات ویدیویی با مدت زمان حداکثر ۲۰ ثانیه (۰ < مدت زمان <= ۲۰ ثانیه) اعمال می‌شود.
MAXIMUM_VIDEO_AD_DURATION_THIRTY_SECONDS برای تبلیغات ویدیویی با مدت زمان حداکثر ۳۰ ثانیه (۰ < مدت زمان <= ۳۰ ثانیه) اعمال می‌شود.
MAXIMUM_VIDEO_AD_DURATION_SIXTY_SECONDS برای تبلیغات ویدیویی با مدت زمان حداکثر ۶۰ ثانیه (۰ < مدت زمان <= ۶۰ ثانیه) اعمال می‌شود.
MAXIMUM_VIDEO_AD_DURATION_NINETY_SECONDS برای تبلیغات ویدیویی با مدت زمان حداکثر ۹۰ ثانیه (۰ < مدت زمان <= ۹۰ ثانیه) اعمال می‌شود.
MAXIMUM_VIDEO_AD_DURATION_ONE_HUNDRED_TWENTY_SECONDS برای تبلیغات ویدیویی با مدت زمان حداکثر ۱۲۰ ثانیه (۰ < مدت زمان <= ۱۲۰ ثانیه) اعمال می‌شود.

نوع موقعیت

موقعیت قابل هدف‌گیری تبلیغ در یک ویدیو.

انوم‌ها
POSITION_TYPE_UNSPECIFIED مقدار پیش‌فرض. نباید در مشخصات هدف‌گیری استفاده شود.
POSITION_TYPE_MIDROLL این تبلیغ در وسط محتوای ویدیویی پخش می‌شود.
POSITION_TYPE_POSTROLL این تبلیغ بعد از محتوای ویدیویی پخش می‌شود.
POSITION_TYPE_PREROLL تبلیغ قبل از محتوای ویدیویی پخش می‌شود.

روش تحویل محتوا

معیارهای هدف‌گذاری بر اساس روش ارائه محتوای ویدیویی.

انوم‌ها
CONTENT_DELIVERY_METHOD_UNSPECIFIED مقدار پیش‌فرض. نباید در مشخصات هدف‌گیری استفاده شود.
CONTENT_DELIVERY_METHOD_STREAMING محتوای ویدیویی را که به صورت زنده پخش می‌شود، هدف قرار می‌دهد.
CONTENT_DELIVERY_METHOD_PROGRESSIVE محتوای ویدیویی را هدف قرار می‌دهد که به تدریج و با توجه به نیاز پخش کلاینت منتقل می‌شود.

هدف‌گیری ویدیویی

معیارهای هدف‌گذاری را بر اساس نوع قرارگیری ویدیو تعریف می‌کند، که اغلب مربوط به فیلد 'plcmt' در IAB OpenRTB است.

نمایش JSON 
{
  "selectionType": enum (SelectionType),
  "videoPlcmtTypes": [
    enum (VideoPlcmtType)
  ]
}
فیلدها
selectionType

enum ( SelectionType )

الزامی. نوع انتخاب برای لیست PLC های ویدیویی.

videoPlcmtTypes[]

enum ( VideoPlcmtType )

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

نوع انتخاب

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

انوم‌ها
SELECTION_TYPE_UNSPECIFIED نوع انتخاب نامشخص. نباید استفاده شود.
SELECTION_TYPE_INCLUDE مقادیر موجود در بُعد هدف‌گذاری لحاظ شده‌اند.
SELECTION_TYPE_EXCLUDE مقادیر موجود در بُعد هدف‌گذاری مستثنی هستند.

نوع ویدیو PLC

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

انوم‌ها
VIDEO_PLCMT_TYPE_UNSPECIFIED مقدار پیش‌فرض. نباید در مشخصات هدف‌گیری استفاده شود.
INSTREAM تبلیغات پیش از پخش، میان‌پخش و پس از پخش که قبل، حین یا بعد از محتوای ویدیویی استریمینگ مورد درخواست مصرف‌کننده پخش می‌شوند. ویدیوی استریم باید به طور پیش‌فرض در شروع پخش روی «صدا روشن» تنظیم شود، یا قصد کاربر از تماشای محتوای ویدیو به طور واضح مشخص باشد. در حالی که ممکن است محتوای دیگری در اطراف پخش‌کننده وجود داشته باشد، محتوای ویدیو باید محور بازدید کاربر باشد. این باید محتوای اصلی صفحه و تنها پخش‌کننده ویدیویی در نمای قابل پخش صدا هنگام پخش باقی بماند. اگر پخش‌کننده به حالت شناور/چسبنده تغییر کند، فراخوانی‌های تبلیغاتی بعدی باید به طور دقیق اندازه پخش‌کننده به‌روز شده را منتقل کنند.
ACCOMPANYING_CONTENT تبلیغات پیش از پخش، میان‌پخش و پس از پخش که قبل، حین یا بعد از پخش محتوای ویدیویی پخش می‌شوند. پخش‌کننده ویدیو قبل، بین یا بعد از پاراگراف‌های متن یا محتوای گرافیکی بارگیری و پخش می‌شود و فقط زمانی شروع به پخش می‌کند که وارد صفحه نمایش شود. محتوای همراه فقط باید هنگام ورود به صفحه نمایش شروع به پخش کند. ممکن است با اسکرول کردن از صفحه به یک پخش‌کننده شناور/چسبنده تبدیل شود.
INTERSTITIAL تبلیغات ویدیویی که بدون محتوای ویدیویی پخش می‌شوند. در طول پخش، باید تمرکز اصلی صفحه باشد و بیشتر صفحه نمایش را اشغال کند و نمی‌توان آن را با اسکرول از دید خارج کرد. این می‌تواند در مکان‌هایی مانند ویدیوی درون برنامه‌ای یا نمایش اسلاید باشد.
NO_CONTENT تبلیغات ویدیویی که بدون محتوای ویدیویی پخش می‌شوند. این تبلیغات می‌توانند در مکان‌هایی مانند اسلایدشوها، فیدهای بومی، درون محتوا یا چسبنده/شناور باشند.

روش پخش

روش پخش برای هدف قرار دادن.

انوم‌ها
PLAYBACK_METHOD_UNSPECIFIED روش پخش ویدئو نامشخص است. نباید استفاده شود.
PLAYBACK_METHOD_AUTO_PLAY_SOUND_ON پخش به طور خودکار با بارگیری صفحه/محتوا شروع می‌شود.
PLAYBACK_METHOD_AUTO_PLAY_SOUND_OFF پخش به طور خودکار هنگام بارگیری صفحه/محتوا شروع می‌شود، اما صدا قطع است.
PLAYBACK_METHOD_CLICK_TO_PLAY پخش توسط یک اقدام کاربر (مثلاً کلیک روی دکمه پخش) آغاز می‌شود.

هدف‌گیری اندازه پخش‌کننده ویدیو

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

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

string ( int64 format)

الزامی. حداقل عرض پخش‌کننده‌ی ویدیو بر حسب پیکسل.

minimumHeight

string ( int64 format)

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

بُعد هدف‌گیری رشته‌ای

هدف‌گیری عمومی با مقادیر رشته‌ای.

نمایش JSON 
{
  "selectionType": enum (SelectionType),
  "values": [
    string
  ]
}
فیلدها
selectionType

enum ( SelectionType )

الزامی. نحوه‌ی هدف‌گیری موارد موجود در این لیست.

values[]

string

مقادیر مشخص شده. الزامی.

اندازه تبلیغات

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

نمایش JSON 
{
  "width": string,
  "height": string,
  "type": enum (Type)
}
فیلدها
width

string ( int64 format)

عرض جایگاه تبلیغ بر حسب پیکسل. این فیلد فقط زمانی نمایش داده می‌شود که نوع اندازه PIXEL باشد.

height

string ( int64 format)

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

type

enum ( Type )

نوع اندازه جایگاه تبلیغ.

نوع

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

انوم‌ها
TYPE_UNSPECIFIED یک نگهدارنده برای نوع با اندازه نامشخص.
PIXEL جایگاه تبلیغ با اندازه مشخص شده با ارتفاع و عرض بر حسب پیکسل.
INTERSTITIAL اندازه ویژه برای توصیف یک جایگاه تبلیغات بینابینی.
NATIVE تبلیغات بومی (موبایل) که توسط ناشر ارائه می‌شود.
FLUID اندازه سیال (اندازه واکنش‌گرا) می‌تواند به طور خودکار با تغییر محیط بیرونی تغییر اندازه دهد.

معیارهاهدف‌گذاری

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

نمایش JSON 
{
  "targetedCriteriaIds": [
    string
  ],
  "excludedCriteriaIds": [
    string
  ]
}
فیلدها
targetedCriteriaIds[]

string ( int64 format)

فهرستی از شناسه‌های عددی که باید گنجانده شوند.

excludedCriteriaIds[]

string ( int64 format)

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

هدف‌گیری بسته‌بندی

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

نمایش JSON 
{
  "uriTargeting": {
    object (StringTargetingDimension)
  },
  "mobileAppTargeting": {
    object (StringTargetingDimension)
  },
  "includedMobileAppCategoryTargeting": [
    string
  ]
}
فیلدها
uriTargeting

object ( StringTargetingDimension )

اختیاری. فهرست آدرس‌های اینترنتی هدفمند یا حذف‌شده. دامنه‌ها باید http/https نداشته باشند (برای مثال، google.com) و می‌توانند حداکثر ۵ مسیر در هر آدرس اینترنتی داشته باشند.

mobileAppTargeting

object ( StringTargetingDimension )

اختیاری. فهرست شناسه‌های برنامه‌های تلفن همراه هدفمند یا مستثنی‌شده که ناشران در اختیار دارند. در حال حاضر، فقط برنامه‌های اندروید و اپل پشتیبانی می‌شوند.

شناسه برنامه اندروید، برای مثال، com.google.android.apps.maps، را می‌توان در آدرس اینترنتی فروشگاه گوگل پلی یافت. شناسه برنامه iOS (که یک عدد است) را می‌توان در انتهای آدرس اینترنتی فروشگاه آیتونز یافت. برنامه‌های تلفن همراه شخص ثالث یا شامل می‌شوند یا نمی‌شوند.

includedMobileAppCategoryTargeting[]

string ( int64 format)

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

هدف‌گیری سیگنال‌های ارائه‌شده توسط ناشر بسته

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

نمایش JSON 
{
  "audienceTargeting": {
    object (TaxonomyTargeting)
  },
  "contentTargeting": {
    object (TaxonomyTargeting)
  },
  "videoAndAudioSignalsTargeting": {
    object (StringTargetingDimension)
  }
}
فیلدها
audienceTargeting

object ( TaxonomyTargeting )

اختیاری. فهرست شناسه‌های مخاطبان هدف یا حذف‌شده. بر اساس طبقه‌بندی مخاطبان IAB نسخه ۱.۱ ( https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Audience%20Taxonomies/Audience%20Taxonomy%201.1.tsv )

contentTargeting

object ( TaxonomyTargeting )

اختیاری. فهرست شناسه‌های محتوای هدفمند یا حذف‌شده. بر اساس طبقه‌بندی محتوای IAB نسخه ۲.۲ ( https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%202.2.tsv )

videoAndAudioSignalsTargeting

object ( StringTargetingDimension )

اختیاری. فهرست شناسه‌های سیگنال‌های ویدیویی و صوتی هدفمند و حذف‌شده. اینها سیگنال‌های اضافی هستند که توسط سیگنال‌های ارائه‌شده توسط ناشر پشتیبانی می‌شوند.

طبقه‌بندیهدف‌گیری

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

نمایش JSON 
{
  "targetedTaxonomyIds": [
    string
  ],
  "excludedTaxonomyIds": [
    string
  ]
}
فیلدها
targetedTaxonomyIds[]

string

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

excludedTaxonomyIds[]

string

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

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

قابل مشاهده بودن هزینه ترکیبی بسته گزینش و هزینه‌های بخش داده (کل هزینه گزینش). هزینه‌ها همیشه برای سازنده بسته قابل مشاهده هستند.

انوم‌ها
CURATION_FEE_VISIBILITY_UNSPECIFIED کل هزینه‌ی قابل مشاهده برای گزینش مشخص نیست.
DISCLOSED کل هزینه گزینش برای همه خریداران قابل مشاهده است. اگر این مقدار تنظیم نشده باشد، مقدار پیش‌فرض است.
NON_DISCLOSED کل هزینه گزینش برای همه خریداران قابل مشاهده نیست.

روش‌ها

activate

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

create

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

deactivate

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

get

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

list

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

patch

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