בדיקת התמיכה והתאימות של ה-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 framework

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

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

ערכות 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 15 ואילך מודעות לינאריות, מודעות וידאו ב-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 סימן וי סימן וי סימן וי סימן וי
החרגות תחרותיות (שידור) סימן וי סימן וי סימן וי סימן וי
החרגות תחרותיות (פוד) סימן וי סימן וי סימן וי סימן וי
החרגות תחרותיות (דף שלם) סימן וי Red-X Red-X Red-X
Podding אזהרה 3 סימן וי סימן וי סימן וי
מודעות באמפר סימן וי סימן וי סימן וי סימן וי
דיווח על מעקב אחרי כמה אירועים (MET) סימן וי סימן וי סימן וי סימן וי
הקצאה דינמית (AdSense לווידאו, Ad Exchange ב-Ad Manager) סימן וי סימן וי סימן וי סימן וי
מודעות שניתן לדלג עליהן (לא TrueView) 8 אזהרה 5 סימן וי סימן וי סימן וי
InStream Select סימן וי Red-X Red-X Red-X
טעינה מראש של נכסים אזהרה 7 Red-X סימן וי Red-X
התכונות של AdSense לווידאו
TrueView InStream אזהרה 5 סימן וי סימן וי Red-X
InStream Select סימן וי סימן וי סימן וי 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
InStream Select סימן וי סימן וי סימן וי 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 תומך בתכונות הבאות: