Le SDK Google Interactive Media Ads (IMA) pour HTML5 est compatible avec la version 1.1 de la spécification SIMID (Secure Interactive Media Interface Definition). Ce guide décrit les fonctionnalités et les messages SIMID spécifiques compatibles avec le SDK IMA.
Comprendre les messages du créateur aux joueurs
Le tableau suivant liste les messages que la création SIMID peut envoyer au SDK IMA :
| Message | Description |
|---|---|
clickThru |
Gère les clics sur les annonces en fonction de l'URI fourni par la création. |
fatalError |
Met fin à la session publicitaire et signale une erreur fatale de la création. |
getMediaState |
Renvoie l'état actuel du lecteur multimédia, y compris l'URI, l'heure actuelle, la durée, le volume et l'état du son (coupé ou non). |
log |
Transfère les messages de journal de la création au SDK IMA pour le débogage. |
reportTracking |
Demande au SDK IMA d'envoyer un ping aux URL de suivi au nom de la création. |
requestChangeAdDuration |
Demandes de modification de la durée totale de la session publicitaire. |
requestNavigation |
Demande la navigation vers un URI externe. |
requestPause |
Demande au SDK IMA de mettre en pause le lecteur multimédia. |
requestPlay |
Demande au SDK IMA de reprendre ou de lancer la lecture du lecteur multimédia. |
requestResize |
Demande le redimensionnement du lecteur vidéo. Si le lecteur autorise le redimensionnement, le SDK IMA redimensionne le lecteur. |
requestSkip |
Demande au SDK d'ignorer l'annonce actuelle. |
requestStop |
Demande au SDK d'arrêter la session publicitaire. |
handleSkipShown |
Indique au SDK IMA que la création a affiché l'UI permettant d'ignorer l'annonce. |
requestFocus |
Demande la sélection de l'iFrame de la création. |
Examiner les messages concernant les créations non compatibles avec le lecteur
Le SDK IMA ne gère pas les types CreativeMessage suivants :
requestChangeVolumerequestFullscreenrequestExitFullscreen
Comprendre les messages du lecteur à la création
Le tableau suivant liste les messages que le SDK IMA 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 |
Indique à la création de lancer et d'afficher l'iFrame de la création. |
adStopped |
Indique que la session publicitaire est terminée, y compris un code de motif. |
adSkipped |
Indique à la création que l'utilisateur ou le SDK IMA a ignoré l'annonce. |
resize |
Informe la création des modifications apportées aux dimensions du lecteur ou de la vidéo. |
appBackgrounded |
Indique à la création que l'application est passée en arrière-plan. |
appForegrounded |
Indique à la création que l'application est revenue au premier plan. |
fatalError |
Notifie la création d'une erreur côté lecteur. |
log |
Envoie des messages de journal du lecteur à la création. |
focusIn |
Indique que la création a été sélectionnée. |
Examiner les mises à jour de l'état des contenus multimédias
Le SDK IMA envoie des messages mediaStateUpdate à la création pour les événements suivants :
playpausestalled: en mémoire tamponseekingseekedendeddurationchangetimeupdate, périodiquement.volumechange, y compris l'état Ignorer.