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

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

הסבר על הודעות קריאייטיב לשחקנים

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

שליחת הודעה תיאור
clickThru ה-SDK של DAI שולח פינג לכתובות ה-URL למעקב אחרי קליקים שהוגדרו בתג המודעה של DAI. ‫DAI SDK מתעלם מכל URI מותאם אישית או מאפשרויות ניווט שהקריאייטיב מספק.
getMediaState הפונקציה מחזירה את המצב הנוכחי של נגן המדיה, כולל המאפיינים currentTime, duration, volume, muted, paused ו-fullscreen. המאפיין currentSrc תמיד מחזיר null כי DAI משתמש בסטרימינג של תפירת מודעות בצד השרת.
log העברת הודעות יומן של נכסי קריאייטיב לרישום ביומן של מסוף ניפוי הבאגים של DAI SDK לצורך פתרון בעיות.
reportTracking בקשות ששולחות פינג לכתובות ה-URL למעקב של הקריאייטיב ב-DAI SDK.
requestPause בקשות מ-DAI SDK להשהיית נגן המדיה.
requestPlay בקשות מ-DAI SDK להמשך ההפעלה בנגן המדיה.
requestSkip בקשות שגורמות ל-DAI SDK לדלג על המודעה הנוכחית. התכונה נתמכת רק בשידורים של סרטונים על פי דרישה (VOD). הבקשה נדחית אם הקריאייטיב שולח את ההודעה הזו לשידור חי.

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

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

  • fatalError
  • requestChangeAdDuration
  • requestFullscreen
  • requestExitFullscreen
  • handleSkipShown
  • requestFocus
  • ‫requestNavigation: תמיד נדחה. השחקן מצפה שהקריאייטיב יטפל בניווט.
  • requestResize: תמיד נדחה. ‫DAI SDK לא תומך בשינוי גודל של קריאייטיב.
  • ‫requestStop: תמיד נדחה. הסוג הזה מיועד לתרחישי שימוש עם משך זמן ממושך, שלא נתמכים ב-DAI.
  • ‫requestChangeVolume: DAI SDK פותר את האירוע הזה בהצלחה, אבל לא מבצע שינויים בעוצמת הקול של הקריאייטיב.

הבנת המסרים הקריאטיביים לשחקנים

בטבלה הבאה מפורטות ההודעות ש-DAI SDK תומך בשליחה שלהן אל נכס קריאייטיב של SIMID:

שליחת הודעה תיאור
init האירוע נשלח במהלך הגדרת הסשן עם נתוני הסביבה ופרמטרים של מודעות.
startCreative הודעה לקריאייטיב להתחיל ולהציג את ה-iframe של הקריאייטיב.
adStopped הודעה על סיום ביקור עם חשיפה למודעות, כולל קוד סיבה.
adSkipped הודעה לקריאייטיב שהמשתמש או DAI SDK דילגו על המודעה. התכונה נתמכת רק בשידורים של סרטונים על פי דרישה (VOD).

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

‫DAI SDK לא תומך בהודעות הבאות לקריאייטיב ולא שולח אותן:

  • resize
  • appBackgrounded
  • appForegrounded
  • log

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

ערכת ה-SDK של DAI שולחת הודעות mediaStateUpdate לקריאייטיב עבור האירועים הבאים:

  • play
  • pause
  • stalled (אגירת נתונים)
  • seeking
  • seeked
  • timeupdate (מעת לעת)
  • volumechange (כולל סטטוס השתקה)

‫DAI SDK לא תומך באירועים הבאים ולא שולח עדכונים לגבי מצב המדיה כשהאירועים מתרחשים:

  • ended
  • durationchange
  • error