REST Resource: advertisers.creatives

منبع: طرح‌آگهی

یک «طرح‌آگهی».

نمایش JSON 
{
  "name": string,
  "advertiserId": string,
  "creativeId": string,
  "cmPlacementId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "createTime": string,
  "creativeType": enum (CreativeType),
  "hostingSource": enum (HostingSource),
  "dynamic": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "additionalDimensions": [
    {
      object (Dimensions)
    }
  ],
  "mediaDuration": string,
  "creativeAttributes": [
    enum (CreativeAttribute)
  ],
  "reviewStatus": {
    object (ReviewStatusInfo)
  },
  "assets": [
    {
      object (AssetAssociation)
    }
  ],
  "exitEvents": [
    {
      object (ExitEvent)
    }
  ],
  "timerEvents": [
    {
      object (TimerEvent)
    }
  ],
  "counterEvents": [
    {
      object (CounterEvent)
    }
  ],
  "appendedTag": string,
  "integrationCode": string,
  "notes": string,
  "iasCampaignMonitoring": boolean,
  "companionCreativeIds": [
    string
  ],
  "skippable": boolean,
  "skipOffset": {
    object (AudioVideoOffset)
  },
  "progressOffset": {
    object (AudioVideoOffset)
  },
  "universalAdId": {
    object (UniversalAdId)
  },
  "thirdPartyUrls": [
    {
      object (ThirdPartyUrl)
    }
  ],
  "transcodes": [
    {
      object (Transcode)
    }
  ],
  "trackerUrls": [
    string
  ],
  "jsTrackerUrl": string,
  "cmTrackingAd": {
    object (CmTrackingAd)
  },
  "obaIcon": {
    object (ObaIcon)
  },
  "thirdPartyTag": string,
  "requireMraid": boolean,
  "requireHtml5": boolean,
  "requirePingForAttribution": boolean,
  "expandingDirection": enum (ExpandingDirection),
  "expandOnHover": boolean,
  "vastTagUrl": string,
  "vpaid": boolean,
  "html5Video": boolean,
  "lineItemIds": [
    string
  ],
  "mp3Audio": boolean,
  "oggAudio": boolean,
  "syntheticContentAttestationStatus": enum (SyntheticContentAttestationStatus)
}
فیلدها
name

string

فقط خروجی. نام منبع متن آگهی.
advertiserId

string (int64 format)

فقط خروجی. شناسه یکتای آگهی‌دهنده‌ای که طرح آگهی به آن تعلق دارد.
creativeId

string (int64 format)

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

string (int64 format)

فقط خروجی. شناسه یکتای جای آگهی Campaign Manager 360 مرتبط با طرح‌آگهی. این فیلد فقط برای طرح‌آگهی‌هایی قابل اعمال است که از Campaign Manager همگام‌سازی شده‌اند.
displayName

string

الزامی. نام نمایشی طرح آگهی.

باید با UTF-8 کدبندی شده باشد و حداکثر اندازه آن ۲۴۰ بایت باشد.
entityStatus

enum (EntityStatus)

الزامی. کنترل می‌کند که طرح آگهی می‌تواند ارائه شود یا نه.

مقادیر پذیرفتنی عبارت‌اند از:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
  • ENTITY_STATUS_PAUSED
updateTime

string (Timestamp format)

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

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

string (Timestamp format)

فقط خروجی. مُهر زمان ایجاد طرح آگهی. توسط سیستم اختصاص داده شده است.

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

enum (CreativeType)

الزامی. تغییرناپذیر. نوع طرح‌آگهی.
hostingSource

enum (HostingSource)

الزامی. نشان می‌دهد که طرح آگهی کجا میزبانی می‌شود.
dynamic

boolean

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

object (Dimensions)

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

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
additionalDimensions[]

object (Dimensions)

اختیاری. ابعاد بیشتر. قابل‌اعمال وقتی creativeType یکی از موارد زیر باشد:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_LIGHTBOX
  • CREATIVE_TYPE_PUBLISHER_HOSTED

اگر این فیلد مشخص شده باشد، widthPixels و heightPixels هر دو الزامی هستند و باید بزرگ‌تر یا مساوی ۰ باشند.
mediaDuration

string (Duration format)

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

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_PUBLISHER_HOSTED

مدت‌زمان به ثانیه با حداکثر نه رقم اعشار، که به «s» ختم می‌شود. مثال: "3.5s".
creativeAttributes[]

enum (CreativeAttribute)

فقط خروجی. فهرستی از مشخصه‌های طرح آگهی که توسط سیستم تولید شده است.
reviewStatus

object (ReviewStatusInfo)

فقط خروجی. وضعیت فعلی فرایند بازبینی طرح‌آگهی.
assets[]

object (AssetAssociation)

الزامی. دارایی‌های مرتبط با این طرح‌آگهی.
exitEvents[]

object (ExitEvent)

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

  • از ناحیه ضربه Google Web Designer استفاده کنید.
  • متغیر جاوا اسکریپتی به‌نام «clickTag» تعریف کنید.
  • از Enabler (Enabler.exit()) برای ردیابی خروج‌ها در قالب‌های رسانه تعاملی استفاده کنید.
