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
}
زمینه های
name

string

فقط خروجی نام منبع خلاق.

advertiserId

string ( int64 format)

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

creativeId

string ( int64 format)

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

cmPlacementId

string ( int64 format)

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

displayName

string

ضروری. نام نمایشی خلاق.

باید UTF-8 با حداکثر اندازه 240 بایت کدگذاری شود.

entityStatus

enum ( EntityStatus )

ضروری. کنترل می کند که آیا خلاق می تواند ارائه شود یا خیر.

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

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
  • ENTITY_STATUS_PAUSED
updateTime

string ( Timestamp format)

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

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

createTime

string ( Timestamp format)

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

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

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 با طول بیش از 10000 کاراکتر رمزگذاری شده باشد.

notes

string

یادداشت های کاربر برای این خلاقیت. باید UTF-8 با طول بیش از 20000 کاراکتر رمزگذاری شده باشد.

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

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

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

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

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

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
jsTrackerUrl

string

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

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

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
cmTrackingAd

object ( CmTrackingAd )

آگهی ردیابی Campaign Manager 360 مرتبط با خلاقیت.

زمانی که توسط تبلیغ‌کننده‌ای ایجاد می‌شود که هم از Campaign Manager 360 و هم از ارائه آگهی شخص ثالث استفاده می‌کند، برای 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

منبع میزبانی

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

Enums
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

ویژگی های احتمالی یک خلاق

Enums
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)
    }
  ],
  "publisherReviewStatuses": [
    {
      object (PublisherReviewStatus)
    }
  ]
}
زمینه های
approvalStatus

enum ( ApprovalStatus )

نشان دهنده تأیید اولیه مورد نیاز برای یک خلاق برای شروع خدمت است. خلاصه creativeAndLandingPageReviewStatus و contentAndPolicyReviewStatus .

creativeAndLandingPageReviewStatus

enum ( ReviewStatus )

وضعیت بررسی خلاقیت و صفحه فرود برای خلاق.

contentAndPolicyReviewStatus

enum ( ReviewStatus )

وضعیت بررسی محتوا و خط‌مشی برای خلاق.

exchangeReviewStatuses[]

object ( ExchangeReviewStatus )

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

publisherReviewStatuses[]

object ( PublisherReviewStatus )

وضعیت بررسی ناشر برای خلاق.

وضعیت تایید

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

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

وضعیت بررسی

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

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

ExchangeReviewStatus

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

نمایندگی JSON
{
  "exchange": enum (Exchange),
  "status": enum (ReviewStatus)
}
زمینه های
exchange

enum ( Exchange )

تبادل نظر خلاق.

status

enum ( ReviewStatus )

وضعیت بررسی بورس

PublisherReview Status

وضعیت بررسی ناشر برای خلاق.

نمایندگی JSON
{
  "publisherName": string,
  "status": enum (ReviewStatus)
}
زمینه های
publisherName

string

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

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)

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

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

content

string

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

AssetRole

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

Enums
ASSET_ROLE_UNSPECIFIED نقش دارایی در این نسخه مشخص نشده یا ناشناخته است.
ASSET_ROLE_MAIN دارایی، دارایی اصلی خلاق است.
ASSET_ROLE_BACKUP دارایی یک دارایی پشتیبان خلاق است.
ASSET_ROLE_POLITE_LOAD دارایی یک دارایی بار مودبانه خلاق است.
ASSET_ROLE_HEADLINE

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

content باید دارای کد UTF-8 با طول حداکثر 25 کاراکتر باشد.

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

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_HEADLINE

تیتر طولانی یک خلاق بومی.

content باید دارای کد UTF-8 با طول حداکثر 50 کاراکتر باشد.

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

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_BODY

متن متن یک خلاق بومی.

content باید دارای کد UTF-8 با طول حداکثر 90 کاراکتر باشد.

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

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_BODY

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

content باید دارای کد UTF-8 با طول حداکثر 150 کاراکتر باشد.

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

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CAPTION_URL

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

content باید دارای کد UTF-8 با طول حداکثر 30 کاراکتر باشد.

به عنوان مثال، اگر URL صفحه فرود "http://www.example.com/page" باشد، نشانی اینترنتی عنوان می تواند "example.com" باشد. پروتکل (http://) اختیاری است، اما URL نمی تواند حاوی فاصله یا کاراکترهای خاص باشد.

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

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CALL_TO_ACTION

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

content باید دارای کد UTF-8 با طول حداکثر 15 کاراکتر باشد.

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

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_ADVERTISER_NAME

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

content باید دارای کد UTF-8 با طول حداکثر 25 کاراکتر باشد.

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

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_PRICE

قیمت خرید برنامه شما در فروشگاه Google play یا فروشگاه برنامه iOS (به عنوان مثال 5.99 دلار).

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

content باید دارای کد UTF-8 با طول حداکثر 15 کاراکتر باشد.

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

ASSET_ROLE_ANDROID_APP_ID

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

این شماره شناسه را می توان در URL فروشگاه App Apple به عنوان رشته اعداد مستقیماً بعد از "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

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

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

Enums
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
{

  // 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 میدان اتحادیه ارزش افست. offset تنها می تواند یکی از موارد زیر باشد:
percentage

string ( int64 format)

افست بر حسب درصد مدت زمان صدا یا تصویر.

seconds

string ( int64 format)

افست در چند ثانیه از شروع صدا یا تصویر.

UniversalAdId

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

نمایندگی JSON
{
  "id": string,
  "registry": enum (UniversalAdRegistry)
}
زمینه های
id

string

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

registry

enum ( UniversalAdRegistry )

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

UniversalAdRegistry

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

Enums
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 ردیابی ردیابی شود

url

string

URL ردیابی که برای ردیابی تعامل استفاده می شود.

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

ThirdPartyUrlType

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

Enums
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 برای ردیابی تعداد دفعات پخش صدا یا ویدیو تا 25 درصد طول آن استفاده می شود.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT برای ردیابی تعداد دفعات پخش صدا یا ویدیو تا 50 درصد طول آن استفاده می شود.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE برای ردیابی تعداد دفعات پخش صدا یا ویدیو تا 75 درصد طول آن استفاده می شود.
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)

شناسه مکان آگهی ردیابی مدیر کمپین 360.

cmCreativeId

string ( int64 format)

شناسه خلاقانه تبلیغات ردیابی مدیر کمپین 360.

cmAdId

string ( int64 format)

شناسه آگهی تبلیغاتی 360 مدیر کمپین.

ObaIcon

نماد OBA برای یک خلاق

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

string

URL منبع نماد OBA.

resourceMimeType

string

نوع MIME منبع نماد OBA.

position

enum ( ObaIconPosition )

موقعیت نماد OBA روی خلاق.

dimensions

object ( Dimensions )

ابعاد نماد OBA.

program

string

برنامه نماد OBA. به عنوان مثال: "AdChoices".

landingPageUrl

string

ضروری. نشانی وب صفحه فرود نماد OBA.

فقط URL های دامنه های زیر مجاز است:

clickTrackingUrl

string

ضروری. نشانی وب ردیابی کلیک نماد OBA.

فقط URL های دامنه های زیر مجاز است:

viewTrackingUrl

string

ضروری. نشانی وب ردیابی نمایش نماد OBA.

فقط URL های دامنه های زیر مجاز است:

ObaIconPosition

موقعیت نماد OBA روی خلاق.

Enums
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

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

Enums
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

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