תאימות

דף זה כולל מידע כללי על התמיכה והתאימות של 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 (בטלפונים וטאבלטים), 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 סימן וי
מילוי חוסרים (backfill) נלווה עם בקשה לתצוגה אדום-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 במצב Companion
  • אפשרויות הצגה נלווית
  • סמלים

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.

אזהרות ב-frameworks של JavaScript

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

תמיכה ב-Apple AirPlay

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