Open Measurement dans le SDK IMA

Le SDK IMA pour Android inclut le SDK Open Measurement (OM), une norme du secteur développée par l'Interactive Advertising Bureau (IAB) pour permettre la mesure de la visibilité et des vérifications tierces. Lorsque vous utilisez le SDK IMA pour Android, le SDK OM inclus analyse automatiquement la balise <AdVerifications> dans les balises d'annonces VAST et envoie des données de visibilité aux fournisseurs de solutions de mesure spécifiés via l'API OMID.Le SDK IMA est compatible avec le SDK OM v1.4, les extensions GAM AdVerifications sur VAST 2 et versions ultérieures, ainsi que le nœud AdVerifications sur VAST 4 et versions ultérieures.Pour profiter d'Open Measurement, tenez compte des points suivants:

  • Pour utiliser Open Measurement, vous devez disposer de la version 3.11.0 ou ultérieure du SDK IMA pour Android. Toutefois, l'exemple de ce guide est conçu pour la dernière version du SDK et inclut les API introduites dans la version 3.16.5.

  • Les annonces doivent être configurées pour le trafic <AdVerifications> dans leur VAST conformément à la spécification VAST 4.1 si vous utilisez VAST 4.1 ou version ultérieure. Sinon, <Extension type="AdVerifications"> doit être utilisé.

  • Évitez de recouvrir le AdDisplayContainer avec des superpositions (transparentes ou opaques), car elles seront signalées comme des obstacles par le SDK OM et réduiront la visibilité.

Prérequis

Tests

Pour tester Open Measurement à l'aide du SDK IMA, utilisez l'une des versions requises du SDK ci-dessus, ainsi qu'un tag d'emplacement publicitaire de test.

<AdVerifications> devrait être renvoyé dans votre réponse VAST.

Enregistrer les obstacles superposés aux commandes vidéo

Les commandes vidéo telles que les boutons de pause ou les barres de progression fournissent aux utilisateurs des informations et des actions de lecture essentielles. Sur mobile, les appuis imprécis et les attentes des utilisateurs ont rendu courante l'utilisation de commandes de grande taille, adaptées aux écrans tactiles, sur l'élément multimédia. Ces commandes apparaissent généralement au fur et à mesure que l'utilisateur appuie sur l'écran et ne sont pas visibles pendant la majeure partie de la durée de lecture.

Vous trouverez ci-dessous un exemple de commandes vidéo affichées par l'application YouTube:

Lorsque vous utilisez le SDK IMA, la plupart des éditeurs implémentent ces commandes en ajoutant une vue au-dessus du conteneur d'affichage des annonces qui est principalement transparente. En règle générale, les commandes sont des éléments enfants de cette vue qui masquent complètement le lecteur vidéo sous-jacent. Cette superposition transparente permet de capturer les événements de pression, puis d'afficher les commandes aux utilisateurs lorsqu'ils appuient dessus.

Lorsque la visibilité des annonces est calculée via le SDK Open Measurement, toutes les vues superposées à l'élément multimédia sont considérées comme des obstacles et réduisent le taux de visibilité. Dans le cas où une superposition transparente est placée au-dessus de l'ensemble du conteneur d'affichage des annonces, il est possible que l'inventaire soit déclaré complètement invisible.

Le SDK Open Measurement prévoit que les commandes vidéo soient considérées comme des obstacles "conviviaux" essentiels à l'expérience utilisateur. Une fois enregistrés comme compatibles, ces paramètres sont exclus de la mesure de la visibilité des annonces.

Avec la compatibilité avec l'IAB et le MRC, le SDK IMA introduit une API permettant d'enregistrer ces superpositions avec le SDK Open Measurement. Ces commandes doivent être des superpositions ou de petits boutons entièrement transparents. Aucune autre vue non liée aux commandes vidéo ne doit être enregistrée.

Registre DO NE PAS vous inscrire
  • Superposition transparente pour capturer les pressions de l'utilisateur
  • Boutons temporaires
    • Pause
    • Lire
    • Plein écran
    • Cast/AirPlay
    • Réduire
    • Progression/Recherche
    • Autres actions liées à la lecture
  • Filigranes
  • Pop-ups
  • Boîtes de dialogue
  • Boutons non temporaires
  • Autres vues masquantes

L'exemple de code suivant montre comment enregistrer des superpositions de commandes vidéo sur le conteneur d'affichage de l'annonce: 

myTransparentTapOverlay = (ViewGroup) rootView.findViewById(R.id.overlay);
myPauseButton = (ImageButton) rootView.findViewById(R.id.pauseButton);
// Substitute "myTransparentTapOverlay" and "myPauseButton" with the
// elements you want to register as video controls overlays.
// Make sure to register before ad playback starts.
overlayObstruction = ImaSdkFactory.createFriendlyObstruction(
  myTransparentTapOverlay,
  FriendlyObstructionPurpose.NOT_VISIBLE,
  "This overlay is transparent"
);
pauseButtonObstruction = ImaSdkFactory.createFriendlyObstruction(
  myPauseButton,
  FriendlyObstructionPurpose.VIDEO_CONTROLS,
  "This is the video player pause button"
);

displayContainer.registerFriendlyObstruction(overlayObstruction);
displayContainer.registerFriendlyObstruction(pauseButtonObstruction);

Lorsque vous n'en avez plus besoin, vous pouvez supprimer ces obstacles en appelant la méthode suivante: 

displayContainer.unregisterAllFriendlyObstructions();