Activer Open Measurement

Sélectionnez une plate-forme : HTML5 Android 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 à l'aide de l'API OMID. Le SDK IMA est compatible avec le SDK OMID v1.4, les extensions GAM AdVerifications sur VAST 2+ et le nœud AdVerifications sur VAST 4+.Pour profiter de la mesure Open Measurement, gardez à l'esprit les 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 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 une version d'IMA compatible avec le SDK OM, 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 rendu courante la pratique consistant à afficher 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.

Pour obtenir un exemple de superposition des commandes vidéo, consultez l'image suivante sur les commandes de rendu de l'application YouTube :

Exemple d&#39;image de superposition de mesure ouverte

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 et 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 "amis", 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 overlays 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 gestes tactiles 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];