پیوست: نگاشت فیلدهای UI به فیلدهای API بر اساس نوع خلاق
جدول زیر، فیلدهای UI را به فیلدهای API مربوطه، جدا شده بر اساس نوع خلاق، نگاشت می‌کند. توجه داشته باشید که برخی از فیلدهای API نیاز به مشخصات بیشتر از طریق نقش یا نوع اختصاص داده شده برای منبع ارائه شده دارند.
خلاقیت تصویر استاندارد
| نوع خلاقیت: CREATIVE_TYPE_STANDARD |
| منبع میزبانی: HOSTING_SOURCE_HOSTED |
| نام | | ضروری | | نام فیلد API: displayName |
|
| دارایی خلاقانه | | ضروری | | نام فیلد API: دارایی | | نقش دارایی: ASSET_ROLE_MAIN |
|
| URL صفحه فرود | | ضروری | | نام فیلد API: exitEvents[].url | | خروج از نوع رویداد: EXIT_EVENT_TYPE_DEFAULT |
|
| وضعیت | | ضروری | | نام فیلد API: entityStatus |
|
| برچسب ردیابی HTML اضافه شد | | اختیاری | | نام فیلد API: appendedTag |
|
| کد یکپارچه سازی | | اختیاری | | نام فیلد API: integrationCode |
|
| یادداشت | | اختیاری | | نام فیلد API: یادداشت ها |
|
| وضعیت حسابرسی | | فقط خواندنی | | نام فیلد API: وضعیت بررسی |
|
خلاقیت HTML5
| نوع خلاقیت: CREATIVE_TYPE_STANDARD |
| منبع میزبانی: HOSTING_SOURCE_HOSTED |
| نام | | ضروری | | نام فیلد API: displayName |
|
| دارایی خلاقانه | | ضروری | | نام فیلد API: دارایی | | نقش دارایی: ASSET_ROLE_MAIN |
|
| وضعیت | | ضروری | | نام فیلد API: entityStatus |
|
| پشتیبان گیری از تصاویر | | اختیاری | | نام فیلد API: دارایی | | نقش دارایی: ASSET_ROLE_BACKUP |
|
| URL صفحه فرود پشتیبان | | اختیاری | | نام فیلد API: exitEvents[].url | | خروج از نوع رویداد: EXIT_EVENT_TYPE_BACKUP |
|
| برچسب گزارش خروج پشتیبان | | اختیاری | | نام فیلد API: exitEvents[].reportingName | | خروج از نوع رویداد: EXIT_EVENT_TYPE_BACKUP |
|
| بارگذاری مودبانه تصاویر | | اختیاری | | نام فیلد API: دارایی | | نقش دارایی: ASSET_ROLE_POLITE_LOAD |
|
| خارج می شود | | ضروری | | نام فیلد API: exitEvents[] | | خروج از نوع رویداد: EXIT_EVENT_TYPE_DEFAULT |
|
| شمارنده ها | | اختیاری | | نام فیلد API: counterEvents[] |
|
| تایمرها | | اختیاری | | نام فیلد API: timerEvents[] |
|
| برچسب ردیابی HTML اضافه شد | | اختیاری | | نام فیلد API: appendedTag |
|
| کد یکپارچه سازی | | اختیاری | | نام فیلد API: integrationCode |
|
| یادداشت | | اختیاری | | نام فیلد API: یادداشت ها |
|
| وضعیت حسابرسی | | اختیاری | | نام فیلد API: وضعیت بررسی |
|
شخص ثالث نمایش خلاق
| نوع خلاقیت: CREATIVE_TYPE_STANDARD |
| منبع میزبانی: HOSTING_SOURCE_THIRD_PARTY |
| نام | | ضروری | | نام فیلد API: displayName |
|
| وضعیت | | ضروری | | نام فیلد API: entityStatus |
|
| ابعاد | | ضروری | | نام فیلد API: dimensions |
|
| URL صفحه فرود | | ضروری | | نام فیلد API: exitEvents[].url | | خروج از نوع رویداد: EXIT_EVENT_TYPE_DEFAULT |
|
| به MRAID نیاز دارد | | اختیاری | | نام فیلد API: requireMraid |
|
| به HTML5 نیاز دارد | | اختیاری | | نام فیلد API: requireHtml5 |
|
| برچسب شخص ثالث | | ضروری | | نام فیلد API: thirdPartyTag |
|
| برای انتساب به پینگ نیاز دارد | | اختیاری | | نام فیلد API: requirePingForAttribution |
|
| کد یکپارچه سازی | | اختیاری | | نام فیلد API: integrationCode |
|
| یادداشت | | اختیاری | | نام فیلد API: یادداشت ها |
|
| وضعیت حسابرسی | | فقط خواندنی | | نام فیلد API: وضعیت بررسی |
|
خلاق توسعه پذیر شخص ثالث
| نوع خلاقیت: CREATIVE_TYPE_EXPANDABLE |
| منبع میزبانی: HOSTING_SOURCE_THIRD_PARTY |
| نام | | ضروری | | نام فیلد API: displayName |
|
| وضعیت | | ضروری | | نام فیلد API: entityStatus |
|
| ابعاد | | ضروری | | نام فیلد API: dimensions |
|
| URL صفحه فرود | | ضروری | | نام فیلد API: exitEvents[].url | | خروج از نوع رویداد: EXIT_EVENT_TYPE_DEFAULT |
|
| به MRAID نیاز دارد | | اختیاری | | نام فیلد API: requireMraid |
|
| به HTML5 نیاز دارد | | اختیاری | | نام فیلد API: requireHtml5 |
|
| در حال گسترش جهت | | ضروری | | نام فیلد API: expandingDirection |
|
| در حالت شناور گسترش دهید | | اختیاری | | نام فیلد API: expandOnHover |
|
| شخص ثالث | | ضروری | | نام فیلد API: thirdPartyTag |
|
| برای انتساب به پینگ نیاز دارد | | اختیاری | | نام فیلد API: requirePingForAttribution |
|
| کد یکپارچه سازی | | اختیاری | | نام فیلد API: integrationCode |
|
| یادداشت | | اختیاری | | نام فیلد API: یادداشت ها |
|
| وضعیت حسابرسی | | فقط خواندنی | | نام فیلد API: وضعیت بررسی |
|
خلاق ویدیو شخص ثالث
| نوع خلاقیت: CREATIVE_TYPE_VIDEO |
| منبع میزبانی: HOSTING_SOURCE_THIRD_PARTY |
| نام | | ضروری | | نام فیلد API: displayName |
|
| وضعیت | | ضروری | | نام فیلد API: entityStatus |
|
| نشانی وب برچسب VAST | | ضروری | | نام فیلد API: vastTagUrl |
|
| VPAID | | فقط خواندنی | | نام فیلد API: vpaid |
|
| ویدئوی HTML5 | | فقط خواندنی | | نام فیلد API: html5Video |
|
| برای انتساب به پینگ نیاز دارد | | اختیاری | | نام فیلد API: requirePingForAttribution |
|
| کد یکپارچه سازی | | اختیاری | | نام فیلد API: integrationCode |
|
| یادداشت | | اختیاری | | نام فیلد API: یادداشت ها |
|
| وضعیت حسابرسی | | فقط خواندنی | | نام فیلد API: وضعیت بررسی |
|
خلاق صوتی شخص ثالث
| نوع خلاقیت: CREATIVE_TYPE_AUDIO |
| منبع میزبانی: HOSTING_SOURCE_THIRD_PARTY |
| نام | | ضروری | | نام فیلد API: displayName |
|
| وضعیت | | ضروری | | نام فیلد API: entityStatus |
|
| نشانی وب برچسب VAST | | ضروری | | نام فیلد API: vastTagUrl |
|
| برای انتساب به پینگ نیاز دارد | | اختیاری | | نام فیلد API: requirePingForAttribution |
|
| کد یکپارچه سازی | | اختیاری | | نام فیلد API: integrationCode |
|
| یادداشت | | اختیاری | | نام فیلد API: یادداشت ها |
|
| وضعیت حسابرسی | | فقط خواندنی | | نام فیلد API: وضعیت بررسی |
|
ویدیو خلاق
| نوع خلاقیت: CREATIVE_TYPE_VIDEO |
| منبع میزبانی: HOSTING_SOURCE_HOSTED |
| نام | | ضروری | | نام فیلد API: displayName |
|
| وضعیت | | ضروری | | نام فیلد API: entityStatus |
|
| منبع فایل | | ضروری | | نام فیلد API: دارایی | | نقش دارایی: ASSET_ROLE_MAIN |
|
| URL صفحه فرود | | ضروری | | نام فیلد API: exitEvents[].url | | خروج از نوع رویداد: EXIT_EVENT_TYPE_DEFAULT |
|
| شامل دکمه پرش | | اختیاری | | نام فیلد API: قابل رد شدن |
|
| از افست پرش کنید | | اختیاری | | نام فیلد API: skipOffset |
|
| جبران پیشرفت | | اختیاری | | نام فیلد API: progressOffset |
|
| شناسه آگهی جهانی | | اختیاری | | نام فیلد API: universalAdId |
|
| OBA | | اختیاری | | نام فیلد API: obaIcon |
|
| خلاقان همراه | | اختیاری | | نام فیلد API: companionCreativeIds |
|
| فایل ارائه | | فقط خواندنی | | نام فیلد API: transcodes |
|
| URL های شخص ثالث | | اختیاری | | نام فیلد API: thirdPartyUrls |
|
| کد یکپارچه سازی | | اختیاری | | نام فیلد API: integrationCode |
|
| یادداشت | | اختیاری | | نام فیلد API: یادداشت ها |
|
| وضعیت حسابرسی | | فقط خواندنی | | نام فیلد API: وضعیت بررسی |
|
خلاق صوتی
| نوع خلاقیت: CREATIVE_TYPE_AUDIO |
| منبع میزبانی: HOSTING_SOURCE_HOSTED |
| نام | | ضروری | | نام فیلد API: displayName |
|
| وضعیت | | ضروری | | نام فیلد API: entityStatus |
|
| منبع فایل | | ضروری | | نام فیلد API: دارایی | | نقش دارایی: ASSET_ROLE_MAIN |
|
| URL صفحه فرود | | ضروری | | نام فیلد API: exitEvents[].url | | خروج از نوع رویداد: EXIT_EVENT_TYPE_DEFAULT |
|
| دارایی همراه (آپلود یا تخصیص) | | ضروری | | نام فیلد API: companionCreativeIds |
|
| نام فایل ارائه | | فقط خواندنی | | نام فیلد API: transcodes[].name |
|
| نوع فایل ارائه | | فقط خواندنی | | نام فیلد API: transcodes[].mimeType |
|
| ارائه نرخ بیت صوتی فایل | | فقط خواندنی | | نام فیلد API: transcodes[].audioBitRateKbps |
|
| نرخ نمونه صوتی ارائه فایل | | فقط خواندنی | | نام فیلد API: transcodes[].audioSampleRateHz |
|
| URL های شخص ثالث | | اختیاری | | نام فیلد API: thirdPartyUrls |
|
| کد یکپارچه سازی | | اختیاری | | نام فیلد API: integrationCode |
|
| یادداشت | | اختیاری | | نام فیلد API: یادداشت ها |
|
| وضعیت حسابرسی | | فقط خواندنی | | نام فیلد API: وضعیت بررسی |
|
Native Display Creative
| نوع خلاقیت: CREATIVE_TYPE_NATIVE، CREATIVE_TYPE_NATIVE_SITE_SQUARE |
| منبع میزبانی: HOSTING_SOURCE_HOSTED |
| نام | | ضروری | | نام فیلد API: displayName |
|
| وضعیت | | ضروری | | نام فیلد API: entityStatus |
|
| لوگو | | ضروری | | نام فیلد API: دارایی | | نقش دارایی: ASSET_ROLE_ICON |
|
| تصویر / تصویر مربع | | ضروری | | نام فیلد API: دارایی | | نقش دارایی: ASSET_ROLE_MAIN |
|
| عنوان | | ضروری | | نام فیلد API: دارایی | | نقش دارایی: ASSET_ROLE_HEADLINE |
|
| تیتر طولانی | | اختیاری | | نام فیلد API: دارایی | | نقش دارایی: ASSET_ROLE_LONG_HEADLINE |
|
| متن بدنه | | ضروری | | نام فیلد API: دارایی | | نقش دارایی: ASSET_ROLE_BODY |
|
| متن متن بلند | | اختیاری | | نام فیلد API: دارایی | | نقش دارایی: ASSET_ROLE_LONG_BODY |
|
| URL صفحه فرود | | ضروری | | نام فیلد API: exitEvents[].url | | خروج از نوع رویداد: EXIT_EVENT_TYPE_DEFAULT |
|
| URL زیرنویس | | ضروری | | نام فیلد API: دارایی | | نقش دارایی: ASSET_ROLE_CAPTION_URL |
|
| فراخوانی برای اقدام | | ضروری | | نام فیلد API: دارایی | | نقش دارایی: ASSET_ROLE_CALL_TO_ACTION |
|
| تبلیغات ردیابی Campaign Manager 360 | | اختیاری | | نام فیلد API: cmTrackingAd |
|
| URL ردیابی نمایش 1 | | اختیاری | | نام فیلد API: trackingUrls[] |
|
| URL ردیابی تأثیر 2 | | اختیاری | | نام فیلد API: trackingUrls[] |
|
| URL ردیابی جاوا اسکریپت | | اختیاری | | نام فیلد API: jsTrackerUrl |
|
| کد یکپارچه سازی | | اختیاری | | نام فیلد API: integrationCode |
|
| یادداشت | | اختیاری | | نام فیلد API: یادداشت ها |
|
| وضعیت حسابرسی | | فقط خواندنی | | نام فیلد API: وضعیت بررسی |
|
خلاق ویدیوی بومی
| نوع خلاقیت: CREATIVE_TYPE_NATIVE_VIDEO |
| منبع میزبانی: HOSTING_SOURCE_HOSTED |
| نام | | ضروری | | نام فیلد API: displayName |
|
| وضعیت | | ضروری | | نام فیلد API: entityStatus |
|
| لوگو | | ضروری | | نام فیلد API: دارایی | | نقش دارایی: ASSET_ROLE_ICON |
|
| ویدئو | | ضروری | | نام فیلد API: دارایی | | نقش دارایی: ASSET_ROLE_MAIN |
|
| تصویر روی جلد | | ضروری | | نام فیلد API: دارایی | | نقش دارایی: ASSET_ROLE_COVER_IMAGE |
|
| نام تبلیغ کننده | | ضروری | | نام فیلد API: دارایی | | نقش دارایی: ASSET_ROLE_ADVERTISER_NAME |
|
| عنوان | | ضروری | | نام فیلد API: دارایی | | نقش دارایی: ASSET_ROLE_HEADLINE |
|
| تیتر طولانی | | اختیاری | | نام فیلد API: دارایی | | نقش دارایی: ASSET_ROLE_LONG_HEADLINE |
|
| متن بدنه | | ضروری | | نام فیلد API: دارایی | | نقش دارایی: ASSET_ROLE_BODY |
|
| متن متن بلند | | اختیاری | | نام فیلد API: دارایی | | نقش دارایی: ASSET_ROLE_LONG_BODY |
|
| URL صفحه فرود | | ضروری | | نام فیلد API: exitEvents[].url | | خروج از نوع رویداد: EXIT_EVENT_TYPE_DEFAULT |
|
| URL زیرنویس | | ضروری | | نام فیلد API: دارایی | | نقش دارایی: ASSET_ROLE_CAPTION_URL |
|
| فراخوانی برای اقدام | | ضروری | | نام فیلد API: دارایی | | نقش دارایی: ASSET_ROLE_CALL_TO_ACTION |
|
| URL ردیابی نمایش 1 | | اختیاری | | نام فیلد API: trackingUrls[] |
|
| URL ردیابی تأثیر 2 | | اختیاری | | نام فیلد API: trackingUrls[] |
|
| URL ردیابی جاوا اسکریپت | | اختیاری | | نام فیلد API: jsTrackerUrl |
|
| کد یکپارچه سازی | | اختیاری | | نام فیلد API: integrationCode |
|
| یادداشت | | اختیاری | | نام فیلد API: یادداشت ها |
|
| وضعیت حسابرسی | | فقط خواندنی | | نام فیلد API: وضعیت بررسی |
|
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-11-06 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2024-11-06 بهوقت ساعت هماهنگ جهانی."],[[["This document provides a comprehensive mapping of UI fields to their corresponding API fields for various creative types, including Standard Image, HTML5, Third-Party Display, Third-Party Expandable, Third-Party Video, Third-Party Audio, Video, Audio, Native Display, and Native Video."],["Each creative type has a specific set of required and optional fields, along with their API field names and any further specifications for asset roles or exit event types."],["Creative asset specifications, such as required and optional assets, are outlined for Native Video creatives, including details about their roles and corresponding API field names."],["Campaign Manager 360 tracking ad can optionally be included using the `cmTrackingAd` API field."],["This mapping enables developers to understand how UI inputs translate into API data for seamless creative management and integration within the system."]]],[]]
