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

בחירת פלטפורמה: HTML5 Android iOS tvOS

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

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

התמיכה בתכונות שונות משתנה בין הדפדפנים, ואין פורמט וידאו יחיד שנתמך בכל הדפדפנים המובילים. שלושת הפורמטים העיקריים של וידאו שמשמשים ברוב הדפדפנים הם H.264,‏ WebM ו-Ogg Theora.

נגני וידאו נתמכים

רוב התכונות של IMA נתמכות על ידי נגני וידאו רגילים בפורמט HTML5, כולל התג HTML <video>. בתוכנית השותפים הטכנולוגיים של Google בתחום הווידאו מופיעה רשימה של נגני וידאו מוכרים עם תמיכה ב-IMA SDK.

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

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

תמיכה מלאה

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

נתמך חלקית

  • click

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

  • fullscreen

    ‫IMA SDK תומך במצב סימולציה של מסך מלא, שבו הסרטון תופס את כל חלון הדפדפן. סרטון נחשב כסרטון במצב מסך מלא אם הערכים 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.

הערות לגבי JavaScript frameworks

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

תמיכה ב-Apple AirPlay

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

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

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

פלטפורמה גרסה סוג מודעה
HTML5 מחשב: Chrome, ‏ Firefox, ‏ Safari, ‏ Edge, ‏ Opera
נייד: Chrome/Android Browser (Android לטלפונים ולטאבלטים), ‏ Safari ו-Chrome‏ (iOS)
מודעות לינאריות, לא לינאריות ומודעות נלוות, פתרונות וידאו של Ad Manager, מודעות וידאו ב-Ad Exchange ומודעות AFV
iOS ‫iOS גרסה 10.0 ואילך מודעות ליניאריות ומודעות משלימות, מודעות וידאו ב-Ad Manager, מודעות וידאו ב-Ad Exchange ומודעות וידאו ב-AFV
Android ‫Android 4.4 ומעלה מודעות ליניאריות ומודעות משלימות, מודעות וידאו ב-Ad Manager, מודעות וידאו ב-Ad Exchange ומודעות וידאו ב-AFV
tvOS tvOS 14 ואילך מודעות לינאריות, מודעות וידאו ב-Ad Manager ומודעות וידאו ב-Ad Exchange

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

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

