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 doit pouvoir déterminer quand les annonces sont visibles par les utilisateurs afin de pouvoir renvoyer les signaux appropriés au serveur d'annonces. IMA utilise les rapports Active View pour mesurer la visibilité des annonces. Ce guide explique le fonctionnement des rapports Active View avec IMA, ainsi que la manière de vérifier que le SDK est en mesure de capturer correctement les signaux de visibilité.
Fonctionnement des rapports Active View avec le SDK IMA
Active View reçoit des mesures sur cette VideoStreamPlayer (getLocationOnScreen et getGlobalVisibleRect).
Vérifier que le SDK peut mesurer la visibilité des annonces
Pour vérifier si le SDK est capable de capturer des signaux de visibilité, recherchez les requêtes réseau envoyées à https://pagead2.googlesyndication.com/pcs/activeview et recherchez le paramètre mtos. Pour en savoir plus, consultez la section Surveiller la mesure de la vue active.
L'exemple de flux suivant est disponible pour les tests de visibilité:
ID du CMS: "2556080", ID de la vidéo: "tears-of-steel-omid"
Pour tester l'utilisation de ce flux, vérifiez d'abord que ima-test-verification.js est téléchargé dans les journaux réseau, puis qu'un ping est envoyé à https://pagead2.googlesyndication.com/pagead/gen_204 au début de la lecture de l'annonce.
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/08/21 (UTC).
[null,null,["Dernière mise à jour le 2025/08/21 (UTC)."],[[["\u003cp\u003eThe IMA SDK utilizes Active View reporting to determine ad visibility and send signals to the ad server.\u003c/p\u003e\n"],["\u003cp\u003eActive View reporting relies on the \u003ccode\u003eStreamDisplayContainer\u003c/code\u003e and \u003ccode\u003eVideoStreamPlayer\u003c/code\u003e for viewability measurements.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can verify viewability signal capture by checking for \u003ccode\u003eactive_view_vide_measurable_impression\u003c/code\u003e in HTTP requests and the \u003ccode\u003emtos\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eA sample stream (CMS ID: "2556080", video ID: "tears-of-steel-omid") is available for viewability testing.\u003c/p\u003e\n"],["\u003cp\u003eCustom video display implementations may require layout adjustments to ensure accurate viewability metrics are returned.\u003c/p\u003e\n"]]],["The IMA SDK utilizes Active View reporting to gauge ad viewability. This involves creating a `StreamDisplayContainer` with a `VideoStreamPlayer`, enabling Active View to measure it using `getLocationOnScreen` and `getGlobalVisibleRect`. Verification involves checking `HTTP` requests for `active_view_vide_measurable_impression` and the `mtos` parameter. A test stream (CMS ID: \"2556080\", video ID: \"tears-of-steel-omid\") is provided; monitor network logs for `ima-test-verification.js` download and a ping to `https://pagead2.googlesyndication.com/pagead/gen_204`.\n"],null,["# Verify Active View\n\nThe IMA SDK must be able to tell when ads are visible to users so that it can\nsend the correct signals back to the ad server. IMA uses\n[Active View reporting](//support.google.com/admanager/answer/3154105)\nto measure the viewability of ads. This guide explains how Active View\nreporting works with IMA, as well as how to verify that the SDK is able to\ncorrectly capture viewability signals.\n\nHow Active View reporting works with the IMA SDK\n------------------------------------------------\n\n1. The [`StreamDisplayContainer`](/interactive-media-ads/docs/sdks/android/dai/api/reference/com/google/ads/interactivemedia/v3/api/StreamDisplayContainer)\n is created by passing in an instance of\n [`VideoStreamPlayer`](/interactive-media-ads/docs/sdks/android/dai/api/reference/com/google/ads/interactivemedia/v3/api/player/VideoStreamPlayer).\n\n2. Active View receives measurements on that `VideoStreamPlayer`\n (`getLocationOnScreen` and `getGlobalVisibleRect`).\n\nVerifying that the SDK can measure ad viewability\n-------------------------------------------------\n\nTo check whether that the SDK is able to capture viewability signals, look for\nnetwork requests sent to `https://pagead2.googlesyndication.com/pcs/activeview`\nand check for the `mtos` parameter. For more information, see\n[Monitor Active View measurement](//support.google.com/admanager/answer/6123557).\nThe following sample stream is available for viewability testing:\n\n\u003cbr /\u003e\n\nCMS ID: \"2556080\", video ID: \"tears-of-steel-omid\"\n\nTo test using this stream, first check the network logs for\n`ima-test-verification.js` to be downloaded and then a ping fired to\n`https://pagead2.googlesyndication.com/pagead/gen_204` at the start of ad\nplayback.\n\n| **Note:** If you use your own video display and maintain full control over playback, you might need to modify your layout to ensure that the necessary metrics are being correctly returned. For additional assitance, reach out to us on the [IMA support forum](//groups.google.com/g/ima-sdk)."]]
