Open Measurement

Le SDK IMA pour HTML5 inclut le SDK Open Measurement (OM), une norme du secteur développée par l'Interactive Advertising Bureau (IAB) pour permettre aux tiers de mesurer la visibilité et les vérifications. Lorsque vous utilisez le SDK IMA pour HTML5, le SDK OM inclus analyse automatiquement la balise <AdVerifications> dans les balises d'annonces VAST et envoie les données de visibilité aux fournisseurs de solutions de mesure spécifiés à l'aide de l'API OMID. Vous pouvez éventuellement définir des règles de mode d'accès pour chaque requête afin de contrôler le contenu auquel le script de vérification peut accéder.

Le SDK IMA est compatible avec la version 1.4 du SDK OM.

Prérequis

  • Si vous utilisez VAST 4.1 ou une version ultérieure, les annonces doivent être configurées pour fournir une validation à l'aide de <AdVerifications>. Si vous utilisez des versions antérieures de VAST, les annonces doivent utiliser <Extension type="AdVerifications">.

  • Si vos annonces sont diffusées via Ad Manager, configurez un fournisseur de mesure de la visibilité pour votre réseau Ad Manager et attribuez-le à votre élément de campagne. Pour en savoir plus, consultez la section Configurer un fournisseur de mesure de la visibilité pour votre réseau Ad Manager.

Modes d'accès

Le SDK OM permet d'exécuter des scripts de validation dans quatre modes d'accès différents, qui contrôlent l'accès du script de validation :

  • FULL : le script de validation a un accès direct à la création et à la page de l'éditeur.

  • CREATIVE: le script de vérification et la création sont placés dans un bac à sable à partir de la page de l'éditeur. Toutefois, le script dispose d'un accès direct à la création.

  • DOMAIN: le script de validation est exécuté en bac à sable et ne peut pas accéder à la création ni à la page de l'éditeur. Cependant, le script est chargé de telle manière qu'il peut confirmer directement le domaine de l'éditeur sur lequel il se trouve.

  • LIMITED: le script de validation est exécuté en bac à sable. Il ne peut pas accéder à la création ni à la page de l'éditeur, et ne peut pas confirmer directement le domaine de l'éditeur sur lequel il se trouve.

Il est possible que certains fournisseurs de solutions de mesure de la visibilité ne soient pas compatibles avec tous les modes d'accès. Contactez vos fournisseurs de mesure de la visibilité pour vérifier les modes compatibles.

Définir les règles de mode d'accès pour une requête

Les règles de mode d'accès doivent être définies au niveau de AdsRequest. Pour définir différents modes d'accès pour différents fournisseurs de scripts de validation, transmettez un dictionnaire mappant chaque OmidVerificationVendor à l'un des modes d'accès répertoriés ci-dessus. Le champ OmidVerificationVendor.OTHER permet de définir le mode d'accès par défaut pour tous les fournisseurs non explicitement inclus dans le dictionnaire. Si aucune règle de mode d'accès n'est spécifiée, les scripts de validation s'exécutent en mode d'accès LIMITED pour les fournisseurs.

Consultez l'exemple suivant, qui définit GOOGLE sur google.ima.OmidAccessMode.FULL. Tous les autres fournisseurs, y compris ceux listés dans OmidVerificationVendor, utilisent par défaut la méthode de configuration de OmidVerificationVendor.OTHER.

request.omidAccessModeRules = {};
request.omidAccessModeRules[google.ima.OmidVerificationVendor.GOOGLE]
    = google.ima.OmidAccessMode.FULL;
request.omidAccessModeRules[google.ima.OmidVerificationVendor.OTHER]
    = google.ima.OmidAccessMode.DOMAIN;

Pour implémenter le mode d'accès CREATIVE, vous devez suivre les deux étapes suivantes :

  1. Placez votre lecteur vidéo dans un iFrame sécurisé, isolé du reste de votre site.

  2. Définissez le paramètre OmidAccessMode de votre partenaire de visibilité sur FULL.