HTML5 v3 iOS v3 Android v3 tvOS
IAB Video Suite
VAST 4 אזהרה 9 אזהרה 9 אזהרה 9 אזהרה 9
VAST 3 סימן וי אזהרה 1 אזהרה 1 אזהרה 1
VAST 2 סימן וי סימן וי סימן וי סימן וי
SIMID 1.0 סימן וי סימן וי סימן וי Red-X
VPAID 2 (HTML5) סימן וי Red-X Red-X Red-X
VMAP 1.0.1 אזהרה 2 3 אזהרה 2 אזהרה 2 אזהרה 2
OM SDK 1.3 סימן וי סימן וי סימן וי Red-X
תכונות הווידאו ב-Ad Manager
מודעות לינאריות סימן וי סימן וי סימן וי סימן וי
נכסים שמתארחים ב-YouTube אזהרה 4 Red-X Red-X Red-X
מודעות לא לינאריות (שכבות-על) אזהרה 5 Red-X Red-X Red-X
מודעות נלוות סימן וי סימן וי סימן וי Red-X
נכסי מודעות נלוות חלופיות ב-VAST 3 סימן וי סימן וי Red-X Red-X
מידת החשיפה שניתנת לצפייה לפי Active View סימן וי סימן וי סימן וי Red-X
מודעות אודיו סימן וי סימן וי סימן וי סימן וי
הפניות אוטומטיות של VAST סימן וי סימן וי סימן וי סימן וי
מילוי חוסרים (backfill) של מודעות נלוות באמצעות בקשה להצגת מודעה לרשת המדיה סימן וי סימן וי סימן וי Red-X
תאימות ל-Google Publisher Tag ‏ (GPT) סימן וי Red-X Red-X Red-X
הבנת תוכן סימן וי סימן וי סימן וי סימן וי
כללי מודעות אזהרה 3 סימן וי סימן וי סימן וי
הפסקות למודעות שמוגדרות ידנית בכללי מודעות סימן וי Red-X Red-X Red-X
מכסות תדירות 6 סימן וי סימן וי סימן וי סימן וי
החרגות תחרותיות (שידור) סימן וי סימן וי סימן וי סימן וי
החרגות תחרותיות (pod) סימן וי סימן וי סימן וי סימן וי
החרגות תחרותיות (דף שלם) סימן וי Red-X Red-X Red-X
Podding אזהרה 3 סימן וי סימן וי סימן וי
מודעות באמפר סימן וי סימן וי סימן וי סימן וי
דיווח על מעקב אחרי כמה אירועים (MET) סימן וי סימן וי סימן וי סימן וי
הקצאה דינמית (AdSense לווידאו, Ad Exchange ב-Ad Manager) סימן וי סימן וי סימן וי סימן וי
ניתן לדלג (לא TrueView) 8 אזהרה 5 סימן וי סימן וי סימן וי
מודעות וידאו In-stream נבחרות סימן וי Red-X Red-X Red-X
טעינה מראש של נכסים אזהרה 7 Red-X סימן וי Red-X
התכונות של AdSense לווידאו
TrueView InStream אזהרה 5 סימן וי סימן וי Red-X
מודעות וידאו In-stream נבחרות סימן וי סימן וי סימן וי Red-X
מודעות וידאו רגילות בסרטון סימן וי סימן וי סימן וי סימן וי
Full-slot סימן וי Red-X Red-X Red-X
מודעות נלוות סימן וי סימן וי סימן וי Red-X
מילוי חוסרים (backfill) של מודעות נלוות Red-X סימן וי סימן וי Red-X
שכבות-על אזהרה 5 Red-X Red-X Red-X
טעינה מראש של נכסים אזהרה 7 Red-X סימן וי Red-X
תכונות של Ad Exchange ב-Ad Manager
TrueView InStream אזהרה 5 סימן וי סימן וי Red-X
מודעות וידאו In-stream נבחרות סימן וי סימן וי סימן וי Red-X
מודעות וידאו רגילות בסרטון סימן וי סימן וי סימן וי סימן וי
Full-slot סימן וי Red-X Red-X Red-X
מודעות נלוות סימן וי סימן וי סימן וי Red-X
מילוי חוסרים (backfill) של מודעות נלוות Red-X סימן וי סימן וי Red-X
שכבות-על אזהרה 5 Red-X Red-X Red-X
מידת החשיפה שניתנת לצפייה לפי Active View סימן וי סימן וי סימן וי Red-X
טעינה מראש של נכסים אזהרה 7 Red-X סימן וי Red-X
למה דווקא המודעה הזו? סימן וי סימן וי סימן וי סימן וי

1 התכונות הבאות של VAST 3.0 עדיין לא נתמכות בערכות SDK שאינן HTML5:

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

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

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

3 כדי לתמוך ב-VMAP ובכללי מודעות באייפון, צריך להגדיר הפעלה מותאמת אישית של מודעות.

4נכסי קריאייטיב שמארחים ב-YouTube נתמכים במחשב אבל לא באתרים לנייד.

5 מודעות לא לינאריות (שכבות-על), מודעות שאפשר לדלג עליהן (לא TrueView) ומודעות וידאו TrueView In-stream נתמכות באינטרנט לנייד ב-HTML5 ב-iOS 10 ומעלה כשמשתמשים ב- playsinline .

6 מכסות תדירות והחרגות של מודעות מתחרותיות בכללי מודעות דורשות קובצי Cookie או PPID.

‫7 טעינה מראש של נכסים מובנים לא פועלת עם:

  • אינטרנט לניידים במכשירי iOS
  • אינטרנט לניידים ב-Android מגרסה 4.0 ומטה
  • מודעות שמתארחות ב-YouTube, כולל פורמטים של TrueView
  • התכונה 'הפעלה ידנית של הפסקות פרסום' ב-IMA (כל הטמעה שמסתמכת על האירוע AD_BREAK_READY)

8 ערכת ה-SDK לא תומכת במודעות שאפשר לדלג עליהן שאורכן פחות מ-8 שניות. כשמודעות קצרות מהאורך המינימלי מוצגות, לא מוצג כפתור הדילוג.

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