Open Measurement dans le SDK IMA

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 des vérifications tierces. Lorsque vous utilisez le SDK IMA pour iOS, 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.9.0 ou ultérieure du SDK IMA pour iOS.

  • 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.

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 s'affichent généralement en fondu lorsque l'utilisateur appuie dessus et ne sont pas visibles pendant la grande majorité de la lecture.

Voici 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 d'appui, puis d'afficher les commandes lorsque les utilisateurs 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.

Compatible 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 dans 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 obstacles en appelant la méthode suivante: 

[displayContainer unregisterAllFriendlyObstructions];