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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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 )

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

  • 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 هر دو الزامی هستند و باید بزرگتر یا مساوی 0 باشند.

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 )

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

  • از قسمت ضربه زدن در گوگل وب دیزاینر استفاده کنید.
  • یک متغیر جاوا اسکریپت به نام "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 مقدار true دارد، الزامی است.

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

  • CREATIVE_TYPE_VIDEO
progressOffset

object ( AudioVideoOffset )

اختیاری. مدت زمان پخش ویدیو قبل از شمارش بازدید.

این فیلد زمانی که skippable مقدار true دارد، الزامی است.

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

  • CREATIVE_TYPE_VIDEO
universalAdId

object ( UniversalAdId )

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

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

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

  • CREATIVE_TYPE_VIDEO
thirdPartyUrls[]

object ( ThirdPartyUrl )

اختیاری. ردیابی URL های اشخاص ثالث برای ردیابی تعاملات با یک ویدیوی خلاقانه.

این فیلد فقط برای 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

اختیاری. ردیابی URLها برای ارائه‌دهندگان خدمات تحلیلی یا فروشندگان فناوری تبلیغات شخص ثالث.

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

فقط URL های استاندارد، بدون تگ های 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 )

اختیاری. تبلیغ ردیابی Campaign Manager 360 مرتبط با طرح تبلیغاتی.

اختیاری برای نوع creativeType زیر، زمانی که توسط تبلیغ‌کننده‌ای ایجاد شده باشد که هم از Campaign Manager 360 و هم از سرویس تبلیغات شخص ثالث استفاده می‌کند:

  • 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 )

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

هاستینگ سورس

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

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

یک همگام‌سازی خلاقانه از Campaign Manager 360.

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

HOSTING_SOURCE_THIRD_PARTY

یک تبلیغ خلاقانه که توسط یک سرور تبلیغاتی شخص ثالث (3PAS) میزبانی می‌شود.

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

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_HOSTED

یک تبلیغ خلاقانه که در DV360 ایجاد شده و توسط Campaign Manager 360 میزبانی شده است.

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

  • 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 میزبانی شده است.

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

ویژگی خلاقانه

ویژگی‌های احتمالی یک فرد خلاق.

انوم‌ها
CREATIVE_ATTRIBUTE_UNSPECIFIED ویژگی خالق در این نسخه مشخص نشده یا ناشناخته است.
CREATIVE_ATTRIBUTE_VAST خلاق، خلاقیّتی عظیم است.
CREATIVE_ATTRIBUTE_VPAID_LINEAR این طرح خلاقانه، یک طرح خلاقانه خطی VPAID است.
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR این خلاقیت، یک خلاقیت غیرخطی VPAID است.

اطلاعات وضعیت نقد و بررسی

وضعیت‌ها را برای فرد خلاق بررسی کنید.

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

وضعیت‌های نقد و بررسی را برای فرد خلاق رد و بدل کنید.

وضعیت تأیید

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

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

وضعیت نقد و بررسی

انواع احتمالی وضعیت بررسی.

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

وضعیت بررسی صرافی

وضعیت بررسی را برای خلاق تغییر دهید.

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

enum ( Exchange )

تبادل نظر در مورد خلاقیت.

status

enum ( ReviewStatus )

وضعیت بررسی صرافی.

انجمن دارایی‌ها

انجمن دارایی برای خلاقان.

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

object ( Asset )

اختیاری. دارایی مرتبط.

role

enum ( AssetRole )

اختیاری. نقش این دارایی برای خلاقیت.

دارایی

یک دارایی واحد.

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

string ( int64 format)

شناسه رسانه مربوط به محتوای آپلود شده. این یک شناسه منحصر به فرد برای محتوا است. این شناسه می‌تواند به سایر فراخوانی‌های API، مانند creatives.create برای مرتبط کردن محتوا با یک محتوای خلاقانه ارسال شود.

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

content

string

محتوای فایل. برای فایل‌های آپلود شده، محتوا همان مسیر ارائه است.

نقش دارایی

نقش این دارایی برای خلاقیت.

انوم‌ها
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 و حداکثر با طول 30 کاراکتر کدگذاری شود.

برای مثال، اگر آدرس صفحه فرود «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

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

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

content باید با کد UTF-8 و حداکثر با طول ۱۵ کاراکتر کدگذاری شود.

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

ASSET_ROLE_ANDROID_APP_ID

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

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

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

ASSET_ROLE_IOS_APP_ID

شناسه یک برنامه iOS در فروشگاه برنامه اپل.

این شماره شناسه را می‌توان در آدرس اینترنتی فروشگاه اپل اپ استور به صورت رشته‌ای از اعداد، درست بعد از «id» یافت. برای مثال، در https://apps.apple.com/us/app/gmail-email-by-google/id422689480 شناسه ۴۲۲۶۸۹۴۸۰ است.

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

ASSET_ROLE_RATING

رتبه‌بندی یک برنامه در فروشگاه گوگل پلی یا فروشگاه برنامه‌های 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

رویداد خروج

رویداد خروج از خلاقیت.

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

enum ( ExitEventType )

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

url

string

الزامی. آدرس اینترنتی رویداد خروج (click through URL). این مورد زمانی الزامی است که type باشد:

  • EXIT_EVENT_TYPE_DEFAULT
  • EXIT_EVENT_TYPE_BACKUP
name

string

اختیاری. نام تگ کلیک رویداد خروج.

این نام باید در یک اثر خلاقانه منحصر به فرد باشد.

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

reportingName

string

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

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

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

انوم‌ها
EXIT_EVENT_TYPE_UNSPECIFIED نوع رویداد خروج در این نسخه مشخص نشده یا ناشناخته است.
EXIT_EVENT_TYPE_DEFAULT رویداد خروج، رویداد پیش‌فرض است.
EXIT_EVENT_TYPE_BACKUP رویداد خروج، یک رویداد خروج پشتیبان است. در یک متن خلاقانه ممکن است چندین رویداد خروج پشتیبان وجود داشته باشد.

رویداد تایمر

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

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

string

الزامی. نام رویداد تایمر.

reportingName

string

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

رویداد متقابل

رویداد متقابل خلاقیت.

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

string

الزامی. نام رویداد متقابل.

reportingName

string

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

آفست صوتی تصویری

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

نمایش JSON 
{

  // Union field offset can be only one of the following:
  "percentage": string,
  "seconds": string
  // End of list of possible types for union field offset.
}
فیلدها
مقدار offset فیلد Union . offset می‌تواند فقط یکی از موارد زیر باشد:
percentage

string ( int64 format)

اختیاری. درصد اختلاف مدت زمان صدا یا تصویر.

seconds

string ( int64 format)

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

یونیورسال ادید

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

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

string

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

registry

enum ( UniversalAdRegistry )

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

رجیستری جهانی

این رجیستری، شناسه‌های خلاقانه‌ی منحصر به فردی را در قالب یک شناسه‌ی تبلیغ جهانی (Universal Ad ID) ارائه می‌دهد.

انوم‌ها
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 استفاده کنید.

آدرس اینترنتی شخص ثالث

ردیابی URL های اشخاص ثالث برای ردیابی تعاملات با یک محتوای صوتی یا تصویری خلاقانه.

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

enum ( ThirdPartyUrlType )

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

url

string

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

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

نوع آدرس شخص ثالث

نوع تعامل باید توسط URL ردیابی شخص ثالث ردیابی شود.

انوم‌ها
THIRD_PARTY_URL_TYPE_UNSPECIFIED نوع URL شخص ثالث مشخص نشده یا در این نسخه ناشناخته است.
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

یک تبلیغ ردیابی ۳۶۰ درجه از مدیر کمپین.

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

string ( int64 format)

اختیاری. شناسه قرارگیری مدیر کمپین ردیابی ۳۶۰ درجه.

cmCreativeId

string ( int64 format)

اختیاری. شناسه‌ی سازنده‌ی مدیر کمپین تبلیغاتی با قابلیت ردیابی ۳۶۰ درجه.

cmAdId

string ( int64 format)

اختیاری. شناسه تبلیغ مدیر کمپین ردیابی ۳۶۰ درجه.

اوباآیکون

آیکون 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

موقعیت آیکون Oba

موقعیت آیکون 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 در سمت چپ پایین صفحه نمایش.

جهت گسترش

جهت رو به گسترش خلاقیت قابل توسعه شخص ثالث.

انوم‌ها
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

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