תאימות

דף זה מכיל מידע כללי על תמיכה ותאימות של IMA DAI לדפדפנים, פורמטים של וידאו ופלטפורמות.

פורמטים ודפדפנים נתמכים של וידאו

HTML5 הוא עדיין תקן חדש ומתפתח. כתוצאה מכך, התמיכה בתכונות שונות משתנה בין דפדפנים, ואין פורמט וידאו יחיד שמוגדר כברירת מחדל שנתמך בכל הדפדפנים המובילים. שלושת הפורמטים העיקריים של וידאו שבהם נעשה שימוש ברוב הדפדפנים הם H.264, HLS ו-Dash.

תאימות של אירועי VAST

בקטע הזה מפורטים אירועי VAST שמדווחים לשרת באופן אוטומטי על סמך המידע המוחזר בתגובת VAST.

תמיכה מלאה

complete, creativeView, firstQuartile, impression, midpoint, pause, resume, rewind (מופעל כשיש דילוג משמעותי בכיוון לאחור), start, thirdQuartile.

נתמך חלקית

  • click

    האירוע Click נשלח רק למודעות וידאו. לא ניתן לתעד קליקים בנגנים מותאמים במסך מלא ב-Android, ב-iOS או במחשב, אך עדיין ניתן לתעד קליקים באמצעות רכיב של מעקב אחר קליקים בדף כשהסרטון סגור. עם זאת, אם רכיב הווידאו משתמש בבקרים מקומיים ב-iPad, לא ניתן לתעד קליקים.

  • fullscreen

    IMA תומכת במצב סימולציה של מסך מלא, שבו הסרטון מוצג בכל שטח החלון של הדפדפן. מבחינת IMA, סרטון מוצג במצב מסך מלא כאשר offsetWidth ו-offsetHeight שלו הם לפחות בגודל של גוף המסמך. המצב הזה נתמך בכל הדפדפנים.

    בפלטפורמות iPhone ו-Android שקודמות לגרסה 3.0, הסרטון תמיד מופעל במצב מסך מלא.

  • mute, unmute

    ב-iOS וב-Android יש שליטה מובנית בלבד בעוצמת הקול. לכן, IMA לא יכולה לקבוע את עוצמת הקול או את מצב ההשתקה, וגם לא נשלחת הודעה ל-SDK לגבי שינויים. בהמשך מופיעה רשימה של גרסאות הדפדפן שתומכות או לא תומכות ב-mute, unmute:

    • נתמך: Firefox מגרסה 3.5 ואילך, Chrome 8 ואילך, Safari 4 ואילך
    • לא נתמך: iOS, Android

לפרטים נוספים על הצגת מודעות VAST, קראו את ההנחיות של IAB.

אירועי מודעות במהלך צפייה חוזרת בהפסקות למודעות

IMA לא מפעילה אירועי מודעות במהלך צפייה חוזרת במודעות מהסיבות הבאות:

  • צריך להפעיל כתובות URL של אירועים רק פעם אחת, אחרת הן ייקראו כהתנהגות ספאמית.
  • כך המשתמשים יכולים לחפש את ההפסקות למודעות שהם כבר צפו בהן ומסביבן, וכך ליצור חוויית דילוג טובה יותר.

אלה האירועים היחידים שהופעלו במהלך צפייה חוזרת בהפסקות למודעות:

  • AD_PERIOD_STARTED
  • AD_PERIOD_ENDED

פלטפורמות נתמכות של נגני וידאו

ערכות ה-IMA SDK של Google נתמכות בפלטפורמות הבאות:

פלטפורמה גרסה
HTML5 מחשב: Chrome, Firefox, Safari, Edge, Opera
נייד: דפדפן Chrome/Android (Android לטלפונים וטאבלטים), Safari ו-Chrome (iOS)
iOS iOS 10.0 ואילך
Android Android מגרסה 4.4 ואילך
Google Cast כל מכשירי Cast
tvOS tvOS 14 ומעלה
Roku כל המכשירים שעדיין מקבלים עדכוני תוכנה מ-Roku

תמיכה בפורמט של וידאו בסטרימינג

IMA תומכת ב-HLS וגם ב-DASH בכל ערכות ה-SDK שלה. בטבלה הבאה אפשר למצוא תמיכה בפלטפורמות SDK ספציפיות. כדי שניתן יהיה לצפות בסטרימינג בסטרימינג, נגן הווידאו צריך לתמוך בסוג השידור שבחרת.

פלטפורמת IMA SDK HLS DASH
HTML5 סימן וי סימן וי
iOS סימן וי אדום X
Android סימן וי סימן וי
Google Cast סימן וי סימן וי
tvOS סימן וי אדום X
Roku סימן וי סימן וי

תכונות וידאו וגרסאות SDK

לפרטים נוספים על התכונות הבאות, קראו את המאמר סקירה כללית בנושא פרסום בווידאו.

