בדיקת התמיכה והתאימות של ה-SDK

הפלטפורמה: HTML5 Android iOS tvOS Cast Roku

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

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

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

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

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

תמיכה מלאה

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

נתמך חלקית

  • click

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

  • fullscreen

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

    באייפון ובפלטפורמות Android מגרסה 2.3 ומטה, הסרטון תמיד מופעל במצב מסך מלא.

  • 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 Browser (Android לטלפונים ולטאבלטים), ‏ Safari ו-Chrome‏ (iOS)
iOS ‫iOS גרסה 10.0 ואילך
Android ‫Android 4.4 ומעלה
‫Google Cast כל מכשירי Cast
tvOS tvOS 15 ואילך
Roku כל המכשירים שעדיין מקבלים עדכוני תוכנה מ-Roku

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

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

פלטפורמת IMA SDK HLS DASH
HTML5 סימן וי סימן וי
iOS סימן וי Red-X
Android סימן וי סימן וי
‫Google Cast סימן וי סימן וי
tvOS סימן וי Red-X
Roku סימן וי סימן וי

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

במאמר הזה מוסבר על התכונות הבאות:

חבילת הווידאו של IAB תמיכה
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
מודעות וידאו In-stream נבחרות סימן וי
מודעות וידאו רגילות בסרטון סימן וי
Full-slot Red-X
מודעות נלוות אזהרה 4
מילוי חוסרים (backfill) של מודעות נלוות Red-X
שכבות-על Red-X
תכונות של Ad Exchange ב-Ad Manager תמיכה
TrueView InStream אזהרה 6
מודעות וידאו In-stream נבחרות סימן וי
מודעות וידאו רגילות בסרטון סימן וי
Full-slot Red-X
מודעות נלוות אזהרה 4
מילוי חוסרים (backfill) של מודעות נלוות Red-X
שכבות-על Red-X
מידת החשיפה שניתנת לצפייה לפי Active View סימן וי
למה דווקא המודעה הזו? אזהרה 8

‫1 מתוך התכונות של VAST 4 שנתמכות על ידי Google Ad Manager, ערכת IMA תומכת בתכונות הבאות:

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

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

  • מצב Companion 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, ל-tvOS, ל-Roku ול-Android (כולל Android TV).

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

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

הערות לגבי JavaScript frameworks

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

תמיכה ב-Apple AirPlay

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