Pour discuter de nos produits et nous faire part de vos commentaires, rejoignez le canal Discord officiel Ad Manager sur le serveur de la communauté Google Advertising and Measurement.
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 entreprises tierces de mesurer la visibilité et les vérifications. 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 version 1.4.
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">.
Le SDK OM permet d'exécuter des scripts de validation dans quatre modes d'accès différents, qui contrôlent la quantité de données auxquelles le script de validation peut accéder :
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 placés dans un bac à sable à partir de la page de l'éditeur. Toutefois, le script a un accès direct à la création.
LIMITED : le script de validation est placé dans un 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 solutions de mesure de la visibilité ne soient pas compatibles avec tous les modes d'accès. Contactez vos fournisseurs de visibilité pour vérifier les modes compatibles. Auparavant, IMA acceptait un mode d'accès DOMAIN, qui est désormais défini par défaut sur le mode LIMITED.
Définir les règles du mode d'accès pour une demande
Les règles du 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 validation, 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 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, sont définis par défaut sur la valeur de OmidVerificationVendor.OTHER.
Pour implémenter le mode d'accès CREATIVE, vous devez suivre les deux étapes suivantes :
Placez votre lecteur vidéo dans un iFrame sécurisé, isolé du reste de votre site.
Définissez OmidAccessMode sur FULL pour votre partenaire de visibilité.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/05 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/05 (UTC)."],[[["\u003cp\u003eThe IMA SDK for HTML5 utilizes the Open Measurement (OM) SDK for third-party viewability and verification measurement, automatically sending data to specified vendors.\u003c/p\u003e\n"],["\u003cp\u003eAds must be configured to supply verification using \u003ccode\u003e<AdVerifications>\u003c/code\u003e (VAST 4.1+) or \u003ccode\u003e<Extension type="AdVerifications">\u003c/code\u003e (previous VAST versions).\u003c/p\u003e\n"],["\u003cp\u003eFour access modes (FULL, CREATIVE, DOMAIN, LIMITED) control verification script access to the creative and publisher page, impacting the level of data access.\u003c/p\u003e\n"],["\u003cp\u003eAccess mode rules are set at the \u003ccode\u003eAdsRequest\u003c/code\u003e level, allowing customized access for different verification vendors, with \u003ccode\u003eLIMITED\u003c/code\u003e as the default.\u003c/p\u003e\n"],["\u003cp\u003eImplementing \u003ccode\u003eCREATIVE\u003c/code\u003e access mode requires sandboxing the video player in a secure iframe and setting the \u003ccode\u003eOmidAccessMode\u003c/code\u003e to \u003ccode\u003eFULL\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Enable Open Measurement\n\nThe IMA SDK for HTML5 includes the\n[Open Measurement (OM) SDK](//iabtechlab.com/standards/open-measurement-sdk/),\nan industry standard developed by the\n[Interactive Advertising Bureau (IAB)](//www.iab.com/) to enable third-party\nviewability and verification measurement. When using the IMA SDK for HTML5, the\nincluded OM SDK automatically parses the `\u003cAdVerifications\u003e` tag within VAST ad\ntags and sends viewability data to the specified measurement vendors using the\nOMID API. You can optionally set access mode rules for each request to control\nwhat content the verification script can access.\n\nThe IMA SDK supports OM SDK v1.4.\n\nPrerequisites\n-------------\n\n- If using VAST 4.1 or higher, ads must be configured to supply verification\n using `\u003cAdVerifications\u003e`. If using previous VAST versions, ads must use\n `\u003cExtension type=\"AdVerifications\"\u003e`.\n\n- If your ads are trafficked through Ad Manager, configure a viewability\n provider for your Ad Manager network and assign that viewability provider to\n your line item. For more information, see\n [Configure a viewability provider for your Ad Manager network](//support.google.com/admanager/answer/9025968#configure-a-viewability-provider).\n\nAccess modes\n------------\n\nThe OM SDK supports running verification scripts in four different access modes\nwhich controls how much the verification script can access:\n\n- `FULL`: The verification script has direct access to the creative and the\n publisher page.\n\n- `CREATIVE`: The verification script and creative are sandboxed from the\n publisher page. However, the script has direct access to the creative.\n\n- `LIMITED`: The verification script is sandboxed and cannot access the creative\n or publisher page, and cannot directly confirm what publisher domain it is on.\n\nSome viewability providers might not support all access modes. Contact your\nviewability providers to verify which modes are supported. Previously, IMA\nsupported a `DOMAIN` access mode, which now defaults to `LIMITED` mode.\n\nSet the access mode rules for a request\n---------------------------------------\n\nAccess mode rules must be set at the [`AdsRequest`](/interactive-media-ads/docs/sdks/html5/client-side/reference/js/google.ima.AdsRequest#omidAccessModeRules) level. To set different access modes for different verification script providers, pass a dictionary that maps each [`OmidVerificationVendor`](/interactive-media-ads/docs/sdks/html5/client-side/reference/js/google.ima#.OmidVerificationVendor) to one of the access modes listed above. The `OmidVerificationVendor.OTHER` field is used to set the default access mode for all vendors not explicitly included in the dictionary. If no access mode rules are specified, verification scripts run in `LIMITED` access mode for vendors.\n\n\u003cbr /\u003e\n\nSee the following example which sets `GOOGLE` to\n`google.ima.OmidAccessMode.FULL`. All other providers, including those\nlisted in\n[`OmidVerificationVendor`](/interactive-media-ads/docs/sdks/html5/client-side/reference/js/google.ima#.OmidVerificationVendor),\ndefault to how `OmidVerificationVendor.OTHER` is set. \n\n request.omidAccessModeRules = {};\n request.omidAccessModeRules[google.ima.OmidVerificationVendor.GOOGLE]\n = google.ima.OmidAccessMode.FULL;\n request.omidAccessModeRules[google.ima.OmidVerificationVendor.OTHER]\n = google.ima.OmidAccessMode.LIMITED;\n\n\nTo implement `CREATIVE` access mode, you must follow both of the following\nsteps:\n\n1. Sandbox your video player in a secure iframe, isolated from the rest of your\n site.\n\n2. Set the `OmidAccessMode` for your viewability partner to `FULL`."]]