timerEvents[]

object (TimerEvent)

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

object (CounterEvent)

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

string

اختیاری. تگ ردیابی HTML طرف سوم که باید به تگ طرح آگهی اضافه شود.
integrationCode

string

اختیاری. اطلاعات شناسه استفاده‌شده برای پیوند دادن این طرح آگهی به سیستم خارجی. باید با UTF-8 کدبندی شده باشد و طول آن بیشتر از ۱۰٬۰۰۰ نویسه نباشد.
notes

string

اختیاری. یادداشت‌های کاربر برای این طرح آگهی. باید با UTF-8 کدبندی شده باشد و طول آن بیشتر از ۲۰٬۰۰۰ نویسه نباشد.
iasCampaignMonitoring

boolean

اختیاری. نشان می‌دهد که آیا پایش پویش Integral Ad Science (IAS) فعال است یا نه. برای فعال کردن این مورد برای طرح آگهی، مطمئن شوید که Advertiser.creative_config.ias_client_id روی شناسه مشتری IAS شما تنظیم شده باشد.
companionCreativeIds[]

string (int64 format)

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

می‌توانید طرح‌های آگهی نمایشی موجود (با دارایی‌های تصویری یا HTML5) را برای ارائه در اطراف پخش‌کننده ویدیو ناشر اختصاص دهید. آگهی‌های همراه درحین پخش ویدیو در اطراف پخش‌کننده ویدیو نمایش داده می‌شوند و پس‌از تکمیل ویدیو باقی می‌مانند.

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

این فیلد فقط برای creativeType زیر پشتیبانی می‌شود:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
skippable

boolean

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

این فیلد فقط برای creativeType زیر پشتیبانی می‌شود:

  • CREATIVE_TYPE_VIDEO
skipOffset

object (AudioVideoOffset)

اختیاری. مدت زمانی که ویدیو باید پخش شود تا دکمه رد کردن ظاهر شود.

وقتی skippable درست باشد، این فیلد الزامی است.

این فیلد فقط برای creativeType زیر پشتیبانی می‌شود:

  • CREATIVE_TYPE_VIDEO
progressOffset

object (AudioVideoOffset)

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

وقتی skippable درست باشد، این فیلد الزامی است.

این فیلد فقط برای creativeType زیر پشتیبانی می‌شود:

  • CREATIVE_TYPE_VIDEO
universalAdId

object (UniversalAdId)

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

«شناسه آگهی جهانی» بخشی از استاندارد VAST 4.0 است. پس‌از ایجاد طرح آگهی می‌توان آن را اصلاح کرد.

این فیلد فقط برای creativeType زیر پشتیبانی می‌شود:

  • CREATIVE_TYPE_VIDEO
thirdPartyUrls[]

object (ThirdPartyUrl)

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

این فیلد فقط برای creativeType زیر پشتیبانی می‌شود:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
transcodes[]

object (Transcode)

فقط خروجی. تراتبدیل‌های صوتی/ویدیویی.

‫Display & Video 360 دارایی اصلی را به تعدادی نسخه جایگزین تراتبدیل می‌کند که از قالب‌های فایل مختلف استفاده می‌کنند یا ویژگی‌های متفاوتی دارند (وضوح، نرخ بیت صوتی، و نرخ بیت ویدیویی)، که هرکدام برای پخش‌کننده‌های ویدیو یا پهنای باندهای خاصی طراحی شده‌اند.

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

این فیلد فقط در creativeType زیر پشتیبانی می‌شود:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_AUDIO
trackerUrls[]

string

اختیاری. نشانی‌های وب ردیابی برای ارائه‌دهندگان تجزیه‌وتحلیل یا فروشندگان فناوری تبلیغات طرف سوم.

نشانی‌های وب باید با https: شروع شوند (به‌جز در فضای آگهی که نیازی به مطابقت با SSL ندارد). اگر از ماکروها در نشانی وب خود استفاده می‌کنید، فقط از ماکروهای پشتیبانی‌شده توسط Display & Video 360 استفاده کنید.

فقط نشانی‌های وب استاندارد، بدون برچسب‌های IMG یا SCRIPT.

این فیلد فقط در creativeType زیر قابل‌نوشتن است:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
jsTrackerUrl

string

اختیاری. نشانی وب سنجش جاوا اسکریپت از ارائه‌دهندگان درستی‌سنجی شخص ثالث پشتیبانی‌شده (ComScore،‏ DoubleVerify،‏ IAS،‏ Moat). برچسب‌های دستورگان HTML پشتیبانی نمی‌شوند.

این فیلد فقط در creativeType زیر قابل‌نوشتن است:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
cmTrackingAd

object (CmTrackingAd)

اختیاری. آگهی ردگیری «مدیر پویش ۳۶۰» مرتبط با طرح آگهی.

اختیاری برای creativeType زیر وقتی توسط آگهی‌دهنده‌ای ایجاد شده باشد که هم از «مدیر پویش ۳۶۰» و هم از نمایش آگهی طرف سوم استفاده می‌کند:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE

فقط برای موارد دیگر برونداد می‌شود.
obaIcon

object (ObaIcon)

اختیاری. نماد OBA را برای طرح‌آگهی ویدیویی مشخص می‌کند.

این فیلد فقط در creativeType زیر پشتیبانی می‌شود:

  • CREATIVE_TYPE_VIDEO
thirdPartyTag

string

اختیاری. برچسب طرف سوم اصلی که برای طرح آگهی استفاده شده است.

الزامی است و فقط برای طرح‌آگهی‌های برچسب شخص ثالث معتبر است.

طرح‌آگهی‌های برچسب طرف سوم طرح‌آگهی‌هایی با hostingSource زیر هستند:

  • HOSTING_SOURCE_THIRD_PARTY

ترکیب‌شده با creativeType زیر:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireMraid

boolean

اختیاری. نشان می‌دهد که طرح آگهی به MRAID (سیستم تعاریف میانای آگهی رسانه تعاملی تلفن همراه) نیاز دارد.

اگر طرح آگهی برای تعامل به اشاره‌های تلفن همراه، مانند تند کشیدن یا ضربه زدن، متکی است، این گزینه را تنظیم کنید.

اختیاری و فقط برای طرح‌آگهی‌های برچسب طرف سوم معتبر است.

طرح‌آگهی‌های برچسب طرف سوم طرح‌آگهی‌هایی با hostingSource زیر هستند:

  • HOSTING_SOURCE_THIRD_PARTY

ترکیب‌شده با creativeType زیر:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireHtml5

boolean

اختیاری. نشان می‌دهد که طرح آگهی برای ارائه صحیح به HTML5 متکی است.

اختیاری و فقط برای طرح‌آگهی‌های برچسب طرف سوم معتبر است. طرح‌آگهی‌های برچسب طرف سوم طرح‌آگهی‌هایی با hostingSource زیر هستند:

  • HOSTING_SOURCE_THIRD_PARTY

ترکیب‌شده با creativeType زیر:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requirePingForAttribution

boolean

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

فقط زمانی معتبر است که از آگهی ردگیری Campaign Manager 360 با پارامتر سرور آگهی طرف سوم و ماکرو ${DC_DBM_TOKEN} استفاده شود.

اختیاری است و فقط برای طرح‌آگهی‌های برچسب طرف سوم یا طرح‌آگهی‌های برچسب VAST طرف سوم معتبر است.

طرح‌آگهی‌های برچسب طرف سوم طرح‌آگهی‌هایی با hostingSource زیر هستند:

  • HOSTING_SOURCE_THIRD_PARTY

ترکیب‌شده با creativeType زیر:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE

طرح‌آگهی‌های برچسب VAST طرف سوم طرح‌آگهی‌هایی با hostingSource زیر هستند:

  • HOSTING_SOURCE_THIRD_PARTY

ترکیب‌شده با creativeType زیر:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
expandingDirection

enum (ExpandingDirection)

اختیاری. جهت گسترش طرح آگهی را مشخص می‌کند.

الزامی است و فقط برای طرح‌آگهی‌های گسترش‌پذیر شخص ثالث معتبر است.

طرح‌آگهی‌های گسترش‌پذیر طرف سوم طرح‌آگهی‌هایی با منبع میزبانی زیر هستند:

  • HOSTING_SOURCE_THIRD_PARTY

ترکیب‌شده با creativeType زیر:

  • CREATIVE_TYPE_EXPANDABLE
expandOnHover

boolean

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

اختیاری و فقط برای طرح‌آگهی‌های گسترش‌پذیر طرف سوم معتبر است. طرح‌آگهی‌های گسترش‌پذیر طرف سوم طرح‌آگهی‌هایی با منبع میزبانی زیر هستند:

  • HOSTING_SOURCE_THIRD_PARTY

ترکیب‌شده با creativeType زیر:

  • CREATIVE_TYPE_EXPANDABLE
vastTagUrl

string

اختیاری. نشانی وب برچسب VAST برای طرح‌آگهی برچسب VAST شخص ثالث.

الزامی است و فقط برای طرح‌های آگهی برچسب VAST شخص ثالث معتبر است.

طرح‌آگهی‌های برچسب VAST طرف سوم طرح‌آگهی‌هایی با hostingSource زیر هستند:

  • HOSTING_SOURCE_THIRD_PARTY

ترکیب‌شده با creativeType زیر:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
vpaid

boolean

فقط خروجی. نشان می‌دهد که طرح‌آگهی برچسب VAST طرف سوم به VPAID (رابط آگهی پخش‌کننده ویدیو دیجیتال) نیاز دارد.

فقط برونداد و فقط برای طرح‌آگهی‌های برچسب VAST طرف سوم معتبر است.

طرح‌آگهی‌های برچسب VAST طرف سوم طرح‌آگهی‌هایی با hostingSource زیر هستند:

  • HOSTING_SOURCE_THIRD_PARTY

