- מקור: קריאייטיב
- 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 |
פלט בלבד. שם המשאב של הקריאייטיב. |
advertiser |
פלט בלבד. המזהה הייחודי של המפרסם שהקריאייטיב שייך אליו. |
creative |
פלט בלבד. המזהה הייחודי של הקריאייטיב. המערכת מקצה את השם. |
cm |
פלט בלבד. המזהה הייחודי של מיקום המודעה ב-Campaign Manager 360 שמשויך לקריאייטיב. השדה הזה רלוונטי רק לנכסי קריאייטיב שמסונכרנים מ-Campaign Manager. |
display |
חובה. השם המוצג של הקריאייטיב. הקידוד חייב להיות UTF-8 והגודל המקסימלי הוא 240 בייטים. |
entity |
חובה. המדיניות הזו קובעת אם הקריאייטיב יוצג או לא. הערכים הקבילים הם:
|
update |
פלט בלבד. חותמת הזמן של העדכון האחרון של הקריאייטיב – על ידי המשתמש או המערכת (למשל, בדיקת הקריאייטיב). המערכת מקצה את השם. חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
create |
פלט בלבד. חותמת הזמן של מועד יצירת הקריאייטיב. המערכת מקצה את השם. חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
creative |
חובה. בלתי ניתן לשינוי. סוג הקריאייטיב. |
hosting |
חובה. מציין איפה הקריאייטיב מתארח. |
dynamic |
פלט בלבד. מציין אם הקריאייטיב הוא דינמי. |
dimensions |
חובה. המאפיינים הראשיים של הקריאייטיב. רלוונטי לכל סוגי הקריאייטיב. הערך של
|
additional |
מאפיינים נוספים. רלוונטי כאשר
אם מציינים את השדה הזה, צריך לציין גם את |
media |
פלט בלבד. משך המדיה של הקריאייטיב. רלוונטי אם
משך הזמן בשניות, עם עד תשע ספרות עשרוניות, שמסתיימים ב-' |
creative |
פלט בלבד. רשימה של מאפייני הקריאייטיב שנוצרת על ידי המערכת. |
review |
פלט בלבד. הסטטוס הנוכחי של תהליך בדיקת הקריאייטיב. |
assets[] |
חובה. הנכסים שמשויכים לנכס הקריאייטיב הזה. |
exit |
חובה. אירועי יציאה מנכס הקריאייטיב הזה. אירוע יציאה (נקרא גם תג קליק) הוא כל אזור בקריאייטיב שמישהו יכול ללחוץ או להקיש עליו כדי לפתוח את דף הנחיתה של המפרסם. כל קריאייטיב חייב לכלול לפחות יציאה אחת. אפשר להוסיף אירוע יציאה לקריאייטיב באחת מהדרכים הבאות:
|
timer |
אירועים מותאמים אישית של טיימר לקריאייטיב של מדיה עשירה. שעונים עוקבים אחרי הזמן שבו משתמש צופה בחלק מסוים בקריאייטיב של מדיה עשירה ומקיים איתו אינטראקציה. לקריאייטיב יכולים להיות כמה אירועי טיימר, כל אחד בזמן בנפרד. משאירים אותו ריק או לא מגדירים אותו בקריאייטיבים שמכילים נכסי תמונות בלבד. |
counter |
אירועי מונה לקריאייטיב מסוג מדיה עשירה. ספירות עוקבות אחרי מספר הפעמים שמשתמש יוצר אינטראקציה עם חלק כלשהו בקריאייטיב של מדיה עשירה באופן מסוים (העברת העכבר מעל, הוצאת העכבר מעל, קליקים, הקשות, טעינת נתונים, הקלדות במקלדת וכו'). אפשר לתעד כמספר כל אירוע שאפשר לתעד בקריאייטיב. משאירים אותו ריק או לא מגדירים אותו בקריאייטיבים שמכילים נכסי תמונות בלבד. |
appended |
תג מעקב HTML של צד שלישי שצריך לצרף לתג הקריאייטיב. |
integration |
פרטי מזהה המשמשים לקישור הקריאייטיב הזה למערכת חיצונית. חייב להיות מקודד ב-UTF-8 באורך של עד 10,000 תווים. |
notes |
הערות של משתמשים לגבי נכס הקריאייטיב הזה. חייב להיות מקודד ב-UTF-8 באורך של עד 20,000 תווים. |
ias |
מציין אם מופעל מעקב אחר קמפיינים של Integral Ad Science (IAS). כדי להפעיל אפשרות זו עבור הקריאייטיב, יש לוודא שה- |
companion |
המזהים של נכסי קריאייטיב נלווים לקריאייטיב וידאו. אתם יכולים להקצות נכסי קריאייטיב קיימים לרשת המדיה (עם נכסי תמונה או HTML5) כדי שיוצגו מסביב לנגן הווידאו של בעל התוכן הדיגיטלי. התכונות הנוספות מוצגות סביב נגן הווידאו בזמן שהסרטון פועל, והן נשארות גם אחרי שהסרטון מסתיים. קריאייטיבים שמכילים את השדה הזה נתמך רק ב-
|
skippable |
אם המשתמש יכול לבחור לדלג על קריאייטיב של סרטון. השדה הזה נתמך רק ב-
|
skip |
משך הזמן שבו הסרטון יופעל לפני שיופיע לחצן הדילוג. השדה הזה נדרש כשהערך של השדה הזה נתמך רק עבור
|
progress |
משך הזמן שבו צריך להפעיל את הסרטון כדי שנספר צפייה. השדה הזה נדרש כשהערך של השדה הזה נתמך רק ב-
|
universal |
זה שינוי אופציונלי. מזהה קריאייטיב אופציונלי שמסופק על ידי מאגר, והוא ייחודי בכל הפלטפורמות. Universal Ad ID הוא חלק מתקן VAST 4.0. אפשר לשנות אותו אחרי יצירת הקריאייטיב. השדה הזה נתמך רק ב-
|
third |
מעקב אחר כתובות URL של צדדים שלישיים כדי לעקוב אחר אינטראקציות עם נכס קריאייטיב מסוג וידאו. השדה הזה נתמך רק ב-
|
transcodes[] |
פלט בלבד. המרת קידודים של אודיו/וידאו. מערכת Display &Video 360 ממירה את הקידוד של הנכס הראשי לכמה גרסאות חלופיות שמשתמשות בפורמטים שונים של קבצים או שיש להן מאפיינים שונים (רזולוציה, קצב העברת נתונים של אודיו וקצב העברת נתונים של וידאו), שכל אחת מהן מיועדת לנגני וידאו או לרוחבי פס ספציפיים. ההמרות האלה מאפשרות למערכת של בעל התוכן הדיגיטלי לבחור מבין יותר אפשרויות לכל חשיפת מודעה בסרטון, ומבטיחות שהקובץ המתאים יוצג בהתאם לחיבור ולגודל המסך של הצופה. השדה הזה נתמך רק ב-
|
tracker |
כתובות URL למעקב של ספקי ניתוח נתונים או ספקי צד שלישי של טכנולוגיות פרסום. כתובות ה-URL חייבות להתחיל ב-https (למעט במלאי שטחי הפרסום שלא מחייב תאימות ל-SSL). אם משתמשים במאקרו בכתובת ה-URL, צריך להשתמש רק במאקרו שתומכים בהם ב-Display & Video 360. כתובות URL רגילות בלבד, ללא תגי IMG או SCRIPT. אפשר לכתוב בשדה הזה רק ב-
|
js |
כתובת URL למדידת JavaScript מספקי אימות נתמכים של צד שלישי (ComScore, DoubleVerify, IAS, Moat). אין תמיכה בתגי סקריפט של HTML. אפשר לכתוב בשדה הזה רק ב-
|
cm |
מודעת המעקב ב-Campaign Manager 360 שמשויכת לקריאייטיב.
פלט רק במקרים אחרים. |
oba |
מציין את סמל OBA בקריאייטיב של סרטון. השדה הזה נתמך רק ב-
|
third |
זה שינוי אופציונלי. התג המקורי של הצד השלישי ששימש לקריאייטיב. המאפיין הזה חובה ותקף רק לנכסי קריאייטיב עם תגים של צד שלישי. קריאייטיבים עם תגים של צד שלישי הם קריאייטיבים עם
בשילוב עם
|
require |
זה שינוי אופציונלי. הקריאייטיב מחייב MRAID (מערכת של הגדרות ממשק בין מודעות Rich Media לנייד). מגדירים את הערך הזה אם הקריאייטיב מסתמך על תנועות בנייד לצורך אינטראקטיביות, כמו החלקה או הקשה. האפשרות הזו היא אופציונלית ותוקפה חל רק על נכסי קריאייטיב עם תגים של צד שלישי. קריאייטיבים עם תגים של צד שלישי הם קריאייטיבים עם
בשילוב עם
|
require |
זה שינוי אופציונלי. מציין שהקריאייטיב מסתמך על HTML5 כדי לעבד כראוי. האפשרות הזו היא אופציונלית ותוקפה חל רק על נכסי קריאייטיב עם תגים של צד שלישי. קריאייטיבים עם תגים של צד שלישי הם קריאייטיבים עם
בשילוב עם
|
require |
זה שינוי אופציונלי. הקריאייטיב ימתין לקבלת תשובה (ping) כדי לשייך את ההמרה. התג תקף רק כשמשתמשים במודעת מעקב ב-Campaign Manager 360 עם פרמטר של שרת מודעות של צד שלישי והמאקרו ${DC_DBM_TOKEN}. אופציונלי ותקף רק לקריאייטיבים עם תגים של צד שלישי או לקריאייטיבים עם תגי VAST של צד שלישי. קריאייטיבים עם תגים של צד שלישי הם קריאייטיבים עם
בשילוב עם
קריאייטיבים עם תגי VAST של צד שלישי הם קריאייטיבים עם
בשילוב עם
|
expanding |
זה שינוי אופציונלי. מציין את כיוון ההרחבה של הקריאייטיב. נדרש ותקף רק עבור קריאייטיבים מתרחבים של צד שלישי. קריאייטיבים נרחבים של צד שלישי הם קריאייטיבים עם מקור האירוח הבא:
בשילוב עם
|
expand |
זה שינוי אופציונלי. האפשרות הזו מציינת שהקריאייטיב יתרחב באופן אוטומטי כאשר יהיה מרחף מעליו. האפשרות הזו היא אופציונלית ותוקפה חל רק על נכסי קריאייטיב נרחבים של צד שלישי. קריאייטיבים נרחבים של צד שלישי הם קריאייטיבים עם מקור האירוח הבא:
בשילוב עם
|
vast |
זה שינוי אופציונלי. כתובת ה-URL של תג ה-VAST בקריאייטיב של תג VAST של צד שלישי. נדרש ותקף רק לקריאייטיבים של תגי VAST של צד שלישי. קריאייטיבים עם תגי VAST של צד שלישי הם קריאייטיבים עם
בשילוב עם
|
vpaid |
פלט בלבד. מציין שהקריאייטיב של תג ה-VAST של הצד השלישי מחייב VPAID (ממשק בין מודעות לבין נגן וידאו דיגיטלי). פלט בלבד, ותקף רק לנכסי קריאייטיב עם תגי VAST של צד שלישי. קריאייטיבים עם תגי VAST של צד שלישי הם קריאייטיבים עם
בשילוב עם
|
html5 |
פלט בלבד. הקריאייטיב של תג ה-VAST של הצד השלישי מחייב תמיכה בסרטוני HTML5. פלט בלבד, ותקף רק לנכסי קריאייטיב עם תגי VAST של צד שלישי. קריאייטיבים עם תגי VAST של צד שלישי הם קריאייטיבים עם
בשילוב עם
|
line |
פלט בלבד. המזהים של הפריטים שקריאייטיב הזה משויך אליהם. כדי לשייך קריאייטיב לפריט, משתמשים במקום זאת ב- |
mp3 |
פלט בלבד. מציין שהקריאייטיב של האודיו של הצד השלישי תומך בפורמט MP3. פלט בלבד, ותקף רק לנכסי קריאייטיב של אודיו של צד שלישי. קריאייטיבים של צד שלישי הם קריאייטיבים עם ה
בשילוב עם
|
ogg |
פלט בלבד. מציין שהקריאייטיב האודיו של הצד השלישי תומך בפורמט OGG. פלט בלבד, ותקף רק לנכסי קריאייטיב של אודיו של צד שלישי. קריאייטיבים של אודיו של צד שלישי הם קריאייטיבים עם
בשילוב עם
|
HostingSource
מקורות אירוח אפשריים של נכס קריאייטיב. מציין איפה הקריאייטיב נוצר ומתארח.
טיפוסים בני מנייה (enum) | |
---|---|
HOSTING_SOURCE_UNSPECIFIED |
מקור האירוח לא צוין או שאינו ידוע בגרסה הזו. |
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 ( |
שדות | |
---|---|
approval |
מייצג את האישור הבסיסי שנחוץ כדי שהקריאייטיב יתחיל להופיע. סיכום של |
creative |
סטטוס הבדיקה של הקריאייטיב ושל דף הנחיתה. |
content |
הסטטוס של בדיקת התוכן והמדיניות של הקריאייטיב. |
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 |
בורסת הפרסום בודקת את הקריאייטיב. |
status |
הסטטוס של בדיקת ההחלפה. |
PublisherReviewStatus
סטטוס הבדיקה של הקריאייטיב של המוציא לאור.
ייצוג ב-JSON |
---|
{
"publisherName": string,
"status": enum ( |
שדות | |
---|---|
publisher |
בעל התוכן הדיגיטלי שבודק את הקריאייטיב. |
status |
הסטטוס של בדיקת בעל התוכן הדיגיטלי. |
AssetAssociation
שיוך הנכס לקריאייטיב.
ייצוג ב-JSON |
---|
{ "asset": { object ( |
שדות | |
---|---|
asset |
הנכס המשויך. |
role |
התפקיד של הנכס הזה בקריאייטיב. |
נכס
נכס יחיד.
ייצוג ב-JSON |
---|
{ "mediaId": string, "content": string } |
שדות | |
---|---|
media |
מזהה המדיה של הנכס שהועלו. זהו מזהה ייחודי של הנכס. אפשר להעביר את המזהה הזה לקריאות API אחרות, למשל המרחב של מזהה המדיה עודכן ב-5 באפריל 2023. עדכון מזהי המדיה שנשמרו במטמון לפני 5 באפריל 2023: מאחזרים את מזהה המדיה החדש ממשאבי הקריאייטיב המשויכים או מעלים מחדש את הנכס. |
content |
תוכן הנכס. בנכסים שהועלו, התוכן הוא נתיב ההצגה. |
AssetRole
התפקיד של הנכס הזה בקריאייטיב.
טיפוסים בני מנייה (enum) | |
---|---|
ASSET_ROLE_UNSPECIFIED |
תפקיד הנכס לא צוין או לא ידוע בגרסה הזו. |
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 Store אחרי 'id'. לדוגמה, בכתובת https://play.google.com/store/apps/details?id=com.company.appname המזהה הוא com.company.appname. הנכסים של התפקיד הזה זמינים לקריאה בלבד. |
ASSET_ROLE_IOS_APP_ID |
המזהה של אפליקציה ל-iOS בחנות האפליקציות של Apple. מספר המזהה הזה מופיע בכתובת ה-URL של האפליקציה ב-Apple App Store כמחרוזת המספרים שמופיעה ישירות אחרי 'id'. לדוגמה, בכתובת https://apps.apple.com/us/app/gmail-email-by-google/id422689480 המזהה הוא 422689480. הנכסים של התפקיד הזה זמינים לקריאה בלבד. |
ASSET_ROLE_RATING |
הדירוג של אפליקציה בחנות Google Play או בחנות האפליקציות ל-iOS. חשוב לזכור שהערך הזה לא מסתנכרן באופן אוטומטי עם הדירוג בפועל בחנות. הוא תמיד יהיה זה שסיפקתם כששמרתם את הקריאייטיב. הנכסים של התפקיד הזה זמינים לקריאה בלבד. |
ASSET_ROLE_ICON |
הסמל של הקריאייטיב. התפקיד הזה נתמך ונחוץ רק ב-
|
ASSET_ROLE_COVER_IMAGE |
תמונת השער של קריאייטיב של וידאו מותאם. התפקיד הזה נתמך ונחוץ רק ב-
|
ExitEvent
אירוע יציאה מהקריאייטיב.
ייצוג ב-JSON |
---|
{
"type": enum ( |
שדות | |
---|---|
type |
חובה. סוג אירוע היציאה. |
url |
חובה. כתובת היעד של הקליק באירוע היציאה. הדרישה הזו נדרשת כשהערך של
|
name |
השם של תג הקליק של אירוע היציאה. השם חייב להיות ייחודי בתוך קריאייטיב אחד. משאירים אותו ריק או לא מגדירים אותו בקריאייטיבים שמכילים נכסי תמונות בלבד. |
reporting |
השם שמשמש לזיהוי האירוע הזה בדוחות. משאירים אותו ריק או לא מגדירים אותו בקריאייטיבים שמכילים נכסי תמונות בלבד. |
ExitEventType
סוג אירוע היציאה.
טיפוסים בני מנייה (enum) | |
---|---|
EXIT_EVENT_TYPE_UNSPECIFIED |
סוג האירוע 'יציאה' לא צוין או שהוא לא ידוע בגרסה הזו. |
EXIT_EVENT_TYPE_DEFAULT |
אירוע היציאה הוא אירוע ברירת המחדל. |
EXIT_EVENT_TYPE_BACKUP |
אירוע היציאה הוא אירוע יציאה לגיבוי. יכולים להיות כמה אירועי יציאה לגיבוי בקריאייטיב. |
TimerEvent
אירוע הטיימר של הקריאייטיב.
ייצוג JSON |
---|
{ "name": string, "reportingName": string } |
שדות | |
---|---|
name |
חובה. השם של אירוע הטיימר. |
reporting |
חובה. השם שמשמש לזיהוי אירוע הטיימר הזה בדוחות. |
CounterEvent
אירוע נגד של הקריאייטיב.
ייצוג ב-JSON |
---|
{ "name": string, "reportingName": string } |
שדות | |
---|---|
name |
חובה. השם של אירוע המונה. |
reporting |
חובה. השם שמשמש לזיהוי אירוע המונה הזה בדוחות. |
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_REGISTRY_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 כדי לספק את מזהה המודעה האוניברסלי. |
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 |
השם של הקובץ שעבר קידוד מחדש. |
mime |
סוג ה-MIME של הקובץ שהקידוד שלו הומר. |
transcoded |
השדה הזה מציין אם המרת הקידוד בוצעה בהצלחה. |
dimensions |
המאפיינים של הסרטון שהקידוד שלו הומר. |
bit |
קצב העברת הנתונים של ההמרה של הסרטון שהקידוד שלו הומר, בקילוביט לשנייה. |
frame |
קצב הפריימים של הסרטון שעבר המרת קידוד, בפריימים לשנייה. |
audio |
קצב הביטים של מקור האודיו של הסרטון שהקוד שלו הומר, או קצב הביטים של האודיו שהקוד שלו הומר, בקילוביטים לשנייה. |
audio |
תדירות הדגימה של שידור האודיו של הסרטון שהקידוד שלו הומר, או תדירות הדגימה של האודיו שהקידוד שלו הומר, בהרץ. |
file |
הגודל בבייטים של הקובץ שעבר המרה. |
CmTrackingAd
מודעה למעקב ב-Campaign Manager 360.
ייצוג ב-JSON |
---|
{ "cmPlacementId": string, "cmCreativeId": string, "cmAdId": string } |
שדות | |
---|---|
cm |
מזהה מיקום המודעה של מודעה למעקב ב-Campaign Manager 360. |
cm |
מזהה הקריאייטיב של המודעה למעקב ב-Campaign Manager 360. |
cm |
מזהה המודעה של המודעה שעוקבת אחרי המודעה ב-Campaign Manager 360. |
ObaIcon
סמל OBA לקריאייטיב
ייצוג ב-JSON |
---|
{ "resourceUrl": string, "resourceMimeType": string, "position": enum ( |
שדות | |
---|---|
resource |
כתובת ה-URL של מקור הסמל של OBA. |
resource |
סוג ה-MIME של משאב הסמל OBA. |
position |
המיקום של סמל ה-OBA בקריאייטיב. |
dimensions |
המידות של סמל OBA. |
program |
התוכנית של סמל ה-OBA. לדוגמה: 'AdChoices'. |
landing |
חובה. כתובת ה-URL של דף הנחיתה של סמל ה-OBA. מותר להשתמש רק בכתובות URL של הדומיינים הבאים: |
click |
חובה. כתובת ה-URL למעקב אחר קליקים של סמל ה-OBA. מותר להשתמש רק בכתובות URL של הדומיינים הבאים: |
view |
חובה. כתובת ה-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 |
אפשר להרחיב אותו בכל כיוון אלכסוני. |
שיטות |
|
---|---|
|
יצירת קריאייטיב חדש. |
|
מוחק קריאייטיב. |
|
אחזור קריאייטיב. |
|
הצגת קריאייטיבים של מפרסם. |
|
עדכון של קריאייטיב קיים. |