Das Google DAI SDK für HTML5 unterstützt die Secure Interactive Media Interface Definition (SIMID) Version 1.1. In diesem Leitfaden werden die spezifischen SIMID-Funktionen und ‑Nachrichten beschrieben, die vom DAI SDK unterstützt werden.
Creative-to-Player-Nachrichten
In der folgenden Tabelle sind die Nachrichten aufgeführt, die das SIMID-Creative an IMA DAI senden kann:
| Nachricht | Beschreibung |
|---|---|
clickThru |
Das DAI SDK pingt die im DAI-Anzeigen-Tag konfigurierten Klick-Tracking-URLs. Das DAI SDK ignoriert alle benutzerdefinierten URI- oder Navigationsoptionen, die im Creative angegeben sind. |
getMediaState |
Gibt den aktuellen Status des Mediaplayers zurück, einschließlich der Attribute currentTime, duration, volume, muted, paused und fullscreen. Die Property currentSrc gibt immer null zurück, da bei DAI serverseitig zusammengefügte Streams verwendet werden. |
log |
Leitet Creative-Logmeldungen zur Fehlerbehebung an das DAI SDK-Debug-Konsolen-Logging weiter. |
reportTracking |
Anfragen, die DAI SDK-Ping-Tracking-URLs für das Creative. |
requestPause |
Anfragen, dass das DAI SDK den Media-Player pausiert. |
requestPlay |
Anfragen, mit denen die Wiedergabe im Mediaplayer fortgesetzt werden soll. |
requestSkip |
Anfragen, bei denen das DAI SDK die aktuelle Anzeige überspringen soll. Wird nur für VOD-Streams unterstützt. Wird abgelehnt, wenn das Creative diese Nachricht für einen Livestream sendet. |
Nicht unterstützte Creative-Nachrichten an den Player prüfen
Das DAI SDK verarbeitet die folgenden CreativeMessage-Typen nicht:
fatalErrorrequestChangeAdDurationrequestFullscreenrequestExitFullscreenhandleSkipShownrequestFocusrequestNavigation: immer abgelehnt. Der Player erwartet, dass das Creative die Navigation übernimmt.requestResize: immer abgelehnt. Das DAI SDK unterstützt keine Größenänderung von Creatives.requestStop: immer abgelehnt. Dieser Typ ist für Anwendungsfälle mit längerer Dauer vorgesehen, die von DAI nicht unterstützt werden.requestChangeVolume: Das DAI SDK löst dieses Ereignis erfolgreich auf, nimmt aber keine Lautstärkeänderungen für das Creative vor.
Nachrichten von Spielern an Creatives
In der folgenden Tabelle sind die Nachrichten aufgeführt, die das DAI SDK an das SIMID-Creative senden kann:
| Nachricht | Beschreibung |
|---|---|
init |
Wird während der Einrichtung der Sitzung mit Umgebungsdaten und Anzeigenparametern gesendet. |
startCreative |
Benachrichtigt das Creative, das iFrame des Creatives zu starten und anzuzeigen. |
adStopped |
Benachrichtigt, dass die Anzeigensitzung beendet wurde, und enthält einen Ursachencode. |
adSkipped |
Benachrichtigt das Creative, dass die Anzeige vom Nutzer oder vom DAI SDK übersprungen wurde. Wird nur für VOD-Streams unterstützt. |
Nicht unterstützte Player-zu-Creative-Nachrichten prüfen
Das DAI SDK unterstützt die folgenden Nachrichten nicht und sendet sie auch nicht an das Creative:
resizeappBackgroundedappForegroundedlog
Aktualisierungen des Media-Status ansehen
Das DAI SDK sendet mediaStateUpdate-Nachrichten an das Creative für die folgenden Ereignisse:
playpausestalled(wird gepuffert)seekingseekedtimeupdate(regelmäßig)volumechange(einschließlich Ausblendungsstatus)
Die folgenden Ereignisse werden vom DAI SDK nicht unterstützt und es werden keine Media-Status-Aktualisierungen gesendet, wenn die Ereignisse auftreten:
endeddurationchangeerror