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 des API introduites dans la version 3.16.5.

  • Si vous utilisez VAST 4.1+, les annonces doivent être configurées pour effectuer le trafficking de <AdVerifications> dans leur VAST conformément aux spécifications VAST 4.1. Sinon, vous devez utiliser <Extension type="AdVerifications">.

  • É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éduire 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.

Le <AdVerifications> doit ê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&#39;utilisateur appuie sur l&#39;é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&#39;élément multimédia sont considérées comme des obstacles et réduisent le taux de visibilité. Si une superposition d'appui transparente se trouve au-dessus de l'intégralité du conteneur d'affichage des annonces, il est possible que l'inventaire soit déclaré totalement 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 indiqués comme étant conviviaux, ces contrôles 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 actions des utilisateurs
  • Boutons temporaires
    • Pause
    • Lire
    • Plein écran
    • Cast/AirPlay
    • Réduire
    • Progression/Recherche
    • Autres actions liées à la lecture
  • Filigranes
  • Pop-up
  • Boîtes de dialogue
  • Boutons non temporaires
  • Autres vues obscurcies

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);

Une fois que vous avez terminé, vous pouvez supprimer ces obstacles en appelant la méthode suivante: 

displayContainer.unregisterAllFriendlyObstructions();