ترکیب‌شده با creativeType زیر:

  • CREATIVE_TYPE_VIDEO
html5Video

boolean

فقط خروجی. نشان می‌دهد که طرح آگهی برچسب VAST طرف سوم به پشتیبانی از ویدیو HTML5 نیاز دارد.

فقط برونداد و فقط برای طرح‌آگهی‌های برچسب VAST طرف سوم معتبر است.

طرح‌آگهی‌های برچسب VAST طرف سوم طرح‌آگهی‌هایی با hostingSource زیر هستند:

  • HOSTING_SOURCE_THIRD_PARTY

ترکیب‌شده با creativeType زیر:

  • CREATIVE_TYPE_VIDEO
lineItemIds[]

string (int64 format)

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

برای مرتبط کردن طرح آگهی با مورد خطی، از LineItem.creative_ids استفاده کنید.
mp3Audio

boolean

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

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

طرح‌آگهی‌های صوتی طرف سوم طرح‌آگهی‌هایی با hostingSource زیر هستند:

  • HOSTING_SOURCE_THIRD_PARTY

ترکیب‌شده با creativeType زیر:

  • CREATIVE_TYPE_AUDIO
oggAudio

boolean

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

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

طرح‌آگهی‌های صوتی طرف سوم طرح‌آگهی‌هایی با hostingSource زیر هستند:

  • HOSTING_SOURCE_THIRD_PARTY

ترکیب‌شده با creativeType زیر:

  • CREATIVE_TYPE_AUDIO
syntheticContentAttestationStatus

enum (SyntheticContentAttestationStatus)

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

HostingSource

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

شمارشی‌ها
HOSTING_SOURCE_UNSPECIFIED منبع میزبانی در این نسخه مشخص نشده است یا ناشناخته است.
HOSTING_SOURCE_CM

طرح‌آگهی همگام‌سازی‌شده از Campaign Manager 360.

روش‌های ایجاد و به‌روزرسانی برای این نوع میزبانی پشتیبانی نمی‌شود.
HOSTING_SOURCE_THIRD_PARTY

طرح‌آگهی‌ای که توسط سرور آگهی‌های طرف سوم (3PAS) میزبانی می‌شود.

اگر creativeType یکی از موارد زیر باشد، روش‌های ایجاد و به‌روزرسانی برای این نوع میزبانی پشتیبانی می‌شود:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_HOSTED

طرح‌آگهی‌ای که در DV360 ایجاد شده و Campaign Manager 360 میزبان آن است.

اگر creativeType یکی از موارد زیر باشد، روش‌های ایجاد و به‌روزرسانی برای این نوع میزبانی پشتیبانی می‌شود:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_RICH_MEDIA

یک طرح آگهی رسانه تعاملی که در «استودیو» ایجاد شده و توسط Campaign Manager 360 میزبانی می‌شود.

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

CreativeAttribute

مشخصه‌های احتمالی طرح‌آگهی.

شمارشی‌ها
CREATIVE_ATTRIBUTE_UNSPECIFIED مشخصه آگهی در این نسخه مشخص نشده است یا ناشناخته است.
CREATIVE_ATTRIBUTE_VAST طرح‌آگهی از نوع VAST است.
CREATIVE_ATTRIBUTE_VPAID_LINEAR طرح‌آگهی از نوع طرح‌آگهی VPAID خطی است.
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR طرح‌آگهی از نوع طرح‌آگهی VPAID غیرخطی است.

ReviewStatusInfo

وضعیت‌های بازبینی برای طرح‌آگهی.

نمایش JSON 
{
  "approvalStatus": enum (ApprovalStatus),
  "creativeAndLandingPageReviewStatus": enum (ReviewStatus),
  "contentAndPolicyReviewStatus": enum (ReviewStatus),
  "exchangeReviewStatuses": [
    {
      object (ExchangeReviewStatus)
    }
  ]
}
فیلدها
approvalStatus

enum (ApprovalStatus)

نشان‌دهنده تأییدیه اصلی موردنیاز برای شروع ارائه طرح آگهی است. خلاصه creativeAndLandingPageReviewStatus و contentAndPolicyReviewStatus.
creativeAndLandingPageReviewStatus

enum (ReviewStatus)

وضعیت بازبینی طرح‌آگهی و صفحه مقصد برای طرح‌آگهی.
contentAndPolicyReviewStatus

enum (ReviewStatus)

وضعیت بازبینی محتوا و خط‌مشی برای طرح‌آگهی.
exchangeReviewStatuses[]

object (ExchangeReviewStatus)

وضعیت‌های بازبینی Exchange برای طرح‌آگهی.

ApprovalStatus

انواع ممکن وضعیت تأیید. این خلاصه creativeAndLandingPageReviewStatus و contentAndPolicyReviewStatus است.

