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

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