נספח: מיפוי שדות של ממשק המשתמש לשדות 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