شمارشی‌ها
APPROVAL_STATUS_UNSPECIFIED مقدار نوع مشخص نشده است یا در این نسخه ناشناخته است.
APPROVAL_STATUS_PENDING_NOT_SERVABLE طرح‌آگهی هنوز دردست بازبینی است و قابل‌ارائه نیست.
APPROVAL_STATUS_PENDING_SERVABLE طرح‌آگهی بازبینی طرح‌آگهی و صفحه مقصد را گذرانده است و قابل‌ارائه است، اما درانتظار بازبینی محتوا و خط‌مشی اضافی است.
APPROVAL_STATUS_APPROVED_SERVABLE هم بازبینی طرح آگهی و صفحه مقصد و هم بازبینی محتوا و خط‌مشی تأیید شده است. این طرح آگهی قابل‌ارائه است.
APPROVAL_STATUS_REJECTED_NOT_SERVABLE مشکلی در طرح‌آگهی وجود دارد که باید قبل‌از ارائه برطرف شود.

ReviewStatus

انواع ممکن وضعیت بازبینی.

شمارشی‌ها
REVIEW_STATUS_UNSPECIFIED مقدار نوع مشخص نشده است یا در این نسخه ناشناخته است.
REVIEW_STATUS_APPROVED طرح‌آگهی تأیید شده است.
REVIEW_STATUS_REJECTED طرح آگهی رد شده است.
REVIEW_STATUS_PENDING طرح‌آگهی درانتظار بازبینی است.

ExchangeReviewStatus

وضعیت بازبینی Exchange برای طرح‌آگهی.

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

enum (Exchange)

صرافی درحال بازبینی طرح‌آگهی است.
status

enum (ReviewStatus)

وضعیت بازبینی تعویض.

AssetAssociation

ارتباط دارایی برای طرح‌آگهی.

نمایش JSON 
{
  "asset": {
    object (Asset)
  },
  "role": enum (AssetRole)
}
فیلدها
asset

object (Asset)

اختیاری. دارایی مربوطه.
role

enum (AssetRole)

اختیاری. نقش این دارایی برای طرح‌آگهی.

دارایی

یک دارایی.

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

string (int64 format)

شناسه رسانه دارایی بارگذاری‌شده. این شناسه یکتای دارایی است. این شناسه را می‌توان به سایر فراخوانی‌های میانای برنامه‌سازی کاربردی، مثلاً creatives.create، منتقل کرد تا دارایی با طرح آگهی مرتبط شود.

فضای «شناسه رسانه» در ۵ آوریل ۲۰۲۳ به‌روز شد. شناسه‌های رسانه ذخیره‌شده در حافظه نهان قبل‌از ۵ آوریل ۲۰۲۳ را با بازیابی شناسه رسانه جدید از منابع طرح آگهی مرتبط یا بارگذاری مجدد دارایی به‌روز کنید.
content

string

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

AssetRole

نقش این دارایی برای طرح‌آگهی.

شمارشی‌ها
ASSET_ROLE_UNSPECIFIED نقش دارایی در این نسخه مشخص نشده است یا ناشناخته است.
ASSET_ROLE_MAIN دارایی، دارایی اصلی طرح‌آگهی است.
ASSET_ROLE_BACKUP دارایی، دارایی پشتیبان طرح‌آگهی است.
ASSET_ROLE_POLITE_LOAD دارایی یک دارایی بارگذاری مؤدبانه از طرح‌آگهی است.
ASSET_ROLE_HEADLINE

عنوان آگهی بومی.

‫content باید با UTF-8 کدبندی شده باشد و طول آن بیشتر از ۲۵ نویسه نباشد.

این نقش فقط در creativeType زیر پشتیبانی می‌شود:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_HEADLINE

عنوان بلند طرح آگهی بومی.

content باید با UTF-8 کدبندی شده باشد و طول آن بیشتر از ۵۰ نویسه نباشد.

این نقش فقط در creativeType زیر پشتیبانی می‌شود:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_BODY

نوشتار اصلی آگهی بومی.

content باید با UTF-8 کدبندی شده باشد و طول آن بیشتر از ۹۰ نویسه نباشد.

این نقش فقط در creativeType زیر پشتیبانی می‌شود:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_BODY

نوشتار اصلی طولانی برای آگهی بومی.

‫content باید با UTF-8 کدبندی شده باشد و طول آن بیشتر از ۱۵۰ نویسه نباشد.

این نقش فقط در creativeType زیر پشتیبانی می‌شود:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CAPTION_URL

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

content باید با UTF-8 کدبندی شده باشد و طول آن بیشتر از ۳۰ نویسه نباشد.

برای مثال، اگر نشانی وب صفحه مقصد «http://www.example.com/page» باشد، نشانی وب زیرنویس می‌تواند «example.com» باشد. پروتکل (http://‎) اختیاری است، اما نشانی وب نمی‌تواند حاوی فاصله یا نویسه‌های خاص باشد.

این نقش فقط در creativeType زیر پشتیبانی می‌شود:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CALL_TO_ACTION

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

content باید با UTF-8 کدبندی شده باشد و طول آن بیشتر از ۱۵ نویسه نباشد.

این نقش فقط در creativeType زیر پشتیبانی می‌شود:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_ADVERTISER_NAME

