Le SDK Google Dynamic Ad Insertion (DAI) pour HTML5 est compatible avec la version 1.1 de la Secure Interactive Media Interface Definition (SIMID). Ce guide décrit les fonctionnalités et les messages SIMID spécifiques compatibles avec le SDK DAI.
Comprendre les messages envoyés aux joueurs par les créations
Le tableau suivant répertorie les messages que la création SIMID peut envoyer à IMA DAI :
| Message | Description |
|---|---|
clickThru |
Le SDK DAI envoie des pings aux URL de suivi des clics configurées dans le tag d'emplacement publicitaire DAI. Le SDK DAI ignore tous les URI personnalisés ou les options de navigation fournis par la création. |
getMediaState |
Renvoie l'état actuel du lecteur multimédia, y compris les propriétés currentTime, duration, volume, muted, paused et fullscreen. La propriété currentSrc renvoie toujours null, car l'insertion dynamique d'annonces utilise des flux assemblés côté serveur. |
log |
Transmet les messages du journal de la création à la journalisation de la console de débogage du SDK DAI pour le dépannage. |
reportTracking |
Demande au SDK DAI d'envoyer un ping aux URL de suivi de la création. |
requestPause |
Demande au SDK DAI de mettre en pause le lecteur multimédia. |
requestPlay |
Demandes du SDK DAI pour reprendre la lecture sur le lecteur multimédia. |
requestSkip |
Demandes au SDK DAI pour ignorer l'annonce en cours. Compatible uniquement avec les flux VOD. Refusée si la création envoie ce message pour une diffusion en direct. |
Examiner les messages de création non compatibles avec le lecteur
Le SDK DAI ne gère pas les types CreativeMessage suivants :
fatalErrorrequestChangeAdDurationrequestFullscreenrequestExitFullscreenhandleSkipShownrequestFocusrequestNavigation: toujours refusé. Le lecteur s'attend à ce que la création gère la navigation.requestResize: toujours refusé. Le SDK DAI n'est pas compatible avec le redimensionnement des créations.requestStop: toujours refusé. Ce type est destiné aux cas d'utilisation de longue durée, que la DAI ne prend pas en charge.requestChangeVolume: le SDK DAI résout cet événement, mais ne modifie pas le volume de la création.
Comprendre les messages envoyés par les joueurs aux créateurs
Le tableau suivant liste les messages que le SDK DAI peut envoyer à la création SIMID :
| Message | Description |
|---|---|
init |
Envoyé lors de la configuration de la session avec les données d'environnement et les paramètres d'annonce. |
startCreative |
Avertit la création d'initier et d'afficher l'iFrame de la création. |
adStopped |
Indique que la session d'annonce est terminée, y compris un code de motif. |
adSkipped |
Indique à la création que l'utilisateur ou le SDK DAI a ignoré l'annonce. Compatible uniquement avec les flux VOD. |
Examiner les messages "Lecteur non compatible" pour les créations
Le SDK DAI n'accepte pas et n'envoie pas les messages suivants à la création :
resizeappBackgroundedappForegroundedlog
Examiner les mises à jour de l'état du contenu multimédia
Le SDK DAI envoie des messages mediaStateUpdate à la création pour les événements suivants :
playpausestalled: en mémoire tamponseekingseekedtimeupdate(périodiquement)volumechange(y compris l'état de blocage)
Le SDK DAI n'est pas compatible avec les événements suivants et n'envoie pas de mises à jour de l'état du contenu multimédia lorsqu'ils se produisent :
endeddurationchangeerror