נספח: מיפוי שדות של ממשק המשתמש לשדות API לפי סוג הקריאייטיב
בטבלה הבאה מתבצע מיפוי של השדות בממשק המשתמש לשדות ה-API המתאימים, מופרדים לפי סוג הקריאייטיב. שימו לב שלחלק מהשדות ב-API נדרש מפרט נוסף באמצעות התפקיד או הסוג שהוקצו למשאב שסופק.
קריאייטיב תמונה רגילה
| סוג קריאייטיב: CREATIVE_TYPE_STANDARD |
| מקור אירוח: HOSTING_SOURCE_HOSTED |
|
שם
|
|
חובה
|
|
שם שדה ה-API: displayName
|
|
|
נכס של קריאייטיב
|
|
חובה
|
|
שם השדה ב-API: נכסים
|
|
תפקיד בנכס: ASSET_role_MAIN
|
|
|
כתובת דף הנחיתה
|
|
חובה
|
|
שם שדה ה-API: exitEvents[].url
|
|
יציאה מסוג האירוע: Exit_EVENT_TYPE_DEFAULT
|
|
|
סטטוס
|
|
חובה
|
|
שם שדה ה-API: entityStatus
|
|
|
תג מעקב HTML שנוסף
|
|
אופציונלי
|
|
שם שדה ה-API: appendedTag
|
|
|
קוד שילוב
|
|
אופציונלי
|
|
שם שדה API: IntegrationCode
|
|
|
הערות
|
|
אופציונלי
|
|
שם השדה ב-API: הערות
|
|
|
סטטוס הביקורת
|
|
קריאה בלבד
|
|
שם השדה API: reviewStatus
|
|
קריאייטיב ב-HTML5
| סוג קריאייטיב: CREATIVE_TYPE_STANDARD |
| מקור אירוח: HOSTING_SOURCE_HOSTED |
|
שם
|
|
חובה
|
|
שם שדה ה-API: displayName
|
|
|
נכס של קריאייטיב
|
|
חובה
|
|
שם השדה ב-API: נכסים
|
|
תפקיד בנכס: ASSET_role_MAIN
|
|
|
סטטוס
|
|
חובה
|
|
שם שדה ה-API: entityStatus
|
|
|
תמונות גיבוי
|
|
אופציונלי
|
|
שם השדה ב-API: נכסים
|
|
תפקיד בנכס: ASSET_role_BACKUP
|
|
|
כתובת דף הנחיתה לגיבוי
|
|
אופציונלי
|
|
שם שדה ה-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: CountEvents[]
|
|
|
טיימרים
|
|
אופציונלי
|
|
שם שדה ה-API: timerEvents[]
|
|
|
תג מעקב HTML שנוסף
|
|
אופציונלי
|
|
שם שדה ה-API: appendedTag
|
|
|
קוד שילוב
|
|
אופציונלי
|
|
שם שדה API: IntegrationCode
|
|
|
הערות
|
|
אופציונלי
|
|
שם השדה ב-API: הערות
|
|
|
סטטוס הביקורת
|
|
אופציונלי
|
|
שם השדה API: reviewStatus
|
|
קריאייטיב לתצוגה של צד שלישי
| סוג קריאייטיב: CREATIVE_TYPE_STANDARD |
| מקור אירוח: HOSTING_SOURCE_THIRD_PARTY |
|
שם
|
|
חובה
|
|
שם שדה ה-API: displayName
|
|
|
סטטוס
|
|
חובה
|
|
שם שדה ה-API: entityStatus
|
|
|
מאפיינים
|
|
חובה
|
|
מאפיינים של API Field Name
|
|
|
כתובת דף הנחיתה
|
|
חובה
|
|
שם שדה ה-API: exitEvents[].url
|
|
יציאה מסוג האירוע: Exit_EVENT_TYPE_DEFAULT
|
|
|
נדרש MRAID
|
|
אופציונלי
|
|
שם שדה API: requiredMraid
|
|
|
נדרש HTML5
|
|
אופציונלי
|
|
שם שדה ה-API: requiredHtml5
|
|
|
תג של צד שלישי
|
|
חובה
|
|
שם שדה ה-API: thirdPartyTag
|
|
|
נדרש פינג לציון שיוך (Attribution)
|
|
אופציונלי
|
|
שם שדה ה-API: requiredPingForAttribution
|
|
|
קוד שילוב
|
|
אופציונלי
|
|
שם שדה API: IntegrationCode
|
|
|
הערות
|
|
אופציונלי
|
|
שם השדה ב-API: הערות
|
|
|
סטטוס הביקורת
|
|
קריאה בלבד
|
|
שם השדה API: reviewStatus
|
|
קריאייטיב הניתן להרחבה של צד שלישי
| סוג קריאייטיב: CREATIVE_TYPE_expANDABLE |
| מקור אירוח: HOSTING_SOURCE_THIRD_PARTY |
|
שם
|
|
חובה
|
|
שם שדה ה-API: displayName
|
|
|
סטטוס
|
|
חובה
|
|
שם שדה ה-API: entityStatus
|
|
|
מאפיינים
|
|
חובה
|
|
מאפיינים של API Field Name
|
|
|
כתובת דף הנחיתה
|
|
חובה
|
|
שם שדה ה-API: exitEvents[].url
|
|
יציאה מסוג האירוע: Exit_EVENT_TYPE_DEFAULT
|
|
|
נדרש MRAID
|
|
אופציונלי
|
|
שם שדה API: requiredMraid
|
|
|
נדרש HTML5
|
|
אופציונלי
|
|
שם שדה ה-API: requiredHtml5
|
|
|
כיוון ההרחבה
|
|
חובה
|
|
שם שדה ה-API: expandDirection
|
|
|
הרחבה בהעברת העכבר
|
|
אופציונלי
|
|
שם שדה ה-API: expandOnHover
|
|
|
צד שלישי
|
|
חובה
|
|
שם שדה ה-API: thirdPartyTag
|
|
|
נדרש פינג לציון שיוך (Attribution)
|
|
אופציונלי
|
|
שם שדה ה-API: requiredPingForAttribution
|
|
|
קוד שילוב
|
|
אופציונלי
|
|
שם שדה API: IntegrationCode
|
|
|
הערות
|
|
אופציונלי
|
|
שם השדה ב-API: הערות
|
|
|
סטטוס הביקורת
|
|
קריאה בלבד
|
|
שם השדה API: reviewStatus
|
|
קריאייטיב וידאו של צד שלישי
| סוג קריאייטיב: CREATIVE_TYPE_VIDEO |
| מקור אירוח: HOSTING_SOURCE_THIRD_PARTY |
|
שם
|
|
חובה
|
|
שם שדה ה-API: displayName
|
|
|
סטטוס
|
|
חובה
|
|
שם שדה ה-API: entityStatus
|
|
|
כתובת URL של תג VAST
|
|
חובה
|
|
שם שדה ה-API: VASTTagUrl
|
|
|
VPAID
|
|
קריאה בלבד
|
|
שם שדה ה-API: vpaid
|
|
|
נגן סרטונים ב-HTML5
|
|
קריאה בלבד
|
|
שם שדה ה-API: html5Video
|
|
|
נדרש פינג לציון שיוך (Attribution)
|
|
אופציונלי
|
|
שם שדה ה-API: requiredPingForAttribution
|
|
|
קוד שילוב
|
|
אופציונלי
|
|
שם שדה API: IntegrationCode
|
|
|
הערות
|
|
אופציונלי
|
|
שם השדה ב-API: הערות
|
|
|
סטטוס הביקורת
|
|
קריאה בלבד
|
|
שם השדה API: reviewStatus
|
|
קריאייטיב אודיו של צד שלישי
| סוג קריאייטיב: CREATIVE_TYPE_AUDIO |
| מקור אירוח: HOSTING_SOURCE_THIRD_PARTY |
|
שם
|
|
חובה
|
|
שם שדה ה-API: displayName
|
|
|
סטטוס
|
|
חובה
|
|
שם שדה ה-API: entityStatus
|
|
|
כתובת URL של תג VAST
|
|
חובה
|
|
שם שדה ה-API: VASTTagUrl
|
|
|
נדרש פינג לציון שיוך (Attribution)
|
|
אופציונלי
|
|
שם שדה ה-API: requiredPingForAttribution
|
|
|
קוד שילוב
|
|
אופציונלי
|
|
שם שדה API: IntegrationCode
|
|
|
הערות
|
|
אופציונלי
|
|
שם השדה ב-API: הערות
|
|
|
סטטוס הביקורת
|
|
קריאה בלבד
|
|
שם השדה API: reviewStatus
|
|
קריאייטיב של וידאו
| סוג קריאייטיב: CREATIVE_TYPE_VIDEO |
| מקור אירוח: HOSTING_SOURCE_HOSTED |
|
שם
|
|
חובה
|
|
שם שדה ה-API: displayName
|
|
|
סטטוס
|
|
חובה
|
|
שם שדה ה-API: entityStatus
|
|
|
קובץ מקור
|
|
חובה
|
|
שם השדה ב-API: נכסים
|
|
תפקיד בנכס: ASSET_role_MAIN
|
|
|
כתובת דף הנחיתה
|
|
חובה
|
|
שם שדה ה-API: exitEvents[].url
|
|
יציאה מסוג האירוע: Exit_EVENT_TYPE_DEFAULT
|
|
|
הוספת לחצן דילוג
|
|
אופציונלי
|
|
שם שדה API: ניתן לדילוג
|
|
|
פרק זמן לפני אפשרות דילוג
|
|
אופציונלי
|
|
שם שדה ה- API: SkipOffset
|
|
|
טווח זמן לפני חיוב
|
|
אופציונלי
|
|
שם שדה ה-API: progressOffset
|
|
|
מזהה מודעה אוניברסלי
|
|
אופציונלי
|
|
שם שדה API: universalAdId
|
|
|
פרסום המבוסס על התנהגות המשתמשים אונליין
|
|
אופציונלי
|
|
שם שדה ה-API: obaIcon
|
|
|
קריאייטיבים נלווים
|
|
אופציונלי
|
|
שם שדה ה-API: ווהCreativeIds
|
|
|
קובץ הצגה
|
|
קריאה בלבד
|
|
שם שדה ה-API: קידוד שונה
|
|
|
כתובות URL של צד שלישי
|
|
אופציונלי
|
|
שם שדה ה-API: thirdPartyUrls
|
|
|
קוד שילוב
|
|
אופציונלי
|
|
שם שדה API: IntegrationCode
|
|
|
הערות
|
|
אופציונלי
|
|
שם השדה ב-API: הערות
|
|
|
סטטוס הביקורת
|
|
קריאה בלבד
|
|
שם השדה API: reviewStatus
|
|
קריאייטיב אודיו
| סוג קריאייטיב: CREATIVE_TYPE_AUDIO |
| מקור אירוח: HOSTING_SOURCE_HOSTED |
|
שם
|
|
חובה
|
|
שם שדה ה-API: displayName
|
|
|
סטטוס
|
|
חובה
|
|
שם שדה ה-API: entityStatus
|
|
|
קובץ מקור
|
|
חובה
|
|
שם השדה ב-API: נכסים
|
|
תפקיד בנכס: ASSET_role_MAIN
|
|
|
כתובת דף הנחיתה
|
|
חובה
|
|
שם שדה ה-API: exitEvents[].url
|
|
יציאה מסוג האירוע: Exit_EVENT_TYPE_DEFAULT
|
|
|
נכס נלווה (העלאה או הקצאה)
|
|
חובה
|
|
שם שדה ה-API: ווהCreativeIds
|
|
|
שם קובץ הצגה
|
|
קריאה בלבד
|
|
שם שדה ה-API: המרת קידוד[].name
|
|
|
סוג קובץ הצגה
|
|
קריאה בלבד
|
|
שם שדה ה-API: המרת קידודים[].mimeType
|
|
|
קצב העברת נתוני אודיו של קובץ מוצג
|
|
קריאה בלבד
|
|
שם שדה ה-API: קידודים[].audioBitRateKbps
|
|
|
תדירות דגימת האודיו של הקובץ שמוצג
|
|
קריאה בלבד
|
|
שם שדה ה-API: קידודים[].audioSampleRateHz
|
|
|
כתובות URL של צד שלישי
|
|
אופציונלי
|
|
שם שדה ה-API: thirdPartyUrls
|
|
|
קוד שילוב
|
|
אופציונלי
|
|
שם שדה API: IntegrationCode
|
|
|
הערות
|
|
אופציונלי
|
|
שם השדה ב-API: הערות
|
|
|
סטטוס הביקורת
|
|
קריאה בלבד
|
|
שם השדה API: reviewStatus
|
|
קריאייטיב מותאם לרשת המדיה
| סוג קריאייטיב: CREATIVE_TYPE_NATIVE, CREATIVE_TYPE_NATIVE_SITE_SQUARE |
| מקור אירוח: HOSTING_SOURCE_HOSTED |
|
שם
|
|
חובה
|
|
שם שדה ה-API: displayName
|
|
|
status
|
|
חובה
|
|
שם שדה ה-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
|
|
|
כתובת דף הנחיתה
|
|
חובה
|
|
שם שדה ה-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 למעקב ב-JavaScript
|
|
אופציונלי
|
|
שם שדה ה-API: jsSearchUrl
|
|
|
קוד שילוב
|
|
אופציונלי
|
|
שם שדה API: IntegrationCode
|
|
|
הערות
|
|
אופציונלי
|
|
שם השדה ב-API: הערות
|
|
|
סטטוס הביקורת
|
|
קריאה בלבד
|
|
שם השדה API: reviewStatus
|
|
קריאייטיב וידאו מקורי
| סוג קריאייטיב: 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
|
|
|
כתובת דף הנחיתה
|
|
חובה
|
|
שם שדה ה-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 למעקב ב-JavaScript
|
|
אופציונלי
|
|
שם שדה ה-API: jsSearchUrl
|
|
|
קוד שילוב
|
|
אופציונלי
|
|
שם שדה API: IntegrationCode
|
|
|
הערות
|
|
אופציונלי
|
|
שם השדה ב-API: הערות
|
|
|
סטטוס הביקורת
|
|
קריאה בלבד
|
|
שם השדה API: reviewStatus
|
|
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2023-12-01 (שעון UTC).
[null,null,["עדכון אחרון: 2023-12-01 (שעון UTC)."],[[["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."]]],[]]
