בדיקת התמיכה ב-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 כולל סטטוס השתקה.