תמיכה ותאימות

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

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

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

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

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

תמיכה מלאה

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

נתמך חלקית

  • click

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

  • 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

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

תמיכה ב-Apple AirPlay

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

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

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

פלטפורמה גרסה סוג מודעה
HTML5 מחשב: Chrome, Firefox 4.0 ואילך, Safari 5 ואילך, Internet Explorer 11
נייד: דפדפן Chrome או Android (Android 4.1 ואילך לטלפון ו-Android 4.1 ואילך לטאבלט), Safari (iOS 9.0 ואילך)
מודעות לינאריות, לא לינאריות ומודעות נלוות, מודעות וידאו של Ad Manager, מודעות וידאו של Ad Exchange ומודעות AFV
iOS iOS 10.0 ואילך מודעות לינאריות ומודעות נלוות, מודעות וידאו ב-Ad Manager, מודעות וידאו של Ad Exchange ומודעות AFV
Android Android 4.1 ואילך מודעות לינאריות ומודעות נלוות, מודעות וידאו ב-Ad Manager, מודעות וידאו של Ad Exchange ומודעות AFV
tvOS tvOS 14 ומעלה מודעות לינאריות, מודעות וידאו ב-Ad Manager וסרטונים של Ad Exchange

תכונות וידאו וגרסאות SDK

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

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

1 ה-SDK של HTML5 לא תומך בתכונות של VAST 3.0 שעדיין לא נתמכות על ידי ממשק הקצה של Ad Manager.

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

  • במצב Companion adSlotId
  • אפשרויות הצגה נלווית
  • סמלים
  • כל תכונה של VAST 3.0 שעדיין לא נתמכת על ידי ממשק הקצה של Ad Manager

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

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

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

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

6 התכונה נתמכת ב-iOS 10 ואילך כשבשימוש ב-playsinline.

7 יש צורך ב-IMA SDK ל-Android Beta v10 ואילך או iOS Beta v13 ואילך.

8 כדי להשתמש במכסות תדירות ובהחרגות תחרותיות לכללים למודעות, צריך להשתמש בקובצי cookie או ב-PPID.

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

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

10 נדרשת IMA SDK בגרסה 3.6.0 ואילך.

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

12 תמיכה בתכונות הבאות של VAST 4.0:

  • מזהה מודעה
  • קובץ ביניים
  • קודי שגיאות VAST חדשים