Das Google Interactive Media Ads (IMA) 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 behandelt, die vom IMA SDK unterstützt werden.
Kreative Botschaften für Spieler
In der folgenden Tabelle sind die Nachrichten aufgeführt, die das SIMID-Creative an das IMA SDK senden kann:
| Nachricht | Beschreibung |
|---|---|
clickThru |
Verarbeitet Anzeigenklicks basierend auf dem URI, den das Creative bereitstellt. |
fatalError |
Die Anzeigensitzung wird beendet und ein schwerwiegender Fehler des Creatives wird gemeldet. |
getMediaState |
Gibt den aktuellen Status des Media Players zurück, einschließlich URI, currentTime, duration, volume und muted status. |
log |
Leitet Creative-Log-Meldungen zur Fehlerbehebung an das IMA SDK weiter. |
reportTracking |
Das IMA SDK wird aufgefordert, Tracking-URLs im Namen des Creatives zu pingen. |
requestChangeAdDuration |
Anfragen zum Ändern der Gesamtdauer der Anzeigensitzung. |
requestNavigation |
Fordert die Navigation zu einem externen URI an. |
requestPause |
Fordert das IMA SDK auf, den Media-Player anzuhalten. |
requestPlay |
Anfragen, die das IMA SDK auffordern, die Wiedergabe des Media-Players fortzusetzen oder zu starten. |
requestResize |
Anfragen zum Ändern der Größe des Videoplayers. Wenn der Player eine Größenänderung zulässt, wird er vom IMA SDK in der Größe angepasst. |
requestSkip |
Anfragen, mit denen das SDK die aktuelle Anzeige überspringen soll. |
requestStop |
Anfragen, mit denen das SDK die Anzeigensitzung beenden soll. |
handleSkipShown |
Benachrichtigt das IMA SDK, dass im Creative die Benutzeroberfläche zum Überspringen von Anzeigen angezeigt wurde. |
requestFocus |
Fordert den Fokus für den Iframe des Creatives an. |
Nicht unterstützte Creative-to-Player-Nachrichten prüfen
Das IMA SDK verarbeitet die folgenden CreativeMessage-Typen nicht:
requestChangeVolumerequestFullscreenrequestExitFullscreen
Nachrichten von Spielern an Creator
In der folgenden Tabelle sind die Nachrichten aufgeführt, die das IMA SDK an das SIMID-Creative senden kann:
| Nachricht | Beschreibung |
|---|---|
init |
Wird während der Sitzungseinrichtung mit Umgebungsdaten und Anzeigenparametern gesendet. |
startCreative |
Benachrichtigt das Creative, das Creative-iFrame zu starten und anzuzeigen. |
adStopped |
Benachrichtigt, dass die Anzeigensitzung beendet wurde, einschließlich eines Grundcodes. |
adSkipped |
Benachrichtigt das Creative, dass der Nutzer oder das IMA SDK die Anzeige übersprungen hat. |
resize |
Benachrichtigt das Creative über Änderungen an den Abmessungen des Players oder Videos. |
appBackgrounded |
Benachrichtigt das Creative, dass die Anwendung in den Hintergrund verschoben wurde. |
appForegrounded |
Benachrichtigt das Creative, dass die Anwendung in den Vordergrund zurückgekehrt ist. |
fatalError |
Benachrichtigt das Creative über einen clientseitigen Fehler. |
log |
Sendet Log-Nachrichten vom Player an das Creative. |
focusIn |
Benachrichtigt, dass das Creative im Fokus steht. |
Aktualisierungen des Media-Status ansehen
Das IMA SDK sendet mediaStateUpdate-Nachrichten an das Creative für die folgenden Ereignisse:
playpausestalled(wird gepuffert)seekingseekedendeddurationchangetimeupdate, in regelmäßigen Abständen.volumechange, einschließlich des Stummschaltungstatus.