L'SDK Google per l'inserimento di annunci dinamici (DAI) per HTML5 supporta la versione 1.1 di Secure Interactive Media Interface Definition (SIMID). Questa guida illustra le funzionalità e i messaggi SIMID specifici supportati dall'SDK DAI.
Informazioni sui messaggi dalla creatività al player
La tabella seguente elenca i messaggi che la creatività SIMID può inviare a IMA DAI:
| Messaggio | Descrizione |
|---|---|
clickThru |
L'SDK DAI esegue il ping degli URL di monitoraggio dei clickthrough configurati nel tag annuncio DAI. L'SDK DAI ignora qualsiasi URI personalizzato o opzione di navigazione fornita dalla creatività. |
getMediaState |
Restituisce lo stato attuale del media player, incluse le proprietà currentTime, duration, volume, muted, paused e fullscreen. La proprietà currentSrc restituisce sempre null perché DAI utilizza stream uniti lato server. |
log |
Inoltra i messaggi di log della creatività alla registrazione della console di debug dell'SDK DAI per la risoluzione dei problemi. |
reportTracking |
Richiede all'SDK DAI di eseguire il ping degli URL di monitoraggio per la creatività. |
requestPause |
Richiede all'SDK DAI di mettere in pausa il media player. |
requestPlay |
Richiede all'SDK DAI di riprendere la riproduzione sul media player. |
requestSkip |
Richiede all'SDK DAI di saltare l'annuncio corrente. Supportato solo per gli stream VOD. Viene rifiutato se la creatività invia questo messaggio per un live streaming. |
Esaminare i messaggi dalla creatività al player non supportati
L'SDK DAI non gestisce i seguenti tipi di CreativeMessage:
fatalErrorrequestChangeAdDurationrequestFullscreenrequestExitFullscreenhandleSkipShownrequestFocusrequestNavigation: sempre rifiutato. Il player si aspetta che la creatività gestisca la navigazione.requestResize: sempre rifiutato. L'SDK DAI non supporta il ridimensionamento delle creatività.requestStop: sempre rifiutato. Questo tipo è per i casi d'uso di durata estesa, che DAI non supporta.requestChangeVolume: l'SDK DAI risolve questo evento correttamente, ma non esegue modifiche del volume per la creatività.
Informazioni sui messaggi dal player alla creatività
La tabella seguente elenca i messaggi che l'SDK DAI supporta per l'invio alla creatività SIMID:
| Messaggio | Descrizione |
|---|---|
init |
Inviato durante la configurazione della sessione con i dati dell'ambiente e i parametri dell'annuncio. |
startCreative |
Notifica alla creatività di avviare e visualizzare l'iframe della creatività. |
adStopped |
Notifica che la sessione dell'annuncio è terminata, incluso un codice motivo. |
adSkipped |
Notifica alla creatività che l'utente o l'SDK DAI ha saltato l'annuncio. Supportato solo per gli stream VOD. |
Esaminare i messaggi dal player alla creatività non supportati
L'SDK DAI non supporta o invia i seguenti messaggi alla creatività:
resizeappBackgroundedappForegroundedlog
Esaminare gli aggiornamenti dello stato dei contenuti multimediali
L'SDK DAI invia messaggi mediaStateUpdate alla creatività per i seguenti eventi:
playpausestalled(buffering)seekingseekedtimeupdate(periodicamente)volumechange(incluso lo stato di disattivazione dell'audio)
L'SDK DAI non supporta i seguenti eventi e non invia aggiornamenti dello stato dei contenuti multimediali quando si verificano gli eventi:
endeddurationchangeerror