- משאב: קריאייטיב
- 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 |
פלט בלבד. חותמת הזמן של העדכון האחרון של הקריאייטיב, על ידי המשתמש או על ידי המערכת (למשל, בדיקת קריאייטיב). הוקצה על ידי המערכת. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
createTime |
פלט בלבד. חותמת הזמן של יצירת הקריאייטיב. הוקצה על ידי המערכת. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
creativeType |
חובה. לא משתנה. סוג הקריאייטיב. |
hostingSource |
חובה. מציין היכן הקריאייטיב מתארח. |
dynamic |
פלט בלבד. מציין אם הקריאייטיב דינמי. |
dimensions |
חובה. מאפיינים ראשיים של הקריאייטיב. רלוונטי לכל סוגי הקריאייטיב. ברירת המחדל של הערך של
|
additionalDimensions[] |
מאפיינים נוספים. רלוונטי אם
אם מציינים את השדה הזה, גם |
mediaDuration |
פלט בלבד. משך זמן המדיה של הקריאייטיב. רלוונטי אם
משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, המסתיים ב-' |
creativeAttributes[] |
פלט בלבד. רשימת המאפיינים של הקריאייטיב שהמערכת יצרה. |
reviewStatus |
פלט בלבד. הסטטוס הנוכחי של תהליך בדיקת הקריאייטיב. |
assets[] |
חובה. נכסים שמשויכים לקריאייטיב הזה. |
exitEvents[] |
חובה. אירועי יציאה עבור הקריאייטיב הזה. יציאה (שנקראת גם תג click tag) היא כל אזור בקריאייטיב שאפשר ללחוץ עליו או להקיש עליו כדי לפתוח את דף הנחיתה של המפרסם. כל קריאייטיב חייב לכלול יציאה אחת לפחות. אפשר להוסיף יציאה לקריאייטיב בכל אחת מהדרכים הבאות:
|
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 |
אפשרות. מזהה קריאייטיב אופציונלי שמסופק על ידי מרשם, וייחודי בכל הפלטפורמות. מזהה מודעה אוניברסלי הוא חלק מתקן VAST 4.0. אפשר לשנות אותה לאחר יצירת הקריאייטיב. השדה הזה נתמך רק עבור
|
thirdPartyUrls[] |
כתובות URL למעקב מצדדים שלישיים לצורך מעקב אחר אינטראקציות עם קריאייטיב וידאו. השדה הזה נתמך רק עבור
|
transcodes[] |
פלט בלבד. המרות קידוד של אודיו/וידאו. מערכת Display & Video 360 ממירה את הקידוד של הנכס הראשי למספר גרסאות חלופיות שיש להן פורמטים שונים של קבצים או בעלות מאפיינים שונים (רזולוציה, קצב העברת נתוני אודיו וקצב העברת נתונים של וידאו), שכל אחת מהן מיועדת לנגני וידאו או לרוחבי פס ספציפיים. המרת הקידודים האלה נותנת למערכת של בעלי התוכן הדיגיטלי יותר אפשרויות בחירה עבור כל חשיפה בסרטון שלכם, ומבטיחה שהקובץ המתאים יוצג בהתאם למהירות החיבור של הצופה ולגודל המסך שלו. השדה הזה נתמך רק ב
|
trackerUrls[] |
כתובות URL למעקב אחר ספקי ניתוח נתונים או ספקי צד שלישי של טכנולוגיות פרסום. כתובות ה-URL חייבות להתחיל ב-https (למעט במלאי שלא דורש תאימות SSL). אם אתם משתמשים בפקודות מאקרו בכתובת ה-URL, השתמשו רק בפקודות המאקרו שנתמכות ב-Display & Video 360. כתובות URL רגילות בלבד, ללא תגי JPG או סריג. ניתן לכתוב בשדה הזה רק ב
|
jsTrackerUrl |
כתובת URL למדידת JavaScript מספקי אימות נתמכים של צד שלישי (ComScore, DoubleVerify, IAS, Moat). תגי סקריפט HTML אינם נתמכים. ניתן לכתוב בשדה הזה רק ב
|
cmTrackingAd |
המודעה לצורכי מעקב ב-Campaign Manager 360 שמשויכת לקריאייטיב. אופציונלי ל-
פלט במקרים אחרים בלבד. |
obaIcon |
מציין את סמל ה-OBA של קריאייטיב וידאו. השדה הזה נתמך רק ב
|
thirdPartyTag |
אפשרות. התג המקורי של צד שלישי שמשמש ליצירת הקריאייטיב. נדרש וחוקי רק עבור קריאייטיבים של תגים של צד שלישי. קריאייטיבים של תגים של צד שלישי הם קריאייטיבים עם
משולב עם
|
requireMraid |
אפשרות. מציין שהקריאייטיב דורש MRAID (מערכת הגדרות של ממשק מודעות מדיה עשירה לנייד). הגדרה זו מתאימה אם הקריאייטיב מסתמך על תנועות בנייד ליצירת אינטראקטיביות, כמו החלקה או הקשה. אופציונלי ותקף רק לנכסי קריאייטיב של תגים של צד שלישי. קריאייטיבים של תגים של צד שלישי הם קריאייטיבים עם
משולב עם
|
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
מקורות אירוח אפשריים של קריאייטיב. מציין איפה נוצר הקריאייטיב ומתארח אותו.
טיפוסים בני מנייה (enums) | |
---|---|
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
תכונות אפשריות של קריאייטיב.
טיפוסים בני מנייה (enums) | |
---|---|
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[] |
החלפת סטטוסים של ביקורות של הקריאייטיב. |
publisherReviewStatuses[] |
סטטוסי הבדיקה של הקריאייטיב על ידי בעל התוכן הדיגיטלי. |
ApprovalStatus
סוגים אפשריים של סטטוס אישור זה הסיכום של creativeAndLandingPageReviewStatus
ושל contentAndPolicyReviewStatus
.
טיפוסים בני מנייה (enums) | |
---|---|
APPROVAL_STATUS_UNSPECIFIED |
ערך הסוג לא צוין או שהוא לא ידוע בגרסה הזו. |
APPROVAL_STATUS_PENDING_NOT_SERVABLE |
הקריאייטיב עדיין בבדיקה ואי אפשר להציג אותו. |
APPROVAL_STATUS_PENDING_SERVABLE |
הקריאייטיב עבר את בדיקת נכסי הקריאייטיב ודף הנחיתה ואפשר להציג אותו, אבל הוא ממתין לתוכן נוסף ולבדיקה של תאימות למדיניות. |
APPROVAL_STATUS_APPROVED_SERVABLE |
תהליך הבדיקה של נכסי הקריאייטיב ושל דפי הנחיתה, וגם של בדיקת התוכן והמדיניות אושרו. הקריאייטיב ניתן להצגה. |
APPROVAL_STATUS_REJECTED_NOT_SERVABLE |
יש בעיה בקריאייטיב וצריך לתקן אותה לפני שאפשר יהיה להציג אותה. |
ReviewStatus
סוגים אפשריים של סטטוס הבדיקה.
טיפוסים בני מנייה (enums) | |
---|---|
REVIEW_STATUS_UNSPECIFIED |
ערך הסוג לא צוין או שהוא לא ידוע בגרסה הזו. |
REVIEW_STATUS_APPROVED |
הקריאייטיב אושר. |
REVIEW_STATUS_REJECTED |
הקריאייטיב נדחה. |
REVIEW_STATUS_PENDING |
הקריאייטיב ממתין לבדיקה. |
ExchangeReviewStatus
החלפת סטטוס הבדיקה של הקריאייטיב.
ייצוג JSON |
---|
{ "exchange": enum ( |
שדות | |
---|---|
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
התפקיד של הנכס הזה בקריאייטיב.
טיפוסים בני מנייה (enums) | |
---|---|
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 או בחנות האפליקציות ל-iOS (לדוגמה, 5.99$). לתשומת ליבך, הערך הזה לא מסונכרן באופן אוטומטי עם הערך האמיתי שרשום בחנות. הוא תמיד יהיה זה שמסופק לאחר שמירת הקריאייטיב. הקוד נכסים בתפקיד הזה הם לקריאה בלבד. |
ASSET_ROLE_ANDROID_APP_ID |
המזהה של אפליקציה ל-Android בחנות Google Play. המזהה הזה מופיע בכתובת ה-URL של האפליקציה בחנות Google Play אחרי המילה 'id'. לדוגמה: ב-https://play.google.com/store/apps/details?id=com.company.appname המזהה הוא com.company.appname. נכסים בתפקיד הזה הם לקריאה בלבד. |
ASSET_ROLE_IOS_APP_ID |
המזהה של אפליקציה ל-iOS ב-Apple App Store. את מספר המזהה הזה אפשר למצוא בכתובת ה-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 |
חובה. כתובת ה-URL של הקליק על אירוע היציאה. פעולה זו נדרשת כאשר
|
name |
השם של תג הקליק של אירוע היציאה. השם חייב להיות ייחודי בתוך קריאייטיב אחד. אפשר להשאיר את השדה ריק או לא מוגדר עבור קריאייטיבים שמכילים נכסי תמונות בלבד. |
reportingName |
השם שמשמש לזיהוי האירוע בדוחות. אפשר להשאיר את השדה ריק או לא מוגדר עבור קריאייטיבים שמכילים נכסי תמונות בלבד. |
ExitEventType
הסוג של אירוע יציאה.
טיפוסים בני מנייה (enums) | |
---|---|
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
המרשם מספק מזהים ייחודיים של קריאייטיב במזהה מודעה אוניברסלי.
טיפוסים בני מנייה (enums) | |
---|---|
UNIVERSAL_AD_REGISTRY_UNSPECIFIED |
מרשם המודעות האוניברסלי לא צוין או לא ידוע בגרסה הזו. |
UNIVERSAL_AD_REGISTRY_OTHER |
צריך להשתמש בספק מותאם אישית כדי לספק את מזהה המודעה בקמפיין האוניברסלי. |
UNIVERSAL_AD_REGISTRY_AD_ID |
השתמשו ב-Ad-ID כדי לספק את מזהה המודעה האוניברסלי. |
UNIVERSAL_AD_REGISTRY_CLEARCAST |
צריך להשתמש ב-clearcast.co.uk כדי לספק את מזהה המודעה האוניברסלי. |
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 למעקב של הצד השלישי צריכה לעקוב אחר סוג האינטראקציה.
טיפוסים בני מנייה (enums) | |
---|---|
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 |
קצב העברת הקידוד של הסרטון שהומר, בקילובייט (KB) לשנייה. |
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 |
חובה. כתובת דף הנחיתה של סמל ה-OBA. מותרות רק כתובות URL מהדומיינים הבאים: |
clickTrackingUrl |
חובה. כתובת ה-URL למעקב אחר קליקים של סמל ה-OBA. מותרות רק כתובות URL מהדומיינים הבאים: |
viewTrackingUrl |
חובה. כתובת ה-URL למעקב אחר הצפיות בסמל ה-OBA. מותרות רק כתובות URL מהדומיינים הבאים: |
ObaIconPosition
המיקום של סמל ה-OBA בקריאייטיב.
טיפוסים בני מנייה (enums) | |
---|---|
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
כיוון ההרחבה של הקריאייטיב הניתן להרחבה של צד שלישי.
טיפוסים בני מנייה (enums) | |
---|---|
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 |
ניתן להרחיב בכל כיוון אלכסוני. |
שיטות |
|
---|---|
|
יצירת קריאייטיב חדש. |
|
מוחק קריאייטיב. |
|
מדגים את היצירתיות. |
|
בתיבת הדו-שיח הזו מוצגים נכסי הקריאייטיב של המפרסם. |
|
עדכון קריאייטיב קיים. |