نوشتاری که تبلیغ‌کننده یا نام نمانام را مشخص می‌کند.

‫content باید با UTF-8 کدبندی شده باشد و طول آن بیشتر از ۲۵ نویسه نباشد.

این نقش فقط در creativeType زیر پشتیبانی می‌شود:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_PRICE

قیمت خرید برنامه‌تان در فروشگاه Google Play یا فروشگاه برنامه iOS (برای مثال، ۵٫۹۹ دلار).

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

content باید با UTF-8 کدبندی شده باشد و طول آن بیشتر از ۱۵ نویسه نباشد.

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

شناسه برنامه Android در فروشگاه Google Play.

می‌توانید این شناسه را در نشانی وب «فروشگاه Google Play» برنامه بعداز «id» پیدا کنید. برای مثال، در https://play.google.com/store/apps/details?id=com.company.appname شناسه com.company.appname است.

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

شناسه برنامه iOS در فروشگاه برنامه Apple.

این شماره شناسه را می‌توانید در نشانی وب Apple App Store به‌عنوان رشته‌ای از اعداد مستقیماً بعداز «id» پیدا کنید. برای مثال، در https://apps.apple.com/us/app/gmail-email-by-google/id422689480 شناسه 422689480 است.

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

رده‌بندی برنامه در فروشگاه Google Play یا فروشگاه برنامه iOS.

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

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

نماد طرح‌آگهی.

این نقش فقط در creativeType زیر پشتیبانی می‌شود و الزامی است:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
ASSET_ROLE_COVER_IMAGE

تصویر جلد طرح‌آگهی ویدیویی بومی.

این نقش فقط در creativeType زیر پشتیبانی می‌شود و الزامی است:

  • CREATIVE_TYPE_VIDEO
ASSET_ROLE_BACKGROUND_COLOR

رنگ اصلی برای استفاده در طرح آگهی.

این نقش فقط در creativeType زیر پشتیبانی می‌شود و الزامی است:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ACCENT_COLOR

رنگ ثانویه برای استفاده در متن آگهی.

این نقش فقط در creativeType زیر پشتیبانی می‌شود و الزامی است:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_REQUIRE_IMAGE

اینکه آیا طرح آگهی باید از دارایی تصویری استفاده کند یا نه.

این نقش فقط در creativeType زیر پشتیبانی می‌شود و الزامی است:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ENABLE_ASSET_ENHANCEMENTS

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

این نقش فقط در creativeType زیر پشتیبانی می‌شود و الزامی است:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE

ExitEvent

رویداد خروج طرح‌آگهی.

نمایش JSON 
{
  "type": enum (ExitEventType),
  "url": string,
  "name": string,
  "reportingName": string
}
فیلدها
type

enum (ExitEventType)

الزامی. نوع رویداد خروج.
url

string

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

  • EXIT_EVENT_TYPE_DEFAULT
  • EXIT_EVENT_TYPE_BACKUP
name

string

اختیاری. نام برچسب کلیک رویداد خروج.

نام باید در یک طرح آگهی منحصربه‌فرد باشد.

برای طرح‌آگهی‌هایی که فقط حاوی دارایی‌های تصویری هستند، آن را خالی بگذارید یا تنظیم نکنید.
reportingName

string

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

ExitEventType

نوع رویداد خروج.

شمارشی‌ها
EXIT_EVENT_TYPE_UNSPECIFIED نوع رویداد خروج در این نسخه مشخص نشده است یا ناشناخته است.
EXIT_EVENT_TYPE_DEFAULT رویداد خروج رویداد پیش‌فرض است.
EXIT_EVENT_TYPE_BACKUP رویداد خروج رویداد خروج پشتیبان است. ممکن است چندین رویداد خروج پشتیبان در یک طرح آگهی وجود داشته باشد.

TimerEvent

رویداد زمان‌سنج طرح آگهی.

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

string

الزامی. نام رویداد زمان‌سنج.
reportingName

string

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

CounterEvent

رویداد شمارنده طرح‌آگهی.

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

string

الزامی. نام رویداد شمارنده.
reportingName

string

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

AudioVideoOffset

مدت زمانی که صدا یا ویدیو پخش شده است.

نمایش JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "percentage": string,
  "seconds": string
  // End of mutually exclusive fields.
}
فیلدها
مقدار جبران. در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
percentage

string (int64 format)

اختیاری. انحراف در درصد مدت‌زمان صدا یا ویدیو.
seconds

string (int64 format)

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

UniversalAdId

شناسه آگهی ارائه‌شده توسط دفتر ثبت که در همه پلاتفرم‌ها یکتا است. این بخشی از استاندارد VAST 4.0 است.

نمایش JSON 
{
  "id": string,
  "registry": enum (UniversalAdRegistry)
}
فیلدها
id

string

اختیاری. شناسه یکتای طرح آگهی.
registry

enum (UniversalAdRegistry)

اختیاری. این دفتر ثبت شناسه‌های خلاقانه یکتایی ارائه می‌دهد.

UniversalAdRegistry

