בדיקת התמיכה והתאימות של ה-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
InStream Select סימן וי
מודעות וידאו רגילות בסרטון סימן וי
Full-slot Red-X
מודעות נלוות אזהרה 4
מילוי חוסרים (backfill) של מודעות נלוות Red-X
שכבות-על Red-X
תכונות של Ad Exchange ב-Ad Manager תמיכה
TrueView InStream אזהרה 6
InStream Select סימן וי
מודעות וידאו רגילות בסרטון סימן וי
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
    • מזהה מודעה
    • קובץ Mezzanine
    • קודי שגיאה חדשים של 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). כדי לתמוך במודעות מסורתיות שניתנות לדילוג, צריך להצהיר על יכולת הדילוג באמצעות StreamRequest.senderCanSkip ב-Cast SDK.

‫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 framework

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

תמיכה ב-Apple AirPlay

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