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 la mesure de la visibilité et de la validation par des tiers. Lorsque vous utilisez le SDK IMA pour HTML5, le SDK OM inclus analyse automatiquement le tag <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. 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 validation peut accéder.

Le SDK IMA est compatible avec le SDK OM version1,4.

Conditions préalables

  • Si vous utilisez VAST 4.1 ou une version ultérieure, vous devez configurer les annonces de manière à fournir une validation via <AdVerifications>. Si vous utilisez des versions VAST précédentes, les annonces doivent utiliser <Extension type="AdVerifications">.

  • Si vos annonces font l'objet d'un trafficking 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 Configurer un fournisseur de mesure de la visibilité pour votre réseau Ad Manager.

Modes d'accès

Le SDK OM prend en charge l'exécution de scripts de validation dans quatre modes d'accès différents, qui contrôlent les niveaux d'accès du script de vérification:

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

  • CREATIVE: le script de validation et la création sont hébergé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 manière à pouvoir confirmer directement le domaine de l'éditeur sur lequel il se trouve.

  • LIMITED: 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. Il ne peut pas non plus confirmer directement le domaine de l'éditeur sur lequel il se trouve.

Il est possible que certains fournisseurs de mesure de la visibilité n'acceptent pas tous les modes d'accès. Contactez vos fournisseurs de mesure de la visibilité pour vérifier quels modes sont compatibles.

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

Les règles de mode d'accès doivent être définies au niveau AdsRequest. Pour définir différents modes d'accès pour différents fournisseurs de scripts de vérification, transmettez un dictionnaire qui mappe 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 qui ne sont pas 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 OmidVerificationVendor.OTHER par défaut.

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. Mettez votre lecteur vidéo en bac à sable dans un iFrame sécurisé, isolé du reste de votre site.

  2. Définissez la valeur OmidAccessMode de votre partenaire de visibilité sur FULL.