این دفتر ثبت شناسه‌های یکتای طرح‌آگهی را در «شناسه آگهی جهانی» ارائه می‌دهد.

شمارشی‌ها
UNIVERSAL_AD_REGISTRY_UNSPECIFIED دفتر ثبت آگهی جهانی در این نسخه نامشخص یا ناشناخته است.
UNIVERSAL_AD_REGISTRY_OTHER از ارائه‌دهنده سفارشی برای ارائه «شناسه آگهی جهانی» استفاده کنید.
UNIVERSAL_AD_REGISTRY_AD_ID از Ad-ID برای ارائه «شناسه آگهی جهانی» استفاده کنید.
UNIVERSAL_AD_REGISTRY_CLEARCAST از clearcast.co.uk برای ارائه «شناسه آگهی جهانی» استفاده کنید.
UNIVERSAL_AD_REGISTRY_DV360 از Display & Video 360 برای ارائه «شناسه آگهی جهانی» استفاده کنید.
UNIVERSAL_AD_REGISTRY_CM از Campaign Manager 360 برای ارائه «شناسه آگهی جهانی» استفاده کنید.

ThirdPartyUrl

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

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

enum (ThirdPartyUrlType)

اختیاری. نوع تعامل باید توسط نشانی وب پیگیری ردیابی شود
url

string

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

نشانی وبی با مسیر اختیاری یا رشته پُرسمان ارائه کنید که با https: شروع شود. برای مثال، https://www.example.com/path

ThirdPartyUrlType

نوع تعامل باید توسط نشانی وب ردگیری طرف سوم ردگیری شود.

شمارشی‌ها
THIRD_PARTY_URL_TYPE_UNSPECIFIED نوع نشانی وب طرف سوم در این نسخه نامشخص یا ناشناخته است.
THIRD_PARTY_URL_TYPE_IMPRESSION برای شمارش ظهورهای طرح آگهی پس‌از تکمیل میان‌گیری صدا یا ویدیو استفاده می‌شود.
THIRD_PARTY_URL_TYPE_CLICK_TRACKING برای ردیابی کلیک‌های کاربر روی صدا یا ویدیو استفاده می‌شود.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START برای ردیابی تعداد دفعاتی که کاربر صدا یا ویدیو را شروع می‌کند استفاده می‌شود.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE برای ردیابی تعداد دفعاتی که صدا یا ویدیو تا ۲۵٪ از طول آن پخش می‌شود استفاده می‌شود.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT برای ردیابی تعداد دفعاتی که صدا یا ویدیو تا ۵۰٪ طول آن پخش می‌شود استفاده می‌شود.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE برای ردیابی تعداد دفعاتی که صدا یا ویدیو تا ۷۵٪ طول آن پخش می‌شود استفاده می‌شود.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_COMPLETE برای ردیابی تعداد دفعاتی که صدا یا ویدیو تا پایان پخش می‌شود استفاده می‌شود.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE برای ردیابی تعداد دفعاتی که کاربر صدا یا ویدیو را بی‌صدا می‌کند استفاده می‌شود.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PAUSE برای ردیابی تعداد دفعاتی که کاربر صدا یا ویدیو را موقتاً متوقف می‌کند استفاده می‌شود.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND برای ردیابی تعداد دفعاتی که کاربر صدا یا ویدیو را بازپخش می‌کند استفاده می‌شود.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN برای ردیابی تعداد دفعاتی که کاربر پخش‌کننده را به اندازه تمام‌صفحه گسترش می‌دهد استفاده می‌شود.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP برای ردیابی تعداد دفعاتی که کاربر صدا یا ویدیو را متوقف می‌کند استفاده می‌شود.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM برای ردیابی تعداد دفعاتی که کاربر کلیک سفارشی انجام می‌دهد، مانند کلیک کردن روی نقطه داغ ویدیو، استفاده می‌شود.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_SKIP برای ردیابی تعداد دفعاتی که صدا یا ویدیو رد شده است استفاده می‌شود.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS برای ردیابی تعداد دفعاتی که صدا یا ویدیو تا یک افست تعیین‌شده توسط progressOffset پخش می‌شود استفاده می‌شود.

تراتبدیل کردن

اطلاعات مربوط به فایل صوتی یا ویدیویی تراتبدیل‌شده را نشان می‌دهد.

نمایش JSON 
{
  "name": string,
  "mimeType": string,
  "transcoded": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "bitRateKbps": string,
  "frameRate": number,
  "audioBitRateKbps": string,
  "audioSampleRateHz": string,
  "fileSizeBytes": string
}
فیلدها
name

string

اختیاری. نام فایل تراتبدیل‌شده.
mimeType

string

اختیاری. نوع MIME فایل تراتبدیل‌شده.
transcoded

boolean

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

object (Dimensions)

اختیاری. ابعاد ویدیو تراتبدیل‌شده.
bitRateKbps

string (int64 format)

اختیاری. نرخ بیت تراتبدیل ویدیوی تراتبدیل‌شده، برحسب کیلوبیت در ثانیه.
frameRate

number

