- משאב: קריאייטיב
- HostingSource
- CreativeAttribute
- ReviewStatusInfo
- ApprovalStatus
- ReviewStatus
- ExchangeReviewStatus
- PublisherReviewStatus
- AssetAssociation
- נכס
- AssetRole
- ExitEvent
- ExitEventType
- TimerEvent
- CounterEvent
- AudioVideoOffset
- UniversalAdId
- UniversalAdRegistry
- ThirdPartyUrl
- ThirdPartyUrlType
- המרת קודים
- CmTrackingAd
- ObaIcon
- ObaIconPosition
- ExpandingDirection
- שיטות
משאב: קריאייטיב
נכס קריאייטיב יחיד.
ייצוג ב-JSON |
---|
{ "name": string, "advertiserId": string, "creativeId": string, "cmPlacementId": string, "displayName": string, "entityStatus": enum ( |
שדות | |
---|---|
name |
פלט בלבד. שם המשאב של הקריאייטיב. |
advertiserId |
פלט בלבד. המזהה הייחודי של המפרסם שהקריאייטיב שייך אליו. |
creativeId |
פלט בלבד. המזהה הייחודי של הקריאייטיב. המערכת מקצה את השם. |
cmPlacementId |
פלט בלבד. המזהה הייחודי של מיקום המודעה ב-Campaign Manager 360 שמשויך לקריאייטיב. השדה הזה רלוונטי רק לנכסי קריאייטיב שמסונכרנים מ-Campaign Manager. |
displayName |
חובה. שם התצוגה של הקריאייטיב. הקידוד חייב להיות UTF-8 והגודל המקסימלי הוא 240 בייטים. |
entityStatus |
חובה. המדיניות הזו קובעת אם הקריאייטיב יוצג או לא. הערכים הקבילים הם:
|
updateTime |
פלט בלבד. חותמת הזמן של מועד העדכון האחרון של הקריאייטיב, על ידי המשתמש או המערכת (למשל, בדיקת קריאייטיב). המערכת מקצה את השם. הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: |
createTime |
פלט בלבד. חותמת הזמן של יצירת הקריאייטיב. המערכת מקצה את השם. הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: |
creativeType |
חובה. לא ניתן לשינוי. סוג הקריאייטיב. |
hostingSource |
חובה. מציין איפה הקריאייטיב מתארח. |
dynamic |
פלט בלבד. מציין אם הקריאייטיב הוא דינמי. |
dimensions |
חובה. המאפיינים הראשיים של הקריאייטיב. רלוונטי לכל סוגי הקריאייטיב. הערך של
|
additionalDimensions[] |
זה שינוי אופציונלי. מאפיינים נוספים. רלוונטי כאשר
אם מציינים את השדה הזה, צריך לציין גם את |
mediaDuration |
פלט בלבד. משך הזמן של הקריאייטיב. רלוונטי כאשר
משך הזמן בשניות, עם עד תשע ספרות עשרוניות, שמסתיימים ב-' |
creativeAttributes[] |
פלט בלבד. רשימה של מאפייני הקריאייטיב שנוצרים על ידי המערכת. |
reviewStatus |
פלט בלבד. הסטטוס הנוכחי של תהליך בדיקת הקריאייטיב. |
assets[] |
חובה. הנכסים שמשויכים לנכס הקריאייטיב הזה. |
exitEvents[] |
חובה. אירועי יציאה מנכס הקריאייטיב הזה. יציאה (שנקראת גם תג קליק) היא כל אזור בקריאייטיב שמישהו יכול ללחוץ או להקיש עליו כדי לפתוח את דף הנחיתה של המפרסם. כל קריאייטיב חייב לכלול לפחות אירוע יציאה אחד. אפשר להוסיף אירוע יציאה לקריאייטיב באחת מהדרכים הבאות:
|
timerEvents[] |
זה שינוי אופציונלי. אירועים מותאמים אישית של טיימר לקריאייטיב של מדיה עשירה. שעונים עוקבים אחרי הזמן שבו משתמש צופה בחלק מסוים בקריאייטיב של מדיה עשירה ומקיים איתו אינטראקציה. לכל קריאייטיב יכולים להיות כמה אירועי טיימר, שכל אחד מהם מוגדר בנפרד. משאירים אותו ריק או לא מגדירים אותו בקריאייטיבים שמכילים נכסי תמונות בלבד. |
counterEvents[] |
זה שינוי אופציונלי. אירועי מונה לקריאייטיב מסוג מדיה עשירה. ספירות עוקבות אחרי מספר הפעמים שמשתמש מבצע אינטראקציה עם חלק כלשהו בקריאייטיב של מדיה עשירה באופן מסוים (העברת העכבר מעל, הוצאת העכבר מעל, קליקים, הקשות, טעינת נתונים, הקלדות במקלדת וכו'). אפשר לתעד כמספר כל אירוע שאפשר לתעד בנכס הקריאייטיב. משאירים אותו ריק או לא מגדירים אותו בקריאייטיבים שמכילים נכסי תמונות בלבד. |
appendedTag |
זה שינוי אופציונלי. תג מעקב HTML של צד שלישי שצריך לצרף לתג הקריאייטיב. |
integrationCode |
זה שינוי אופציונלי. פרטי מזהה המשמשים לקישור הקריאייטיב הזה למערכת חיצונית. חייב להיות מקודד ב-UTF-8 באורך של עד 10,000 תווים. |
notes |
זה שינוי אופציונלי. הערות של משתמשים לגבי נכס הקריאייטיב הזה. חייב להיות מקודד ב-UTF-8 באורך של עד 20,000 תווים. |
iasCampaignMonitoring |
זה שינוי אופציונלי. מציין אם מעקב הקמפיינים של Integral Ad Science (IAS) מופעל. כדי להפעיל את התכונה הזו בנכס הקריאייטיב, צריך לוודא שהשדה |
companionCreativeIds[] |
זה שינוי אופציונלי. המזהים של נכסי הקריאייטיב הנלווים לקריאייטיב של הווידאו. אתם יכולים להקצות נכסי קריאייטיב קיימים לרשת המדיה (עם תמונות או נכסי HTML5) כדי שיוצגו מסביב לנגן הווידאו של בעל התוכן הדיגיטלי. החברים הווירטואליים מוצגים סביב נגן הווידאו בזמן שהסרטון פועל, והם נשארים גם אחרי שהסרטון מסתיים. קריאייטיבים שמכילים את השדה הזה נתמך רק ב-
|
skippable |
זה שינוי אופציונלי. אם המשתמש יכול לבחור לדלג על קריאייטיב של וידאו. השדה הזה נתמך רק ב-
|
skipOffset |
זה שינוי אופציונלי. משך הזמן שבו הסרטון יופעל לפני שיופיע לחצן הדילוג. השדה הזה נדרש כשהערך של השדה הזה נתמך רק ב-
|
progressOffset |
זה שינוי אופציונלי. משך הזמן שבו צריך להפעיל את הסרטון לפני שמספרים צפייה. השדה הזה נדרש כשהערך של השדה הזה נתמך רק ב-
|
universalAdId |
זה שינוי אופציונלי. מזהה קריאייטיב אופציונלי שמסופק על ידי מאגר, והוא ייחודי בכל הפלטפורמות. Universal Ad ID הוא חלק מהסטנדרט VAST 4.0. אפשר לשנות אותו אחרי יצירת הקריאייטיב. השדה הזה נתמך רק ב-
|
thirdPartyUrls[] |
זה שינוי אופציונלי. מעקב אחר כתובות URL של צדדים שלישיים כדי לעקוב אחר אינטראקציות עם נכס קריאייטיב מסוג וידאו. השדה הזה נתמך רק ב-
|
transcodes[] |
פלט בלבד. קובצי אודיו/וידאו שעברו המרה. מערכת Display & Video 360 מבצעת המרה של הנכס הראשי למספר גרסאות חלופיות שמשתמשות בפורמטים שונים של קבצים או שיש להן מאפיינים שונים (רזולוציה, קצב ביט של אודיו וקצב ביט של וידאו), כאשר כל גרסה מיועדת לנגני וידאו או לרוחב פס ספציפיים. ההמרות האלה מאפשרות למערכת של בעל התוכן הדיגיטלי לבחור מבין יותר אפשרויות לכל חשיפת מודעה בסרטון, ומבטיחות שהקובץ המתאים יוצג בהתאם לחיבור ולגודל המסך של הצופה. השדה הזה נתמך רק ב-
|
trackerUrls[] |
זה שינוי אופציונלי. כתובות URL למעקב של ספקי ניתוח נתונים או ספקי צד שלישי של טכנולוגיות פרסום. כתובות ה-URL חייבות להתחיל ב- כתובות URL רגילות בלבד, ללא תגי IMG או SCRIPT. אפשר לכתוב בשדה הזה רק ב-
|
jsTrackerUrl |
זה שינוי אופציונלי. כתובת URL למדידת JavaScript מספקי אימות נתמכים של צד שלישי (ComScore, DoubleVerify, IAS, Moat). אין תמיכה בתגי סקריפט של HTML. אפשר לכתוב בשדה הזה רק ב-
|
cmTrackingAd |
זה שינוי אופציונלי. מודעת המעקב ב-Campaign Manager 360 שמשויכת לקריאייטיב.
פלט רק במקרים אחרים. |
obaIcon |
זה שינוי אופציונלי. מציין את סמל OBA בקריאייטיב של סרטון. השדה הזה נתמך רק ב-
|
thirdPartyTag |
זה שינוי אופציונלי. התג המקורי של הצד השלישי ששימש לקריאייטיב. חובה ותוקף רק לנכסי קריאייטיב עם תגים של צד שלישי. קריאייטיבים עם תגים של צד שלישי הם קריאייטיבים עם
בשילוב עם
|
requireMraid |
זה שינוי אופציונלי. הקריאייטיב מחייב MRAID (מערכת של הגדרות ממשק בין מודעות Rich Media לנייד). מגדירים את הערך הזה אם הקריאייטיב מסתמך על תנועות בנייד לצורך אינטראקטיביות, כמו החלקה או הקשה. האפשרות הזו היא אופציונלית ותוקפה חל רק על נכסי קריאייטיב עם תגים של צד שלישי. קריאייטיבים עם תגים של צד שלישי הם קריאייטיבים עם
בשילוב עם
|
requireHtml5 |
זה שינוי אופציונלי. מציין שהקריאייטיב מסתמך על HTML5 כדי להציג את המודעות בצורה תקינה. האפשרות הזו היא אופציונלית ותוקפה חל רק על נכסי קריאייטיב עם תגים של צד שלישי. קריאייטיבים עם תגים של צד שלישי הם קריאייטיבים עם
בשילוב עם
|
requirePingForAttribution |
זה שינוי אופציונלי. הקריאייטיב ימתין לקבלת פינג חוזר לצורך שיוך. התג תקף רק כשמשתמשים במודעת מעקב של Campaign Manager 360 עם פרמטר של שרת מודעות של צד שלישי והמאקרו ${DC_DBM_TOKEN}. אופציונלי ותקף רק לקריאייטיבים עם תגים של צד שלישי או לקריאייטיבים עם תגי VAST של צד שלישי. קריאייטיבים עם תגים של צד שלישי הם קריאייטיבים עם
בשילוב עם
קריאייטיבים עם תגי VAST של צד שלישי הם קריאייטיבים עם
בשילוב עם
|
expandingDirection |
זה שינוי אופציונלי. מציין את כיוון ההרחבה של הקריאייטיב. חובה ותוקף רק לנכסי קריאייטיב נפתחים של צד שלישי. קריאייטיבים נרחבים של צד שלישי הם קריאייטיבים עם מקור האירוח הבא:
בשילוב עם
|
expandOnHover |
זה שינוי אופציונלי. האפשרות הזו מציינת שהקריאייטיב יתרחב באופן אוטומטי כאשר יהיה מרחף מעליו. אופציונלי ותקף רק לנכסי קריאייטיב נפתחים של צד שלישי. קריאייטיבים נרחבים של צד שלישי הם קריאייטיבים עם מקור האירוח הבא:
בשילוב עם
|
vastTagUrl |
זה שינוי אופציונלי. כתובת ה-URL של תג ה-VAST בקריאייטיב של תג VAST של צד שלישי. חובה ותוקף רק לנכסי קריאייטיב עם תגי VAST של צד שלישי. קריאייטיבים עם תגי VAST של צד שלישי הם קריאייטיבים עם
בשילוב עם
|
vpaid |
פלט בלבד. מציין שהקריאייטיב של תג ה-VAST של הצד השלישי מחייב VPAID (ממשק בין מודעות לבין נגן וידאו דיגיטלי). פלט בלבד, ותקף רק לנכסי קריאייטיב עם תגי VAST של צד שלישי. קריאייטיבים עם תגי VAST של צד שלישי הם קריאייטיבים עם
בשילוב עם
|
html5Video |
פלט בלבד. הקריאייטיב של תג ה-VAST של הצד השלישי מחייב תמיכה בסרטוני HTML5. פלט בלבד, ותקף רק לנכסי קריאייטיב עם תגי VAST של צד שלישי. קריאייטיבים עם תגי VAST של צד שלישי הם קריאייטיבים עם
בשילוב עם
|
lineItemIds[] |
פלט בלבד. המזהים של הפריטים שקריאייטיב הזה משויך אליהם. כדי לשייך קריאייטיב לפריט, משתמשים במקום זאת ב- |
mp3Audio |
פלט בלבד. מציין שהקריאייטיב של האודיו של הצד השלישי תומך בפורמט MP3. פלט בלבד, ותקף רק לנכסי קריאייטיב של אודיו של צד שלישי. קריאייטיבים של אודיו של צד שלישי הם קריאייטיבים עם
בשילוב עם
|
oggAudio |
פלט בלבד. מציין שהקריאייטיב האודיו של הצד השלישי תומך בפורמט OGG. פלט בלבד, ותקף רק לנכסי קריאייטיב של אודיו של צד שלישי. קריאייטיבים של אודיו של צד שלישי הם קריאייטיבים עם
בשילוב עם
|
HostingSource
מקורות אירוח אפשריים של נכס קריאייטיב. מציין איפה הקריאייטיב נוצר ומתארח.
טיפוסים בני מנייה (enum) | |
---|---|
HOSTING_SOURCE_UNSPECIFIED |
המקור לאירוח לא צוין או שהוא לא ידוע בגרסת ה-API הזו. |
HOSTING_SOURCE_CM |
קריאייטיב שסונכרן מ-Campaign Manager 360. אין תמיכה בשיטות יצירה ועדכון בסוג אירוח זה. |
HOSTING_SOURCE_THIRD_PARTY |
קריאייטיב שמתארח בשרת מודעות של צד שלישי (3PAS). שיטות היצירה והעדכון נתמכות בסוג אירוח זה אם הערך של
|
HOSTING_SOURCE_HOSTED |
קריאייטיב שנוצר ב-DV360 ומתארח ב-Campaign Manager 360. שיטות היצירה והעדכון נתמכות בסוג אירוח זה אם הערך של
|
HOSTING_SOURCE_RICH_MEDIA |
קריאייטיב של מדיה עשירה שנוצר ב-Studio ומתארח ב-Campaign Manager 360. אין תמיכה בשיטות יצירה ועדכון בסוג אירוח זה. |
CreativeAttribute
מאפיינים אפשריים של נכס קריאייטיב.
טיפוסים בני מנייה (enum) | |
---|---|
CREATIVE_ATTRIBUTE_UNSPECIFIED |
מאפיין הקריאייטיב לא צוין או שהוא לא ידוע בגרסה הזו. |
CREATIVE_ATTRIBUTE_VAST |
הקריאייטיב הוא קריאייטיב VAST. |
CREATIVE_ATTRIBUTE_VPAID_LINEAR |
הקריאייטיב הוא קריאייטיב VPAID ליניארי. |
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR |
הקריאייטיב הוא קריאייטיב VPAID לא ליניארי. |
ReviewStatusInfo
בודקים את הסטטוסים של נכסי הקריאייטיב.
ייצוג ב-JSON |
---|
{ "approvalStatus": enum ( |
שדות | |
---|---|
approvalStatus |
מייצג את האישור הבסיסי שנחוץ כדי שהקריאייטיב יתחיל להופיע. סיכום של |
creativeAndLandingPageReviewStatus |
סטטוס הבדיקה של הקריאייטיב ודף הנחיתה של הקריאייטיב. |
contentAndPolicyReviewStatus |
סטטוס בדיקת התוכן והמדיניות של הקריאייטיב. |
exchangeReviewStatuses[] |
הסטטוסים של בדיקת הקריאייטיב על ידי פלטפורמת ה-Exchange. |
publisherReviewStatuses[] |
הסטטוסים של בדיקת הקריאייטיב על ידי בעלי התוכן הדיגיטלי. |
סטטוס אישור
סוגי הסטטוסים האפשריים של אישור. זהו הסיכום של creativeAndLandingPageReviewStatus
ו-contentAndPolicyReviewStatus
.
טיפוסים בני מנייה (enum) | |
---|---|
APPROVAL_STATUS_UNSPECIFIED |
ערך הטיפוס לא צוין או שהוא לא ידוע בגרסה הזו. |
APPROVAL_STATUS_PENDING_NOT_SERVABLE |
הקריאייטיב עדיין בבדיקה ולא ניתן להציג אותו. |
APPROVAL_STATUS_PENDING_SERVABLE |
הקריאייטיב עבר בדיקה של הקריאייטיב ודף הנחיתה והוא מוכן להצגה, אבל הוא בהמתנה לבדיקת תוכן נוספת ובדיקת תאימות למדיניות. |
APPROVAL_STATUS_APPROVED_SERVABLE |
גם הבדיקה של הקריאייטיב ודף הנחיתה וגם הבדיקה של התוכן ותאימות המדיניות אושרו. הקריאייטיב ניתן להצגה. |
APPROVAL_STATUS_REJECTED_NOT_SERVABLE |
יש בעיה בקריאייטיב שצריך לתקן לפני שהוא יוצג. |
ReviewStatus
סוגי הסטטוסים האפשריים של ביקורות.
טיפוסים בני מנייה (enum) | |
---|---|
REVIEW_STATUS_UNSPECIFIED |
ערך הטיפוס לא צוין או שהוא לא ידוע בגרסה הזו. |
REVIEW_STATUS_APPROVED |
הקריאייטיב אושר. |
REVIEW_STATUS_REJECTED |
הקריאייטיב נדחה. |
REVIEW_STATUS_PENDING |
הקריאייטיב נמצא בהמתנה לבדיקה. |
ExchangeReviewStatus
סטטוס הבדיקה של פלטפורמת ה-Exchange לגבי הקריאייטיב.
ייצוג ב-JSON |
---|
{ "exchange": enum ( |
שדות | |
---|---|
exchange |
פלטפורמת ה-Exchange שבה הקריאייטיב נבדק. |
status |
הסטטוס של בדיקת ההחלפה. |
PublisherReviewStatus
סטטוס הבדיקה של בעלי התוכן הדיגיטלי לגבי הקריאייטיב.
ייצוג ב-JSON |
---|
{
"publisherName": string,
"status": enum ( |
שדות | |
---|---|
publisherName |
בעל התוכן הדיגיטלי שבודק את הקריאייטיב. |
status |
הסטטוס של בדיקת בעל התוכן הדיגיטלי. |
AssetAssociation
שיוך הנכס לקריאייטיב.
ייצוג ב-JSON |
---|
{ "asset": { object ( |
שדות | |
---|---|
asset |
זה שינוי אופציונלי. הנכס המשויך. |
role |
זה שינוי אופציונלי. התפקיד של הנכס הזה בקריאייטיב. |
נכס
נכס יחיד.
ייצוג ב-JSON |
---|
{ "mediaId": string, "content": string } |
שדות | |
---|---|
mediaId |
מזהה המדיה של הנכס שהועלו. זהו מזהה ייחודי של הנכס. אפשר להעביר את המזהה הזה לקריאות API אחרות, למשל המרחב של מזהה המדיה עודכן ב-5 באפריל 2023. עדכון מזהי המדיה שנשמרו במטמון לפני 5 באפריל 2023: מאחזרים את מזהה המדיה החדש ממשאבי הקריאייטיב המשויכים או מעלים מחדש את הנכס. |
content |
תוכן הנכס. בנכסים שהועלו, התוכן הוא נתיב ההצגה. |
AssetRole
התפקיד של הנכס הזה בקריאייטיב.
טיפוסים בני מנייה (enum) | |
---|---|
ASSET_ROLE_UNSPECIFIED |
התפקיד של הנכס לא צוין או שהוא לא ידוע בגרסת ה-API הזו. |
ASSET_ROLE_MAIN |
הנכס הוא הנכס הראשי של הקריאייטיב. |
ASSET_ROLE_BACKUP |
הנכס הוא נכס גיבוי של הקריאייטיב. |
ASSET_ROLE_POLITE_LOAD |
הנכס הוא נכס טעינה מנומס של הקריאייטיב. |
ASSET_ROLE_HEADLINE |
הכותרת של נכס קריאייטיב מותאם. השדה התפקיד הזה נתמך רק ב-
|
ASSET_ROLE_LONG_HEADLINE |
כותרת ארוכה של קריאייטיב מותאם. השדה התפקיד הזה נתמך רק ב-
|
ASSET_ROLE_BODY |
הטקסט של קריאייטיב מותאם. השדה התפקיד הזה נתמך רק ב-
|
ASSET_ROLE_LONG_BODY |
טקסט ארוך בגוף המודעה של קריאייטיב מותאם. השדה התפקיד הזה נתמך רק ב-
|
ASSET_ROLE_CAPTION_URL |
גרסה קצרה ונוחה של כתובת דף הנחיתה שמוצגת בקריאייטיב. כתובת ה-URL הזו מספקת לאנשים מושג לגבי הדף שאליו הם יגיעו אחרי שילחצו על הקריאייטיב. השדה לדוגמה, אם כתובת דף הנחיתה היא 'http://www.example.com/page', כתובת ה-URL של הכותרת יכולה להיות 'example.com'. הפרוטוקול (http://) הוא אופציונלי, אבל כתובת ה-URL לא יכולה להכיל רווחים או תווים מיוחדים. התפקיד הזה נתמך רק ב-
|
ASSET_ROLE_CALL_TO_ACTION |
הטקסט שישמש בלחצן הקריאה לפעולה של נכס קריאייטיב מותאם. השדה התפקיד הזה נתמך רק ב-
|
ASSET_ROLE_ADVERTISER_NAME |
הטקסט שמזהה את שם המפרסם או המותג. השדה התפקיד הזה נתמך רק ב-
|
ASSET_ROLE_PRICE |
מחיר הרכישה של האפליקציה בחנות Google Play או ב-App Store ל-iOS (לדוגמה, 5.99$). חשוב לזכור שהערך הזה לא מסתנכרן באופן אוטומטי עם הערך בפועל שמופיע בחנות. הוא תמיד יהיה זה שסיפקתם כששמרתם את הקריאייטיב. השדה הנכסים של התפקיד הזה מוגדרים לקריאה בלבד. |
ASSET_ROLE_ANDROID_APP_ID |
המזהה של אפליקציה ל-Android בחנות Google Play. המזהה הזה מופיע בכתובת ה-URL של האפליקציה בחנות Google Play אחרי 'id'. לדוגמה, ב- הנכסים של התפקיד הזה מוגדרים לקריאה בלבד. |
ASSET_ROLE_IOS_APP_ID |
המזהה של אפליקציה ל-iOS בחנות האפליקציות של Apple. מספר המזהה הזה מופיע בכתובת ה-URL של האפליקציה ב-Apple App Store כמחרוזת המספרים שמופיעה ישירות אחרי 'id'. לדוגמה, ב- הנכסים של התפקיד הזה מוגדרים לקריאה בלבד. |
ASSET_ROLE_RATING |
הדירוג של אפליקציה בחנות Google Play או בחנות האפליקציות של iOS. חשוב לזכור שהערך הזה לא מסתנכרן באופן אוטומטי עם הדירוג בפועל בחנות. הוא תמיד יהיה זה שסיפקתם כששמרתם את הקריאייטיב. הנכסים של התפקיד הזה מוגדרים לקריאה בלבד. |
ASSET_ROLE_ICON |
הסמל של הקריאייטיב. התפקיד הזה נתמך ונחוץ רק ב-
|
ASSET_ROLE_COVER_IMAGE |
תמונת השער של קריאייטיב של וידאו מותאם. התפקיד הזה נתמך ונחוץ רק ב-
|
ASSET_ROLE_BACKGROUND_COLOR |
הצבע הראשי לשימוש בקריאייטיב. התפקיד הזה נתמך ונחוץ רק ב-
|
ASSET_ROLE_ACCENT_COLOR |
הצבע המשני לשימוש בקריאייטיב. התפקיד הזה נתמך ונחוץ רק ב-
|
ASSET_ROLE_REQUIRE_LOGO |
אם בקריאייטיב חייב להופיע נכס לוגו. התפקיד הזה נתמך ונחוץ רק ב-
|
ASSET_ROLE_REQUIRE_IMAGE |
האם בקריאייטיב חייב להופיע נכס תמונה. התפקיד הזה נתמך ונחוץ רק ב-
|
ASSET_ROLE_ENABLE_ASSET_ENHANCEMENTS |
אם אפשר להחיל שיפורי נכסים על הקריאייטיב. התפקיד הזה נתמך ונחוץ רק ב-
|
ExitEvent
אירוע יציאה מהקריאייטיב.
ייצוג ב-JSON |
---|
{
"type": enum ( |
שדות | |
---|---|
type |
חובה. סוג אירוע היציאה. |
url |
חובה. כתובת היעד של הקליק באירוע היציאה. צריך לציין את הערך הזה כשהערך של
|
name |
זה שינוי אופציונלי. השם של תג הקליק של אירוע היציאה. השם חייב להיות ייחודי בתוך קריאייטיב אחד. משאירים אותו ריק או לא מגדירים אותו בקריאייטיבים שמכילים נכסי תמונות בלבד. |
reportingName |
זה שינוי אופציונלי. השם שמשמש לזיהוי האירוע הזה בדוחות. משאירים אותו ריק או לא מגדירים אותו בקריאייטיבים שמכילים נכסי תמונות בלבד. |
ExitEventType
סוג אירוע היציאה.
טיפוסים בני מנייה (enum) | |
---|---|
EXIT_EVENT_TYPE_UNSPECIFIED |
סוג האירוע 'יציאה' לא צוין או שהוא לא ידוע בגרסה הזו. |
EXIT_EVENT_TYPE_DEFAULT |
אירוע היציאה הוא אירוע ברירת המחדל. |
EXIT_EVENT_TYPE_BACKUP |
אירוע היציאה הוא אירוע יציאה לגיבוי. יכולים להיות כמה אירועי יציאה לגיבוי בקריאייטיב. |
TimerEvent
אירוע הטיימר של הקריאייטיב.
ייצוג ב-JSON |
---|
{ "name": string, "reportingName": string } |
שדות | |
---|---|
name |
חובה. השם של אירוע הטיימר. |
reportingName |
חובה. השם שמשמש לזיהוי אירוע הטיימר הזה בדוחות. |
CounterEvent
אירוע נגד של הקריאייטיב.
ייצוג ב-JSON |
---|
{ "name": string, "reportingName": string } |
שדות | |
---|---|
name |
חובה. השם של אירוע המונה. |
reportingName |
חובה. השם שמשמש לזיהוי אירוע המונה הזה בדוחות. |
AudioVideoOffset
משך הזמן שבו אודיו או סרטון הופעלו.
ייצוג ב-JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה האיחוד offset . הערך של ההיסט. הערך של offset יכול להיות רק אחת מהאפשרויות הבאות: |
|
percentage |
זה שינוי אופציונלי. ההיסט באחוזים מתוך משך הזמן של האודיו או הסרטון. |
seconds |
זה שינוי אופציונלי. הסטייה בשניות מתחילת האודיו או הווידאו. |
UniversalAdId
מזהה קריאייטיב שמסופק על ידי מאגר, והוא ייחודי בכל הפלטפורמות. התכונה הזו היא חלק מתקן VAST 4.0.
ייצוג ב-JSON |
---|
{
"id": string,
"registry": enum ( |
שדות | |
---|---|
id |
זה שינוי אופציונלי. המזהה הייחודי של הקריאייטיב. |
registry |
זה שינוי אופציונלי. במרשם מוצגים מזהי קריאייטיב ייחודיים. |
UniversalAdRegistry
במרשם מוצגים מזהים ייחודיים של נכסי קריאייטיב במזהה מודעה אוניברסלי.
טיפוסים בני מנייה (enum) | |
---|---|
UNIVERSAL_AD_REGISTRY_UNSPECIFIED |
לא צוין או לא ידוע במהדורה הזו מהו המרשם של מודעות Universal. |
UNIVERSAL_AD_REGISTRY_OTHER |
משתמשים בספק מותאם אישית כדי לספק את Universal Ad ID. |
UNIVERSAL_AD_REGISTRY_AD_ID |
משתמשים ב-Ad-ID כדי לספק את מזהה המודעה האוניברסלי. |
UNIVERSAL_AD_REGISTRY_CLEARCAST |
צריך להשתמש ב-clearcast.co.uk כדי לספק את Universal Ad ID. |
UNIVERSAL_AD_REGISTRY_DV360 |
משתמשים ב-Display & Video 360 כדי לספק את מזהה המודעה האוניברסלי. |
UNIVERSAL_AD_REGISTRY_CM |
משתמשים ב-Campaign Manager 360 כדי לספק את Universal Ad ID. |
ThirdPartyUrl
מעקב אחר כתובות URL של צדדים שלישיים כדי לעקוב אחר אינטראקציות עם קריאייטיב של אודיו או וידאו.
ייצוג ב-JSON |
---|
{
"type": enum ( |
שדות | |
---|---|
type |
זה שינוי אופציונלי. צריך לעקוב אחרי סוג האינטראקציה באמצעות כתובת ה-URL למעקב |
url |
זה שינוי אופציונלי. כתובת ה-URL למעקב שמשמשת למעקב אחרי האינטראקציה. מציינים כתובת URL עם נתיב אופציונלי או מחרוזת שאילתה, שמתחילים ב- |
ThirdPartyUrlType
צריך לעקוב אחרי סוג האינטראקציה באמצעות כתובת ה-URL למעקב של הצד השלישי.
טיפוסים בני מנייה (enum) | |
---|---|
THIRD_PARTY_URL_TYPE_UNSPECIFIED |
הסוג של כתובת ה-URL של הצד השלישי לא צוין או לא ידוע בגרסה הזו. |
THIRD_PARTY_URL_TYPE_IMPRESSION |
משמש לספירת החשיפות של הקריאייטיב אחרי שהאחסון במטמון של האודיו או הווידאו הושלם. |
THIRD_PARTY_URL_TYPE_CLICK_TRACKING |
משמש למעקב אחר קליקים של משתמשים על האודיו או הסרטון. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START |
משמש למעקב אחרי מספר הפעמים שמשתמש מפעיל את האודיו או הווידאו. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE |
משמש למעקב אחרי מספר הפעמים שהאודיו או הווידאו הופעלו עד להצגה של 25% ממנו. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT |
משמש למעקב אחרי מספר הפעמים שהאודיו או הווידאו הופעלו עד 50% מאורכם. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE |
משמש למעקב אחרי מספר הפעמים שהאודיו או הווידאו הופעלו עד להצגה של 75% ממנו. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_COMPLETE |
משמש למעקב אחרי מספר הפעמים שהאודיו או הסרטון הושמעו עד הסוף. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE |
משמש למעקב אחרי מספר הפעמים שמשתמש משבית את האודיו או הווידאו. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PAUSE |
משמש למעקב אחרי מספר הפעמים שמשתמש השהה את האודיו או את הסרטון. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND |
משמש למעקב אחרי מספר הפעמים שמשתמש מפעיל מחדש את האודיו או את הסרטון. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN |
משמש למעקב אחרי מספר הפעמים שמשתמש מרחיב את הנגן לגודל מסך מלא. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP |
משמש למעקב אחרי מספר הפעמים שמשתמש עוצר את האודיו או הווידאו. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM |
משמש למעקב אחרי מספר הפעמים שמשתמש מבצע קליק בהתאמה אישית, למשל לחיצה על נקודה חמה בסרטון. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_SKIP |
המאפיין הזה משמש למעקב אחרי מספר הפעמים שבהן האודיו או הסרטון הועברו. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS |
משמש למעקב אחרי מספר הפעמים שהאודיו או הווידאו הופעלו, לפי עיכוב שנקבע על ידי progressOffset . |
המרת קידוד
מייצג מידע על קובץ האודיו או הווידאו שעברו המרה.
ייצוג ב-JSON |
---|
{
"name": string,
"mimeType": string,
"transcoded": boolean,
"dimensions": {
object ( |
שדות | |
---|---|
name |
זה שינוי אופציונלי. השם של הקובץ שעבר קידוד מחדש. |
mimeType |
זה שינוי אופציונלי. סוג ה-MIME של הקובץ שעבר המרה. |
transcoded |
זה שינוי אופציונלי. מציין אם ההמרה הושלמה בהצלחה. |
dimensions |
זה שינוי אופציונלי. המאפיינים של הסרטון שהקידוד שלו הומר. |
bitRateKbps |
זה שינוי אופציונלי. קצב העברת הנתונים של ההמרה של הסרטון שהקידוד שלו הומר, בקילוביט לשנייה. |
frameRate |
זה שינוי אופציונלי. קצב הפריימים של הסרטון שהקידוד שלו הומר, בפריימים לשנייה. |
audioBitRateKbps |
זה שינוי אופציונלי. קצב הביטים של מקור האודיו של הסרטון שהקוד שלו הומר, או קצב הביטים של האודיו שהקוד שלו הומר, בקילוביטים לשנייה. |
audioSampleRateHz |
זה שינוי אופציונלי. קצב הדגימה של שידור האודיו של הסרטון שהקידוד שלו הומר, או קצב הדגימה של האודיו שהקידוד שלו הומר, בהרץ. |
fileSizeBytes |
זה שינוי אופציונלי. הגודל בבייטים של הקובץ שעבר המרה. |
CmTrackingAd
מודעה למעקב ב-Campaign Manager 360.
ייצוג ב-JSON |
---|
{ "cmPlacementId": string, "cmCreativeId": string, "cmAdId": string } |
שדות | |
---|---|
cmPlacementId |
זה שינוי אופציונלי. מזהה מיקום המודעה של מודעה למעקב ב-Campaign Manager 360. |
cmCreativeId |
זה שינוי אופציונלי. מזהה הקריאייטיב של המודעה למעקב ב-Campaign Manager 360. |
cmAdId |
זה שינוי אופציונלי. מזהה המודעה של מודעה למעקב ב-Campaign Manager 360. |
ObaIcon
סמל OBA לקריאייטיב
ייצוג ב-JSON |
---|
{ "resourceUrl": string, "resourceMimeType": string, "position": enum ( |
שדות | |
---|---|
resourceUrl |
זה שינוי אופציונלי. כתובת ה-URL של מקור הסמל של OBA. |
resourceMimeType |
זה שינוי אופציונלי. סוג ה-MIME של משאב הסמל של OBA. |
position |
זה שינוי אופציונלי. המיקום של סמל ה-OBA בקריאייטיב. |
dimensions |
זה שינוי אופציונלי. המימדים של סמל OBA. |
program |
זה שינוי אופציונלי. התוכנית של סמל ה-OBA. לדוגמה: 'AdChoices'. |
landingPageUrl |
חובה. כתובת ה-URL של דף הנחיתה של סמל ה-OBA. מותר להשתמש רק בכתובות URL של הדומיינים הבאים:
|
clickTrackingUrl |
חובה. כתובת ה-URL למעקב אחר קליקים של סמל OBA. מותר להשתמש רק בכתובות URL של הדומיינים הבאים:
|
viewTrackingUrl |
חובה. כתובת ה-URL למעקב אחר צפייה בסמל OBA. מותר להשתמש רק בכתובות URL של הדומיינים הבאים:
|
ObaIconPosition
המיקום של סמל ה-OBA בקריאייטיב.
טיפוסים בני מנייה (enum) | |
---|---|
OBA_ICON_POSITION_UNSPECIFIED |
לא צוין המיקום של סמל OBA. |
OBA_ICON_POSITION_UPPER_RIGHT |
בפינה השמאלית העליונה של הקריאייטיב. |
OBA_ICON_POSITION_UPPER_LEFT |
בפינה הימנית העליונה של הקריאייטיב. |
OBA_ICON_POSITION_LOWER_RIGHT |
בפינה השמאלית התחתונה של הקריאייטיב. |
OBA_ICON_POSITION_LOWER_LEFT |
בפינה הימנית התחתונה של הקריאייטיב. |
ExpandingDirection
הכיוון שבו הקריאייטיב המתרחב של הצד השלישי מתרחב.
טיפוסים בני מנייה (enum) | |
---|---|
EXPANDING_DIRECTION_UNSPECIFIED |
לא צוין כיוון ההרחבה. |
EXPANDING_DIRECTION_NONE |
לא מתרחבת לכיוון כלשהו. |
EXPANDING_DIRECTION_UP |
הרחבה למעלה. |
EXPANDING_DIRECTION_DOWN |
הרחבה כלפי מטה. |
EXPANDING_DIRECTION_LEFT |
הרחבה ימינה. |
EXPANDING_DIRECTION_RIGHT |
הרחבה ימינה. |
EXPANDING_DIRECTION_UP_AND_LEFT |
הרחבה למעלה ולצד ימין. |
EXPANDING_DIRECTION_UP_AND_RIGHT |
מתרחבת למעלה ולצד שמאל. |
EXPANDING_DIRECTION_DOWN_AND_LEFT |
הרחבה למטה ולצד ימין. |
EXPANDING_DIRECTION_DOWN_AND_RIGHT |
הרחבה למטה ולצד שמאל. |
EXPANDING_DIRECTION_UP_OR_DOWN |
מתרחבת למעלה או למטה. |
EXPANDING_DIRECTION_LEFT_OR_RIGHT |
הרחבה לצד ימין או שמאל. |
EXPANDING_DIRECTION_ANY_DIAGONAL |
אפשר להרחיב אותו בכל כיוון אלכסוני. |
Methods |
|
---|---|
|
יצירת נכס קריאייטיב חדש. |
|
מחיקה של קריאייטיב. |
|
מקבל קריאייטיב. |
|
הצגת קריאייטיבים של מפרסם. |
|
עדכון של קריאייטיב קיים. |