Open Measurement dans le SDK IMA DAI

Le SDK IMA pour Android inclut SDK Open Measurement (OM), une norme sectorielle développée par l'Interactive Advertising Bureau (IAB) pour autoriser les tiers la visibilité et la validation. Si vous utilisez le SDK IMA Android, le SDK OM inclus analyse automatiquement le tag <AdVerifications> dans les tags d'emplacement publicitaire VAST et envoie les données de visibilité les fournisseurs de solutions de mesure spécifiés via l'API OMID. Le SDK IMA est compatible avec le SDK OM. v1.4, extensions GAM AdVerifications sur VAST 2+, et le nœud AdVerifications sur VAST 4+.Pour profiter d'Open Measurement, gardez à l'esprit les points suivants:

  • Pour utiliser Open Measurement, vous devez disposer de la version 3.11.0 ou 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 service 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.

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

Enregistrer les obstacles superposés aux commandes vidéo

Les commandes vidéo, comme les boutons Pause ou les barres de progression, permettent de lire la vidéo des informations et des actions aux utilisateurs. 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 ou disparaissent en fondu et ne sont pas visibles pendant la majeure partie de la 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é. Si une superposition transparente se trouve 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 friendly, ils sont exclus de la visibilité des annonces les mesures.

Prise en charge par l'IAB et le MRC, le SDK IMA introduit une API permettant d'enregistrer ces en superposition avec le SDK Open Measurement. Ces commandes doivent être des superpositions ou de petits boutons entièrement transparents. Les vues qui ne sont pas liées aux commandes de la vidéo doivent ne doivent pas être enregistrées.

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 pertinentes pour la lecture
  • Filigranes
  • Pop-up
  • Boîtes de dialogue
  • Boutons non temporaires
  • Autres vues masquantes

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

<ph type="x-smartling-placeholder"> 
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();