اختیاری. نرخ فریم ویدیو تراتبدیل‌شده، بر حسب فریم در ثانیه.
audioBitRateKbps

string (int64 format)

اختیاری. نرخ بیت برای جاری‌سازی صوتی ویدیوی تراتبدیل‌شده، یا نرخ بیت برای صدای تراتبدیل‌شده، بر حسب کیلوبیت در ثانیه.
audioSampleRateHz

string (int64 format)

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

string (int64 format)

اختیاری. اندازه فایل تراتبدیل‌شده، به بایت.

CmTrackingAd

آگهی ردیابی Campaign Manager 360.

نمایش JSON 
{
  "cmPlacementId": string,
  "cmCreativeId": string,
  "cmAdId": string
}
فیلدها
cmPlacementId

string (int64 format)

اختیاری. شناسه جای آگهی آگهی ردگیری مدیر پویش ۳۶۰.
cmCreativeId

string (int64 format)

اختیاری. شناسه طرح‌آگهی آگهی ردگیری مدیر پویش ۳۶۰.
cmAdId

string (int64 format)

اختیاری. شناسه آگهی «آگهی ردگیری مدیر پویش ۳۶۰».

ObaIcon

نماد OBA برای طرح‌آگهی

نمایش JSON 
{
  "resourceUrl": string,
  "resourceMimeType": string,
  "position": enum (ObaIconPosition),
  "dimensions": {
    object (Dimensions)
  },
  "program": string,
  "landingPageUrl": string,
  "clickTrackingUrl": string,
  "viewTrackingUrl": string
}
فیلدها
resourceUrl

string

اختیاری. نشانی وب منبع نماد OBA.
resourceMimeType

string

اختیاری. نوع MIME منبع نماد OBA.
position

enum (ObaIconPosition)

اختیاری. جایگاه نماد OBA در طرح آگهی.
dimensions

object (Dimensions)

اختیاری. ابعاد نماد OBA.
program

string

اختیاری. برنامه نماد OBA. برای مثال: «AdChoices».
landingPageUrl

string

الزامی. نشانی وب صفحه مقصد نماد OBA.

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

  • https://info.evidon.com
  • https://l.betrad.com
clickTrackingUrl

string

الزامی. نشانی وب پیگیری کلیک نماد OBA.

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

  • https://info.evidon.com
  • https://l.betrad.com
viewTrackingUrl

string

الزامی. نشانی وب ردگیری نمای نماد OBA.

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

  • https://info.evidon.com
  • https://l.betrad.com

ObaIconPosition

جایگاه نماد OBA در طرح آگهی.

شمارشی‌ها
OBA_ICON_POSITION_UNSPECIFIED موقعیت نماد OBA مشخص نشده است.
OBA_ICON_POSITION_UPPER_RIGHT در گوشه بالا سمت راست طرح آگهی.
OBA_ICON_POSITION_UPPER_LEFT در بالا سمت راست طرح آگهی.
OBA_ICON_POSITION_LOWER_RIGHT در پایین سمت راست طرح آگهی.
OBA_ICON_POSITION_LOWER_LEFT در پایین سمت راست طرح آگهی.

ExpandingDirection

جهت گسترش آگهی خلاقانه گسترش‌پذیر طرف سوم.

شمارشی‌ها
EXPANDING_DIRECTION_UNSPECIFIED جهت گسترش مشخص نشده است.
EXPANDING_DIRECTION_NONE در هیچ جهتی گسترش نمی‌یابد.
EXPANDING_DIRECTION_UP به‌سمت بالا ازهم باز می‌شود.
EXPANDING_DIRECTION_DOWN به پایین ازهم باز می‌شود.
EXPANDING_DIRECTION_LEFT به‌سمت چپ گسترده می‌شود.
EXPANDING_DIRECTION_RIGHT به راست ازهم باز می‌شود.
EXPANDING_DIRECTION_UP_AND_LEFT به بالا و سمت چپ گسترش می‌یابد.
EXPANDING_DIRECTION_UP_AND_RIGHT به‌سمت بالا و راست ازهم باز می‌شود.
EXPANDING_DIRECTION_DOWN_AND_LEFT به پایین و سمت چپ گسترش می‌یابد.
EXPANDING_DIRECTION_DOWN_AND_RIGHT به پایین و سمت راست گسترش می‌یابد.
EXPANDING_DIRECTION_UP_OR_DOWN به‌سمت بالا یا پایین ازهم باز می‌شود.
EXPANDING_DIRECTION_LEFT_OR_RIGHT به سمت چپ یا راست گسترش می‌یابد.
EXPANDING_DIRECTION_ANY_DIAGONAL می‌تواند در هر جهت قطری گسترش یابد.

روش‌ها

create

 طرح آگهی جدیدی ایجاد می‌کند.

delete

 طرح‌آگهی را حذف می‌کند.

get

 یک طرح آگهی دریافت می‌کند.

list

 طرح‌آگهی‌های یک تبلیغ‌کننده را فهرست می‌کند.

patch

 طرح آگهی موجود را به‌روز می‌کند.