SIMID-Unterstützung prüfen

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 vom Creative an den Player

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 Beendet die Anzeigensitzung und meldet einen schwerwiegenden Fehler vom Creative.
getMediaState Gibt den aktuellen Status des Mediaplayers zurück, einschließlich URI, aktueller Zeit, Dauer, Lautstärke und Stummschaltungsstatus.
log Leitet Creative-Protokollnachrichten zur Fehlerbehebung an das IMA SDK weiter.
reportTracking Fordert das IMA SDK auf, Tracking-URLs im Namen des Creatives zu pingen.
requestChangeAdDuration Fordert an, die Gesamtdauer der Anzeigensitzung zu ändern.
requestNavigation Fordert die Weiterleitung zu einem externen URI an.
requestPause Fordert das IMA SDK auf, den Media Player anzuhalten.
requestPlay Fordert das IMA SDK auf, den Media Player fortzusetzen oder abzuspielen.
requestResize Fordert an, die Größe des Videoplayers zu ändern. Wenn der Player die Größenänderung zulässt, ändert das IMA SDK die Größe des Players.
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 UI zum Überspringen der Anzeige angezeigt hat.
requestFocus Fordert den Fokus für den iFrame des Creatives an.

Nicht unterstützte Nachrichten vom Creative an den Player

Das IMA SDK verarbeitet die folgenden CreativeMessage-Typen nicht:

  • requestChangeVolume
  • requestFullscreen
  • requestExitFullscreen

Nachrichten vom Player an das Creative

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, den 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 der Player- oder Videodimensionen.
appBackgrounded Benachrichtigt das Creative, dass die Anwendung in den Hintergrund verschoben wurde.
appForegrounded Benachrichtigt das Creative, dass die Anwendung wieder in den Vordergrund verschoben wurde.
fatalError Benachrichtigt das Creative über einen Fehler auf Playerseite.
log Sendet Protokollnachrichten vom Player an das Creative.
focusIn Benachrichtigt, dass das Creative den Fokus erhalten hat.

Aktualisierungen des Media-Status

Das IMA SDK sendet mediaStateUpdate-Nachrichten an das Creative für die folgenden Ereignisse:

  • play
  • pause
  • stalled (wird gepuffert)
  • seeking
  • seeked
  • ended
  • durationchange
  • timeupdate in regelmäßigen Abständen
  • volumechange einschließlich Stummschaltungsstatus