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

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

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

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

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

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

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

תאימות לאירועי 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 framework

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

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

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

פלטפורמה גרסה סוג מודעה
HTML5 מחשב: Chrome, ‏ Firefox, ‏ Safari, ‏ Edge, ‏ Opera
נייד: דפדפן Chrome/Android (מכשירי 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 גרסה 3 Android גרסה 3 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
מודעות לינאריות סימן וי סימן וי סימן וי סימן וי
מודעות לינאריות לרשת המדיה סימן וי Red-X Red-X Red-X
נכסים שמתארחים ב-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
פודקאסטים ‫אזהרה 3 סימן וי סימן וי סימן וי
מודעות באמפר סימן וי סימן וי סימן וי סימן וי
דיווח על מעקב אחרי מספר אירועים (MET) סימן וי סימן וי סימן וי סימן וי
הקצאה דינמית (AdSense לווידאו, Ad Manager Ad Exchange) סימן וי סימן וי סימן וי סימן וי
ניתנות לדילוג (לא 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
מודעת וידאו רגילה In-stream סימן וי סימן וי סימן וי סימן וי
משבצת מלאה סימן וי 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
מודעת וידאו רגילה In-stream סימן וי סימן וי סימן וי סימן וי
משבצת מלאה סימן וי 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 או "start" ו-"end"
  • המאפיין "מסך breakType"
  • מאפיין אחד (repeatAfter)

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

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

‫5 מודעות לא לינאריות (שכבות-על), מודעות שניתן לדלג עליהן (לא TrueView) ומודעות TrueView InStream נתמכות באינטרנט לנייד ב-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: