IMA SDK는 광고가 사용자에게 표시되는 시점을 파악하여 올바른 신호를 광고 서버로 다시 전송할 수 있어야 합니다. IMA는 Active View 보고를 사용하여 광고의 조회가능성을 측정합니다. 이 가이드에서는 Active View 보고가 IMA와 함께 작동하는 방식과 SDK가 조회가능성 신호를 올바르게 캡처할 수 있는지 확인하는 방법을 설명합니다.
StreamRequest이 발생할 때 동영상 요소가 표시되고 가려지지 않는 한 Active View는 해당 요소에 대한 측정값을 수신합니다.
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 leverages Active View reporting to determine ad visibility and send corresponding signals to the ad server.\u003c/p\u003e\n"],["\u003cp\u003ePublishers need to designate a video element during StreamManager creation for Active View to measure viewability.\u003c/p\u003e\n"],["\u003cp\u003eVerifying successful viewability signal capture involves checking for specific parameters within HTTP requests and network logs.\u003c/p\u003e\n"],["\u003cp\u003eA sample stream with CMS ID "2556080" and video ID "tears-of-steel-omid" is available for testing viewability implementation.\u003c/p\u003e\n"],["\u003cp\u003ePublishers with custom video displays might need layout adjustments to ensure accurate metric returns and can consult the IMA support forum for assistance.\u003c/p\u003e\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 publisher designates a video element when creating the\n [`StreamManager`](/interactive-media-ads/docs/sdks/html5/dai/reference/js/StreamManager).\n\n2. As long as the video element is viewable and unobstructed when the\n [`StreamRequest`](/interactive-media-ads/docs/sdks/html5/dai/reference/js/StreamRequest)\n is made, Active View receives measurements on that element.\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)."]]
