בדיקת התמיכה ב-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 לשלוח פינג לכתובות אתר למעקב בשם הקריאייטיב.
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 כולל סטטוס ההשתקה.