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