ערכת 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 הבאים:
requestChangeVolumerequestFullscreenrequestExitFullscreen
הסבר על הודעות מהנגן למסר של קריאייטיב
בטבלה הבאה מפורטות ההודעות שאפשר לשלוח באמצעות IMA SDK לקריאייטיב ב-SIMID:
| שליחת הודעה | תיאור |
|---|---|
init |
נשלח במהלך הגדרת הסשן עם נתוני הסביבה ופרמטרים של המודעה. |
startCreative |
מודיע לקריאייטיב להפעיל ולהציג את ה-iframe של הקריאייטיב. |
adStopped |
הודעה על כך שהסשן של המודעה הסתיים, כולל קוד סיבה. |
adSkipped |
האירוע הזה מודיע לקריאייטיב שהמשתמש או IMA SDK דילגו על המודעה. |
resize |
הודעה לקריאייטיב על שינויים בממדים של הנגן או של הסרטון. |
appBackgrounded |
הפונקציה שולחת התראה לקריאייטיב שהאפליקציה עברה לרקע. |
appForegrounded |
הקריאייטיב מקבל הודעה שהאפליקציה חזרה לחזית. |
fatalError |
הודעה לקריאייטיב על שגיאה בצד הנגן. |
log |
שליחת הודעות יומן מהנגן לקריאייטיב. |
focusIn |
הודעה על כך שהקריאייטיב קיבל פוקוס. |
בדיקת העדכונים של מצב המדיה
IMA SDK שולח הודעות mediaStateUpdate לקריאייטיב באירועים הבאים:
playpausestalled(בתהליך אגירת נתונים)seekingseekedendeddurationchange-
timeupdate, מדי פעם. volumechangeכולל סטטוס ההשתקה.