החל מ-
8 בספטמבר 2025, בכל פריט חדש צריך להצהיר אם הוא יציג מודעות פוליטיות באיחוד האירופי (EU) או לא. העלאות של קובצי SDF ושל Display & Video 360 API שלא כוללות הצהרות ייכשלו. מידע נוסף על אופן העדכון של האינטגרציה כדי להוסיף את ההצהרה הזו זמין ב
דף ההוצאה משימוש.
נספח: מיפוי שדות של ממשק המשתמש לשדות API לפי סוג הקריאייטיב
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בטבלה הבאה מפורטים השדות בממשק המשתמש שממופים לשדות API תואמים, מופרדים לפי סוג הקריאייטיב. חשוב לזכור שחלק משדות ה-API דורשים ציון נוסף באמצעות תפקיד או סוג שהוקצו למשאב שצוין.
קריאייטיב בתמונה רגילה
| סוג הקריאייטיב: CREATIVE_TYPE_STANDARD |
| מקור האירוח: HOSTING_SOURCE_HOSTED |
|
שם
|
|
חובה
|
|
שם השדה ב-API: displayName
|
|
|
נכס קריאייטיב
|
|
חובה
|
|
שם השדה ב-API: assets
|
|
תפקיד הנכס: ASSET_ROLE_MAIN
|
|
|
כתובת דף הנחיתה
|
|
חובה
|
|
שם השדה ב-API: exitEvents[].url
|
|
סוג אירוע היציאה: EXIT_EVENT_TYPE_DEFAULT
|
|
|
סטטוס
|
|
חובה
|
|
שם השדה ב-API: entityStatus
|
|
|
תג מעקב HTML שנוסף
|
|
אופציונלי
|
|
שם השדה ב-API: appendedTag
|
|
|
קוד שילוב
|
|
אופציונלי
|
|
שם השדה ב-API: integrationCode
|
|
|
הערות
|
|
אופציונלי
|
|
שם השדה ב-API: notes
|
|
|
סטטוס הביקורת
|
|
קריאה בלבד
|
|
שם השדה ב-API: reviewStatus
|
|
נכס קריאייטיב מסוג HTML5
| סוג הקריאייטיב: CREATIVE_TYPE_STANDARD |
| מקור האירוח: HOSTING_SOURCE_HOSTED |
|
שם
|
|
חובה
|
|
שם השדה ב-API: displayName
|
|
|
נכס קריאייטיב
|
|
חובה
|
|
שם השדה ב-API: assets
|
|
תפקיד הנכס: ASSET_ROLE_MAIN
|
|
|
סטטוס
|
|
חובה
|
|
שם השדה ב-API: entityStatus
|
|
|
תמונות גיבוי
|
|
אופציונלי
|
|
שם השדה ב-API: assets
|
|
תפקיד נכס: ASSET_ROLE_BACKUP
|
|
|
כתובת ה-URL של דף הנחיתה לגיבוי
|
|
אופציונלי
|
|
שם השדה ב-API: exitEvents[].url
|
|
סוג אירוע היציאה: EXIT_EVENT_TYPE_BACKUP
|
|
|
תווית הדיווח של יציאה לגיבוי
|
|
אופציונלי
|
|
שם שדה ה-API: exitEvents[].reportingName
|
|
סוג אירוע היציאה: EXIT_EVENT_TYPE_BACKUP
|
|
|
תמונות עם טעינה בהשהיית קו הזמן
|
|
אופציונלי
|
|
שם השדה ב-API: assets
|
|
תפקיד הנכס: ASSET_ROLE_POLITE_LOAD
|
|
|
יציאות
|
|
חובה
|
|
שם השדה ב-API: exitEvents[]
|
|
סוג אירוע היציאה: EXIT_EVENT_TYPE_DEFAULT
|
|
|
מונים
|
|
אופציונלי
|
|
שם השדה ב-API: counterEvents[]
|
|
|
טיימרים
|
|
אופציונלי
|
|
שם השדה ב-API: timerEvents[]
|
|
|
תג מעקב HTML שנוסף
|
|
אופציונלי
|
|
שם השדה ב-API: appendedTag
|
|
|
קוד שילוב
|
|
אופציונלי
|
|
שם השדה ב-API: integrationCode
|
|
|
הערות
|
|
אופציונלי
|
|
שם השדה ב-API: notes
|
|
|
סטטוס הביקורת
|
|
אופציונלי
|
|
שם השדה ב-API: reviewStatus
|
|
נכסי קריאייטיב לרשת המדיה של צד שלישי
| סוג הקריאייטיב: CREATIVE_TYPE_STANDARD |
| מקור האירוח: HOSTING_SOURCE_THIRD_PARTY |
|
שם
|
|
חובה
|
|
שם השדה ב-API: displayName
|
|
|
סטטוס
|
|
חובה
|
|
שם השדה ב-API: entityStatus
|
|
|
מידות
|
|
חובה
|
|
שם השדה ב-API: מאפיינים
|
|
|
כתובת דף הנחיתה
|
|
חובה
|
|
שם השדה ב-API: exitEvents[].url
|
|
סוג אירוע היציאה: EXIT_EVENT_TYPE_DEFAULT
|
|
|
נדרש MRAID
|
|
אופציונלי
|
|
שם השדה ב-API: requireMraid
|
|
|
נדרשת תמיכה ב-HTML5
|
|
אופציונלי
|
|
שם השדה ב-API: requireHtml5
|
|
|
תג של צד שלישי
|
|
חובה
|
|
שם השדה ב-API: thirdPartyTag
|
|
|
נדרש ping לצורך שיוך
|
|
אופציונלי
|
|
שם השדה ב-API: requirePingForAttribution
|
|
|
קוד שילוב
|
|
אופציונלי
|
|
שם השדה ב-API: integrationCode
|
|
|
הערות
|
|
אופציונלי
|
|
שם השדה ב-API: notes
|
|
|
סטטוס הביקורת
|
|
קריאה בלבד
|
|
שם השדה ב-API: reviewStatus
|
|
קריאייטיב מתרחב של צד שלישי
| סוג הקריאייטיב: CREATIVE_TYPE_EXPANDABLE |
| מקור האירוח: HOSTING_SOURCE_THIRD_PARTY |
|
שם
|
|
חובה
|
|
שם השדה ב-API: displayName
|
|
|
סטטוס
|
|
חובה
|
|
שם השדה ב-API: entityStatus
|
|
|
מידות
|
|
חובה
|
|
שם השדה ב-API: מאפיינים
|
|
|
כתובת דף הנחיתה
|
|
חובה
|
|
שם השדה ב-API: exitEvents[].url
|
|
סוג אירוע היציאה: EXIT_EVENT_TYPE_DEFAULT
|
|
|
נדרש MRAID
|
|
אופציונלי
|
|
שם השדה ב-API: requireMraid
|
|
|
נדרשת תמיכה ב-HTML5
|
|
אופציונלי
|
|
שם השדה ב-API: requireHtml5
|
|
|
כיוון ההרחבה
|
|
חובה
|
|
שם השדה ב-API: expandingDirection
|
|
|
הרחבה בהצבת הסמן מעל
|
|
אופציונלי
|
|
שם השדה ב-API: expandOnHover
|
|
|
צד שלישי
|
|
חובה
|
|
שם השדה ב-API: thirdPartyTag
|
|
|
נדרש ping לצורך שיוך
|
|
אופציונלי
|
|
שם השדה ב-API: requirePingForAttribution
|
|
|
קוד שילוב
|
|
אופציונלי
|
|
שם השדה ב-API: integrationCode
|
|
|
הערות
|
|
אופציונלי
|
|
שם השדה ב-API: notes
|
|
|
סטטוס הביקורת
|
|
קריאה בלבד
|
|
שם השדה ב-API: reviewStatus
|
|
קריאייטיב וידאו של צד שלישי
| סוג הקריאייטיב: CREATIVE_TYPE_VIDEO |
| מקור האירוח: HOSTING_SOURCE_THIRD_PARTY |
|
שם
|
|
חובה
|
|
שם השדה ב-API: displayName
|
|
|
סטטוס
|
|
חובה
|
|
שם השדה ב-API: entityStatus
|
|
|
כתובת ה-URL של תג VAST
|
|
חובה
|
|
שם השדה ב-API: vastTagUrl
|
|
|
VPAID
|
|
קריאה בלבד
|
|
שם השדה ב-API: vpaid
|
|
|
נגן סרטונים ב-HTML5
|
|
קריאה בלבד
|
|
שם השדה ב-API: html5Video
|
|
|
נדרש ping לצורך שיוך
|
|
אופציונלי
|
|
שם השדה ב-API: requirePingForAttribution
|
|
|
קוד שילוב
|
|
אופציונלי
|
|
שם השדה ב-API: integrationCode
|
|
|
הערות
|
|
אופציונלי
|
|
שם השדה ב-API: notes
|
|
|
סטטוס הביקורת
|
|
קריאה בלבד
|
|
שם השדה ב-API: reviewStatus
|
|
קריאייטיב אודיו של צד שלישי
| סוג הקריאייטיב: CREATIVE_TYPE_AUDIO |
| מקור האירוח: HOSTING_SOURCE_THIRD_PARTY |
|
שם
|
|
חובה
|
|
שם השדה ב-API: displayName
|
|
|
סטטוס
|
|
חובה
|
|
שם השדה ב-API: entityStatus
|
|
|
כתובת ה-URL של תג VAST
|
|
חובה
|
|
שם השדה ב-API: vastTagUrl
|
|
|
נדרש ping לצורך שיוך
|
|
אופציונלי
|
|
שם השדה ב-API: requirePingForAttribution
|
|
|
קוד שילוב
|
|
אופציונלי
|
|
שם השדה ב-API: integrationCode
|
|
|
הערות
|
|
אופציונלי
|
|
שם השדה ב-API: notes
|
|
|
סטטוס הביקורת
|
|
קריאה בלבד
|
|
שם השדה ב-API: reviewStatus
|
|
Video Creative
| סוג הקריאייטיב: CREATIVE_TYPE_VIDEO |
| מקור האירוח: HOSTING_SOURCE_HOSTED |
|
שם
|
|
חובה
|
|
שם השדה ב-API: displayName
|
|
|
סטטוס
|
|
חובה
|
|
שם השדה ב-API: entityStatus
|
|
|
קובץ מקור
|
|
חובה
|
|
שם השדה ב-API: assets
|
|
תפקיד הנכס: ASSET_ROLE_MAIN
|
|
|
כתובת דף הנחיתה
|
|
חובה
|
|
שם השדה ב-API: exitEvents[].url
|
|
סוג אירוע היציאה: EXIT_EVENT_TYPE_DEFAULT
|
|
|
הכללת לחצן דילוג
|
|
אופציונלי
|
|
שם השדה ב-API: skippable
|
|
|
פרק זמן לפני אפשרות דילוג
|
|
אופציונלי
|
|
שם השדה ב-API: skipOffset
|
|
|
טווח זמן לפני חיוב
|
|
אופציונלי
|
|
שם השדה ב-API: progressOffset
|
|
|
מזהה מודעה אוניברסלי
|
|
אופציונלי
|
|
שם השדה ב-API: universalAdId
|
|
|
פרסום המבוסס על התנהגות המשתמשים אונליין
|
|
אופציונלי
|
|
שם השדה ב-API: obaIcon
|
|
|
נכסי קריאייטיב נלווים
|
|
אופציונלי
|
|
שם השדה ב-API: companionCreativeIds
|
|
|
קובץ להצגה
|
|
קריאה בלבד
|
|
שם השדה ב-API: transcodes
|
|
|
כתובות URL של צד שלישי
|
|
אופציונלי
|
|
שם השדה ב-API: thirdPartyUrls
|
|
|
קוד שילוב
|
|
אופציונלי
|
|
שם השדה ב-API: integrationCode
|
|
|
הערות
|
|
אופציונלי
|
|
שם השדה ב-API: notes
|
|
|
סטטוס הביקורת
|
|
קריאה בלבד
|
|
שם השדה ב-API: reviewStatus
|
|
קריאייטיב אודיו
| סוג הקריאייטיב: CREATIVE_TYPE_AUDIO |
| מקור האירוח: HOSTING_SOURCE_HOSTED |
|
שם
|
|
חובה
|
|
שם השדה ב-API: displayName
|
|
|
סטטוס
|
|
חובה
|
|
שם השדה ב-API: entityStatus
|
|
|
קובץ מקור
|
|
חובה
|
|
שם השדה ב-API: assets
|
|
תפקיד הנכס: ASSET_ROLE_MAIN
|
|
|
כתובת דף הנחיתה
|
|
חובה
|
|
שם השדה ב-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: notes
|
|
|
סטטוס הביקורת
|
|
קריאה בלבד
|
|
שם השדה ב-API: reviewStatus
|
|
קריאייטיב מותאם לרשת המדיה
| סוג קריאייטיב: CREATIVE_TYPE_NATIVE, CREATIVE_TYPE_NATIVE_SITE_SQUARE |
| מקור האירוח: HOSTING_SOURCE_HOSTED |
|
שם
|
|
חובה
|
|
שם השדה ב-API: displayName
|
|
|
status
|
|
חובה
|
|
שם השדה ב-API: entityStatus
|
|
|
לוגו
|
|
חובה
|
|
שם השדה ב-API: assets
|
|
תפקיד הנכס: ASSET_ROLE_ICON
|
|
|
תמונה / תמונה מרובעת
|
|
חובה
|
|
שם השדה ב-API: assets
|
|
תפקיד הנכס: ASSET_ROLE_MAIN
|
|
|
כותרת
|
|
חובה
|
|
שם השדה ב-API: assets
|
|
תפקיד הנכס: ASSET_ROLE_HEADLINE
|
|
|
כותרת ארוכה
|
|
אופציונלי
|
|
שם השדה ב-API: assets
|
|
תפקיד הנכס: ASSET_ROLE_LONG_HEADLINE
|
|
|
גוף הטקסט
|
|
חובה
|
|
שם השדה ב-API: assets
|
|
תפקיד נכס: ASSET_ROLE_BODY
|
|
|
טקסט ארוך בגוף המודעה
|
|
אופציונלי
|
|
שם השדה ב-API: assets
|
|
תפקיד הנכס: ASSET_ROLE_LONG_BODY
|
|
|
כתובת דף הנחיתה
|
|
חובה
|
|
שם השדה ב-API: exitEvents[].url
|
|
סוג אירוע היציאה: EXIT_EVENT_TYPE_DEFAULT
|
|
|
כתובת אתר של כתובית
|
|
חובה
|
|
שם השדה ב-API: assets
|
|
תפקיד נכס: ASSET_ROLE_CAPTION_URL
|
|
|
קריאה לפעולה
|
|
חובה
|
|
שם השדה ב-API: assets
|
|
תפקיד הנכס: ASSET_ROLE_CALL_TO_ACTION
|
|
|
מודעה למעקב ב-Campaign Manager 360
|
|
אופציונלי
|
|
שם השדה ב-API: cmTrackingAd
|
|
|
כתובת URL למעקב אחר חשיפות 1
|
|
אופציונלי
|
|
שם השדה ב-API: trackingUrls[]
|
|
|
כתובת URL למעקב אחר חשיפות 2
|
|
אופציונלי
|
|
שם השדה ב-API: trackingUrls[]
|
|
|
כתובת URL למעקב באמצעות JavaScript
|
|
אופציונלי
|
|
שם השדה ב-API: jsTrackerUrl
|
|
|
קוד שילוב
|
|
אופציונלי
|
|
שם השדה ב-API: integrationCode
|
|
|
הערות
|
|
אופציונלי
|
|
שם השדה ב-API: notes
|
|
|
סטטוס הביקורת
|
|
קריאה בלבד
|
|
שם השדה ב-API: reviewStatus
|
|
קריאייטיב של מודעת וידאו מותאמת
| סוג הקריאייטיב: CREATIVE_TYPE_NATIVE_VIDEO |
| מקור האירוח: HOSTING_SOURCE_HOSTED |
|
שם
|
|
חובה
|
|
שם השדה ב-API: displayName
|
|
|
סטטוס
|
|
חובה
|
|
שם השדה ב-API: entityStatus
|
|
|
לוגו
|
|
חובה
|
|
שם השדה ב-API: assets
|
|
תפקיד הנכס: ASSET_ROLE_ICON
|
|
|
וידאו
|
|
חובה
|
|
שם השדה ב-API: assets
|
|
תפקיד הנכס: ASSET_ROLE_MAIN
|
|
|
תמונת כריכה
|
|
חובה
|
|
שם השדה ב-API: assets
|
|
תפקיד הנכס: ASSET_ROLE_COVER_IMAGE
|
|
|
שם המפרסם
|
|
חובה
|
|
שם השדה ב-API: assets
|
|
תפקיד הנכס: ASSET_ROLE_ADVERTISER_NAME
|
|
|
כותרת
|
|
חובה
|
|
שם השדה ב-API: assets
|
|
תפקיד הנכס: ASSET_ROLE_HEADLINE
|
|
|
כותרת ארוכה
|
|
אופציונלי
|
|
שם השדה ב-API: assets
|
|
תפקיד הנכס: ASSET_ROLE_LONG_HEADLINE
|
|
|
גוף הטקסט
|
|
חובה
|
|
שם השדה ב-API: assets
|
|
תפקיד נכס: ASSET_ROLE_BODY
|
|
|
טקסט ארוך בגוף המודעה
|
|
אופציונלי
|
|
שם השדה ב-API: assets
|
|
תפקיד הנכס: ASSET_ROLE_LONG_BODY
|
|
|
כתובת דף הנחיתה
|
|
חובה
|
|
שם השדה ב-API: exitEvents[].url
|
|
סוג אירוע היציאה: EXIT_EVENT_TYPE_DEFAULT
|
|
|
כתובת אתר של כתובית
|
|
חובה
|
|
שם השדה ב-API: assets
|
|
תפקיד נכס: ASSET_ROLE_CAPTION_URL
|
|
|
קריאה לפעולה
|
|
חובה
|
|
שם השדה ב-API: assets
|
|
תפקיד הנכס: ASSET_ROLE_CALL_TO_ACTION
|
|
|
כתובת URL למעקב אחר חשיפות 1
|
|
אופציונלי
|
|
שם השדה ב-API: trackingUrls[]
|
|
|
כתובת URL למעקב אחר חשיפות 2
|
|
אופציונלי
|
|
שם השדה ב-API: trackingUrls[]
|
|
|
כתובת URL למעקב באמצעות JavaScript
|
|
אופציונלי
|
|
שם השדה ב-API: jsTrackerUrl
|
|
|
קוד שילוב
|
|
אופציונלי
|
|
שם השדה ב-API: integrationCode
|
|
|
הערות
|
|
אופציונלי
|
|
שם השדה ב-API: notes
|
|
|
סטטוס הביקורת
|
|
קריאה בלבד
|
|
שם השדה ב-API: reviewStatus
|
|
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[[["\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,[]]
