תאימות

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

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

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

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

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

פלטפורמה גרסה
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 סימן וי Red-X
Android סימן וי סימן וי
Google Cast סימן וי סימן וי
tvOS סימן וי Red-X
Roku סימן וי סימן וי

תכונות שקשורות לסרטונים וגרסאות SDK

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

תמיכה ב-Apple AirPlay

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