חבילת מודעות וידאו של IAB תמיכה
VAST 4 אזהרה 1
VAST 3 אזהרה 2
VAST 2 סימן וי
VPAID 2 אדום X
VMAP 1.0.1 אזהרה 3
תכונות הווידאו של Ad Manager תמיכה
מודעות לינאריות סימן וי
מודעות לא לינאריות (שכבות-על) אדום X
מודעות נלוות אזהרה 4
משאבים חלופיים למודעות נלוות מסוג VAST 3 אדום X
הניראות של Active View סימן וי
הפניות VAST לכתובת אתר אחרת סימן וי
מילוי חוזר נלווה עם בקשה לתצוגה אדום X
תאימות של Google Publisher Tag (GPT) אדום X
מוּדעוּת לתוכן אדום X
כללי מודעות סימן וי
פודינג סימן וי
מודעות באמפר סימן וי
דיווח על מעקב מרובה אירועים (MET) סימן וי
ניתנת לדילוג (הזמנה / לא מודעת TrueView) אזהרה 5
התכונות של AdSense לווידאו 7 תמיכה
TrueView InStream אזהרה 6
בחירת מודעת וידאו In-stream סימן וי
מודעת וידאו In-stream רגילה סימן וי
משבצת מלאה אדום X
מודעות נלוות אזהרה 4
מילוי חוזר נלווה אדום X
שכבות-על אדום X
התכונות של Ad Manager Ad Exchange תמיכה
TrueView InStream אזהרה 6
בחירת מודעת וידאו In-stream סימן וי
מודעת וידאו In-stream רגילה סימן וי
משבצת מלאה אדום X
מודעות נלוות אזהרה 4
מילוי חוזר נלווה אדום X
שכבות-על אדום X
הניראות של Active View סימן וי
למה המודעה מוצגת? אזהרה 8

1 מתוך תכונות VAST 4 שנתמכות ב-Google Ad Manager, IMA תומכות בתכונות הבאות:

  • VAST 4.2
  • VAST 4.0
    • AdID
    • קובץ ביניים
    • קודי שגיאות VAST חדשים
    • פקודות מאקרו חדשות של VAST
    • התמיכה של AdVerifications

2 התכונות הבאות של VAST 3.0 עדיין לא נתמכות:

  • זוגי: adSlotId
  • אפשרויות הצגה נלוות
  • סמלים

3 תכונות ה-VMAP הבאות עדיין לא נתמכות:

  • אירועי מעקב ספציפיים ל-VMAP
  • קודי שגיאה ספציפיים ל-VMAP
  • מודעות שכבת-על
  • הפרשי זמן מלבד hh:mm:ss או 'התחלה' ו'סיום'
  • הצגת המאפיין breakType
  • מאפיין אחד (repeatAfter)

4 יש תמיכה רק במודעות נלוות לתמונות. כדי להשתמש בתמונות נלוות צריך להטמיע אותן בהתאמה אישית כדי לאכלס מודעות. מודעות נלוות לא נתמכות ב-tvOS.

5 מודעות מסורתיות שניתן לדלג עליהן נתמכות רק בערכות IMA DAI SDK ל-HTML5, ל-iOS, ל-tvOS, ל-Roku ול-Android (כולל Android TV). כדי להשתמש ב-Cast SDK, צריך להצהיר על יכולת דילוג עם StreamRequest.senderCanSkip, כדי לתמוך במודעות טרגויות שניתן לדלג עליהן.

6 מודעות TrueView שניתן לדלג עליהן נתמכות רק בערכות ה-IMA DAI SDK ל-HTML5, ל-iOS ול-Android (כולל Android TV).

7 תכונות של AdSense לא נתמכות ב-Cast SDK.

8 למה המודעה הזו מוצגת? כדי שהפרמטר adUiElement יועבר כשיוצרים את StreamManager. למה המודעה הזו? לא נתמכת ב-Cast SDK.

אזהרות לגבי מסגרות JavaScript

יש שיקולים מסוימים כשמשתמשים במסגרת JavaScript, כמו React או AngularJS, עם IMA HTML5 SDK. לרוב, המסגרות האלה מעבירות רכיבים של ה-DOM, מה שעלול לגרום לשיבושים ב-IMA SDK, כי ה-SDK מצפה שה-DOM יהיה סטטי כשהוא מופעל. IMA SDK תומך במסגרות JavaScript כל עוד ה-SDK מופעל אחרי שה-framework מסיים להעביר רכיבי DOM. באופן ספציפי, אין להעביר את רכיב ה-HTML5 שעובר כארגומנט adUiElement כשיוצרים את StreamManager לאחר יצירת האובייקט.

תמיכה ב-Apple AirPlay

IMA SDK לא תומך ב-Apple AirPlay. להשבית את AirPlay או להשבית את הבקשות להצגת מודעות כש-AirPlay מזוהה.