Activer Open Measurement

Sélectionner une plate-forme : HTML5 Android iOS

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 vérification par des tiers. Lorsque vous utilisez le SDK IMA pour HTML5, 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. Vous pouvez également 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 le SDK OM v1.6.

Prérequis

  • Si vous utilisez VAST 4.1 ou une version ultérieure, les annonces doivent être configurées pour fournir une vérification à l'aide de <AdVerifications>. Si vous utilisez des versions VAST antérieures, 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 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 vérification dans quatre modes d'accès différents, qui contrôlent le niveau d'accès du script de vérification :

  • FULL: le script de vérification 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 mis en bac à sable à partir de la page de l'éditeur. Toutefois, le script a un accès direct à la création.

  • LIMITED: le script de vérification est mis 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é 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. Auparavant, IMA était compatible avec un mode d'accès DOMAIN, qui est désormais défini par défaut sur le mode LIMITED.

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 AdsRequest niveau. 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 listé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 vérification 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, sont définis par défaut sur la valeur de OmidVerificationVendor.OTHER.

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

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 OmidAccessMode sur FULL pour votre partenaire de mesure de la visibilité.