Sprawdzanie obsługi SIMID

Pakiet SDK do dynamicznego wstawiania reklam w Google (DAI) w HTML5 obsługuje standard Secure Interactive Media Interface Definition (SIMID) w wersji 1.1. Ten przewodnik zawiera informacje o konkretnych funkcjach i komunikatach SIMID obsługiwanych przez pakiet DAI SDK.

Informacje o wiadomościach od kreacji do gracza

W tabeli poniżej znajdziesz listę komunikatów, które kreacja SIMID może wysyłać do IMA DAI:

Wiadomość Opis
clickThru Pakiet DAI SDK wysyła pingi do docelowych URL-i śledzenia klikalności skonfigurowanych w tagu reklamy DAI. Pakiet DAI SDK ignoruje wszystkie niestandardowe identyfikatory URI lub opcje nawigacji podane przez kreację.
getMediaState Zwraca bieżący stan odtwarzacza multimediów, w tym właściwości currentTime, duration, volume, muted, paused i fullscreen. Właściwość currentSrc zawsze zwraca wartość null, ponieważ DAI korzysta ze strumieni połączonych po stronie serwera.
log Przekazuje komunikaty dziennika kreacji do dziennika konsoli debugowania pakietu DAI SDK w celu rozwiązywania problemów.
reportTracking Wysyła żądania do linków monitorujących pingi pakietu DAI SDK w przypadku kreacji.
requestPause Wysyła do pakietu DAI SDK żądanie wstrzymania odtwarzacza multimediów.
requestPlay Wysyła do pakietu DAI SDK żądanie wznowienia odtwarzania w odtwarzaczu multimediów.
requestSkip Żądania, aby pakiet DAI SDK pominął bieżącą reklamę. Obsługiwane tylko w przypadku strumieni VOD. Odrzuca, jeśli kreacja wysyła tę wiadomość w przypadku transmisji na żywo.

Sprawdzanie komunikatów o nieobsługiwanych kreacjach w odtwarzaczu

Pakiet DAI SDK nie obsługuje tych CreativeMessage typów:

  • fatalError
  • requestChangeAdDuration
  • requestFullscreen
  • requestExitFullscreen
  • handleSkipShown
  • requestFocus
  • requestNavigation: zawsze odrzucane. Odtwarzacz oczekuje, że kreacja będzie obsługiwać nawigację.
  • requestResize: zawsze odrzucane. Pakiet SDK DAI nie obsługuje zmiany rozmiaru kreacji.
  • requestStop: zawsze odrzucane. Ten typ jest przeznaczony do zastosowań o dłuższym czasie trwania, których DAI nie obsługuje.
  • requestChangeVolume: pakiet SDK DAI rozwiązuje to zdarzenie, ale nie wprowadza zmian głośności w przypadku kreacji.

Informacje o wiadomościach od graczy do twórców

W tabeli poniżej znajdziesz listę wiadomości, które pakiet DAI SDK może wysyłać do kreacji SIMID:

Wiadomość Opis
init Wysyłany podczas konfigurowania sesji z danymi o środowisku i parametrami reklamy.
startCreative Powiadamia kreację o konieczności zainicjowania i wyświetlenia elementu iframe kreacji.
adStopped Informuje, że sesja reklamy została zakończona, i zawiera kod przyczyny.
adSkipped Informuje kreację, że użytkownik lub pakiet SDK DAI pominął reklamę. Obsługiwane tylko w przypadku strumieni VOD.

Sprawdzanie komunikatów o nieobsługiwanym odtwarzaczu w kreacji

Pakiet DAI SDK nie obsługuje tych komunikatów i nie wysyła ich do kreacji:

  • resize
  • appBackgrounded
  • appForegrounded
  • log

Sprawdzanie aktualizacji stanu multimediów

Pakiet SDK DAI wysyła do kreacji mediaStateUpdate wiadomości w przypadku tych zdarzeń:

  • play
  • pause
  • stalled (buffering – buforowanie)
  • seeking
  • seeked
  • timeupdate (okresowo)
  • volumechange (w tym stan ignorowania)

Pakiet SDK DAI nie obsługuje tych zdarzeń i nie wysyła aktualizacji stanu multimediów, gdy one wystąpią:

  • ended
  • durationchange
  • error