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.
Nachrichten von Creatorn an 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 vom Creative bereitgestellten URI. |
fatalError |
Beendet die Anzeigensitzung und meldet einen schwerwiegenden Fehler des Creatives. |
getMediaState |
Gibt den aktuellen Status des Mediaplayers zurück, einschließlich URI, currentTime, duration, volume und muted. |
log |
Leitet Creative-Logeinträge zur Fehlerbehebung an das IMA SDK weiter. |
reportTracking |
Fordert das IMA SDK auf, 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 Mediaplayer zu pausieren. |
requestPlay |
Fordert das IMA SDK auf, die Wiedergabe im Mediaplayer fortzusetzen oder zu starten. |
requestResize |
Anfragen zum Ändern der Größe des Videoplayers. Wenn der Player die Größenänderung zulässt, wird die Größe des Players im IMA SDK angepasst. |
requestSkip |
Fordert das SDK auf, die aktuelle Anzeige zu überspringen. |
requestStop |
Fordert das SDK auf, die Anzeigensitzung zu beenden. |
handleSkipShown |
Benachrichtigt das IMA SDK, dass das Creative die Benutzeroberfläche zum Überspringen der Anzeige angezeigt hat. |
requestFocus |
Fordert den Fokus für den iFrame des Creatives an. |
Nicht unterstützte Creative-zu-Player-Nachrichten prüfen
Das IMA SDK verarbeitet die folgenden CreativeMessage-Typen nicht:
requestChangeVolumerequestFullscreenrequestExitFullscreen
Anzeigenbotschaften für Spieler verstehen
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 Einrichtung der Sitzung mit Umgebungsdaten und Anzeigenparametern gesendet. |
startCreative |
Benachrichtigt das Creative, den Creative-iFrame zu initiieren und anzuzeigen. |
adStopped |
Benachrichtigt, dass die Anzeigensitzung beendet wurde, einschließlich eines Ursachencodes. |
adSkipped |
Benachrichtigt das Creative, dass der Nutzer oder das IMA SDK die Anzeige übersprungen hat. |
resize |
Benachrichtigt das Creative über Änderungen der Player- oder Videodimensionen. |
appBackgrounded |
Benachrichtigt das Creative, dass die Anwendung in den Hintergrund gewechselt ist. |
appForegrounded |
Benachrichtigt das Creative, dass die Anwendung wieder im Vordergrund ist. |
fatalError |
Benachrichtigt das Creative über einen Fehler auf der Player-Seite. |
log |
Sendet Logeinträge vom Player an das Creative. |
focusIn |
Benachrichtigt, dass das Creative fokussiert wurde. |
Aktualisierungen des Medienstatus prüfen
Das IMA SDK sendet bei den folgenden Ereignissen mediaStateUpdate-Nachrichten an das Creative:
playpausestalled(wird gepuffert)seekingseekedendeddurationchangetimeupdate, regelmäßig.volumechange, einschließlich des Stummschaltungsstatus.