IMA SDK는 광고가 사용자에게 표시되는 시점을 파악하여 올바른 신호를 광고 서버로 다시 전송할 수 있어야 합니다. IMA는 Active View 보고를 사용하여 광고의 조회가능성을 측정합니다. 이 가이드에서는 Active View 보고가 IMA와 함께 작동하는 방식과 SDK가 조회가능성 신호를 올바르게 캡처할 수 있는지 확인하는 방법을 설명합니다.
Active View는 해당 VideoStreamPlayer(getLocationOnScreen 및 getGlobalVisibleRect)에 대한 측정값을 수신합니다.
SDK가 광고 조회가능성을 측정할 수 있는지 확인
SDK가 조회가능성 신호를 캡처할 수 있는지 확인하려면 https://pagead2.googlesyndication.com/pcs/activeview로 전송된 네트워크 요청을 찾고 mtos 매개변수를 확인합니다. 자세한 내용은 Active View 측정 모니터링을 참고하세요.
조회가능성 테스트에 사용할 수 있는 샘플 스트림은 다음과 같습니다.
CMS ID: '2556080', 동영상 ID: 'tears-of-steel-omid'
이 스트림을 사용하여 테스트하려면 먼저 다운로드할 ima-test-verification.js가 있는지 네트워크 로그를 확인한 다음 광고 재생이 시작될 때 https://pagead2.googlesyndication.com/pagead/gen_204에 전송된 핑을 확인합니다.
[null,null,["최종 업데이트: 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)."]]
