- משאב: קריאייטיב
- 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[] |
חובה. אירועי יציאה עבור הקריאייטיב הזה. יציאה (שנקראת גם תג קליק) היא כל אזור בקריאייטיב שמשתמש יכול ללחוץ עליו או להקיש עליו כדי לפתוח את דף הנחיתה של המפרסם. כל קריאייטיב חייב לכלול יציאה אחת לפחות. אפשר להוסיף יציאה לקריאייטיב בכל אחת מהדרכים הבאות:
|
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 או SCRIPT. אפשר לכתוב בשדה הזה רק ב
|
jsTrackerUrl |
כתובת URL למדידת JavaScript מספקי אימות נתמכים של צד שלישי (ComScore, DoubleVerify, IAS, Moat). אין תמיכה בתגי סקריפט HTML. אפשר לכתוב בשדה הזה רק ב
|
cmTrackingAd |
מודעת המעקב של Campaign Manager 360 שמשויכת לקריאייטיב. אופציונלי ל
פלט רק במקרים אחרים. |
obaIcon |
מציין את סמל ה-OBA של קריאייטיב וידאו. השדה הזה נתמך רק בשדות הבאים של
|
thirdPartyTag |
זה שינוי אופציונלי. התג המקורי של צד שלישי ששימש ליצירת הקריאייטיב. נדרש וחוקי רק לגבי קריאייטיבים של תגים של צד שלישי. קריאייטיבים של תגים של צד שלישי הם קריאייטיבים עם
משולב עם
|
requireMraid |
זה שינוי אופציונלי. מציין שהקריאייטיב דורש MRAID (מערכת הגדרות של ממשק מודעות מדיה עשירה לנייד). יש להגדיר את האפשרות הזו אם הקריאייטיב מסתמך על תנועות בנייד לאינטראקטיביות, כמו החלקה או הקשה. אופציונלי ותקף רק לקריאייטיבים של צד שלישי. קריאייטיבים של תגים של צד שלישי הם קריאייטיבים עם
משולב עם
|
requireHtml5 |
זה שינוי אופציונלי. מציין שהקריאייטיב מסתמך על HTML5 כדי לבצע עיבוד כראוי. אופציונלי ותקף רק לקריאייטיבים של צד שלישי. קריאייטיבים של תגים של צד שלישי הם קריאייטיבים עם
משולב עם
|
requirePingForAttribution |
זה שינוי אופציונלי. השדה הזה מציין שהקריאייטיב ימתין לפינג חוזר לצורך שיוך (Attribution). תקף רק כשמשתמשים במודעת מעקב של 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[] |
סטטוסים של בדיקות על ידי בעלי תוכן דיגיטלי. אזהרה: השדה הזה יצא משימוש ב-26 ביוני 2024. אחרי התאריך הזה, השדה הזה יהיה ריק. מידע נוסף זמין בהודעה שלנו על הוצאה משימוש של תכונות. |
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 (לדוגמה, 25.96 ש"ח). חשוב לשים לב שהערך הזה לא מסתנכרן אוטומטית עם הערך שמופיע בפועל בחנות. לאחר שמירת הקריאייטיב, היא תמיד תהיה זהה. הקוד הנכסים בתפקיד הזה הם לקריאה בלבד. |
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 |
ניתן להרחיב בכל כיוון אלכסוני. |
שיטות |
|
---|---|
|
יצירת קריאייטיב חדש. |
|
מוחק קריאייטיב. |
|
מגלה קריאייטיב. |
|
רשימה של קריאייטיבים במפרסם. |
|
עדכון קריאייטיב קיים. |