בדיקת התמיכה ב-SIMID

ערכת Google Interactive Media Ads (IMA) SDK ל-HTML5 תומכת ב-Secure Interactive Media Interface Definition (SIMID)‎ גרסה 1.1. המדריך הזה עוסק בתכונות ובהודעות הספציפיות של SIMID שנתמכות ב-IMA SDK.

הסבר על הודעות מהקריאייטיב לנגן

בטבלה הבאה מפורטות ההודעות שהקריאייטיב ב-SIMID יכול לשלוח ל-IMA SDK:

שליחת הודעה תיאור
clickThru מטפל בקליקים על מודעות על סמך ה-URI שהקריאייטיב מספק.
fatalError מסיים את הביקור עם החשיפה למודעות ומדווח על שגיאה חמורה בקריאייטיב.
getMediaState הפונקציה מחזירה את המצב הנוכחי של נגן המדיה, כולל URI, ‏ currentTime, ‏ duration, ‏ volume וסטטוס ההשתקה.
log העברת הודעות יומן של קריאייטיב אל IMA SDK לצורך ניפוי באגים.
reportTracking שולחת בקשה ל-IMA SDK לשלוח פינג לכתובות URL למעקב בשם הקריאייטיב.
requestChangeAdDuration בקשות לשינוי משך הזמן הכולל של הביקור עם חשיפה למודעות.
requestNavigation בקשה לניווט ל-URI חיצוני.
requestPause מבקשת מ-IMA SDK להשהות את נגן המדיה.
requestPlay מבקשת מ-IMA SDK להמשיך או להפעיל את נגן המדיה.
requestResize בקשות לשינוי הגודל של נגן הווידאו. אם הנגן מאפשר שינוי גודל, IMA SDK משנה את גודל הנגן.
requestSkip מבקשת מה-SDK לדלג על המודעה הנוכחית.
requestStop מבקש מה-SDK להפסיק את הסשן של המודעה.
handleSkipShown הפונקציה מודיעה ל-IMA SDK שהקריאייטיב הציג את ממשק המשתמש לדילוג על המודעה.
requestFocus בקשת מיקוד ל-iframe של הקריאייטיב.

בדיקת הודעות לא נתמכות מהקריאייטיב לנגן

‫IMA SDK לא מטפל בסוגי ה-CreativeMessage הבאים:

  • requestChangeVolume
  • requestFullscreen
  • requestExitFullscreen

הסבר על הודעות מהנגן למסר של קריאייטיב

בטבלה הבאה מפורטות ההודעות שאפשר לשלוח באמצעות IMA SDK לקריאייטיב ב-SIMID:

שליחת הודעה תיאור
init נשלח במהלך הגדרת הסשן עם נתוני הסביבה ופרמטרים של המודעה.
startCreative מודיע לקריאייטיב להפעיל ולהציג את ה-iframe של הקריאייטיב.
adStopped הודעה על כך שהסשן של המודעה הסתיים, כולל קוד סיבה.
adSkipped האירוע הזה מודיע לקריאייטיב שהמשתמש או IMA SDK דילגו על המודעה.
resize הודעה לקריאייטיב על שינויים בממדים של הנגן או של הסרטון.
appBackgrounded הפונקציה שולחת התראה לקריאייטיב שהאפליקציה עברה לרקע.
appForegrounded הקריאייטיב מקבל הודעה שהאפליקציה חזרה לחזית.
fatalError הודעה לקריאייטיב על שגיאה בצד הנגן.
log שליחת הודעות יומן מהנגן לקריאייטיב.
focusIn הודעה על כך שהקריאייטיב קיבל פוקוס.

בדיקת העדכונים של מצב המדיה

‫IMA SDK שולח הודעות mediaStateUpdate לקריאייטיב באירועים הבאים:

  • play
  • pause
  • stalled (בתהליך אגירת נתונים)
  • seeking
  • seeked
  • ended
  • durationchange
  • ‫timeupdate, מדי פעם.
  • volumechange כולל סטטוס ההשתקה.