از
8 سپتامبر 2025 ، هر مورد خط جدید باید اعلام کند که آیا تبلیغات سیاسی اتحادیه اروپا (EU) را ارائه می دهد یا خیر. Display & Video 360 API و بارگذاریهای SDF که اعلانها را ارائه نمیکنند با شکست مواجه میشوند. برای جزئیات بیشتر در مورد نحوه به روز رسانی یکپارچه سازی خود برای ایجاد این اعلامیه، به
صفحه لغو اعتبار ما مراجعه کنید.
پیوست: نگاشت فیلدهای 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 و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThis 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.\u003c/p\u003e\n"],["\u003cp\u003eEach 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.\u003c/p\u003e\n"],["\u003cp\u003eCreative asset specifications, such as required and optional assets, are outlined for Native Video creatives, including details about their roles and corresponding API field names.\u003c/p\u003e\n"],["\u003cp\u003eCampaign Manager 360 tracking ad can optionally be included using the \u003ccode\u003ecmTrackingAd\u003c/code\u003e API field.\u003c/p\u003e\n"],["\u003cp\u003eThis mapping enables developers to understand how UI inputs translate into API data for seamless creative management and integration within the system.\u003c/p\u003e\n"]]],[],null,[]]