Activer Open Measurement

SDK Interactive Media Ads (IMA) pour iOS.

Le SDK IMA pour iOS 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 de la vérification par des tiers. Lorsque vous utilisez le SDK IMA pour iOS, le SDK OM inclus analyse automatiquement la balise <AdVerifications> dans les tags d'emplacement publicitaire VAST et envoie les données de visibilité aux fournisseurs 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 le nœud AdVerifications sur VAST 4+.Pour profiter de l'Open Measurement, gardez les points suivants à l'esprit :

  • Pour utiliser Open Measurement, vous devez disposer de la version 3.9.0 ou ultérieure du SDK IMA pour iOS.

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

  • Évitez de recouvrir le AdDisplayContainer avec des éléments superposés (transparents ou opaques), car le SDK OM les signalera comme des obstructions et réduira 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 s'afficher dans votre réponse VAST.

Enregistrer les obstructions de la superposition des 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 essentielles pour la lecture. Sur mobile, les tapotements imprécis et les attentes des utilisateurs ont fait de la pratique courante le rendu de grands contrôles tactiles sur l'élément multimédia. Ces commandes apparaissent et disparaissent généralement lorsque l'utilisateur appuie sur l'écran, 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 contrôles en ajoutant une vue presque transparente au-dessus du conteneur d'affichage des annonces. En général, 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 d'appui, puis d'afficher les commandes aux utilisateurs lorsqu'ils appuient sur l'écran.

Lorsque la visibilité des annonces est calculée à l'aide du SDK Open Measurement, toutes les vues qui se chevauchent avec l'élément multimédia sont considérées comme des obstructions et réduisent le taux de visibilité. Dans le cas où un calque tactile transparent se trouve au-dessus de l'ensemble du conteneur d'affichage des annonces, il est possible que l'inventaire soit déclaré comme complètement non visible.

Le SDK Open Measurement prévoit que les commandes vidéo soient considérées comme des obstructions "acceptables" qui sont essentielles à l'expérience utilisateur. Une fois enregistrés comme adaptés, ces contrôles sont exclus de la mesure de la visibilité des annonces.

Grâce à la compatibilité avec l'IAB et le MRC, le SDK IMA introduit une API permettant d'enregistrer ces composants en superposition avec le SDK Open Measurement. Ces commandes doivent être des boutons ou des calques entièrement transparents. Toutes les autres vues qui ne sont pas liées aux commandes vidéo ne doivent pas être enregistrées.

S'inscrire à DO NE PAS s'inscrire
  • Superposition transparente pour capturer les appuis 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 transitoires
  • Autres vues masquant le visage

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

UIView *myTransparentTapOverlay = [[UIView alloc] initWithFrame:CGRectMake(0, 0, 300, 250)];
UIButton *myPauseButton = [[UIButton alloc] initWithFrame:CGRectMake(0, 0, 50, 10)];
// Substitute "myTransparentTapOverlay" and "myPauseButton" with the elements
// you want to register as video controls overlays.
// Make sure to register before ad playback starts.
IMAFriendlyObstruction *overlayObstruction =
      [[IMAFriendlyObstruction alloc] initWithView:myTransparentTapOverlay
                                           purpose:IMAFriendlyObstructionPurposeNotVisible
                                    detailedReason:@"This overlay is transparent"];
IMAFriendlyObstruction *pauseButtonObstruction =
      [[IMAFriendlyObstruction alloc] initWithView:myPauseButton
                                           purpose:IMAFriendlyObstructionPurposeMediaControls
                                    detailedReason:@"This is the video player pause button"];

[displayContainer registerFriendlyObstruction:overlayObstruction];
[displayContainer registerFriendlyObstruction:pauseButtonObstruction];

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

[displayContainer unregisterAllFriendlyObstructions];