נספח: מיפוי שדות של ממשק המשתמש לשדות 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
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-04-09 (שעון 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."]]],[]]
