Verify Active View

AI-generated Key Takeaways

• IMA SDK uses Active View reporting to measure ad viewability.

• Active View receives measurements on the VideoStreamPlayer instance passed to the StreamDisplayContainer.

• You can verify the SDK's ability to capture viewability signals by looking for network requests to https://pagead2.googlesyndication.com/pcs/activeview and checking the mtos parameter.

• A sample stream is available for testing viewability using CMS ID "2556080" and video ID "tears-of-steel-omid".

Select platform: HTML5 Android iOS

The IMA SDK must be able to tell when ads are visible to users so that it can send the correct signals back to the ad server. IMA uses Active View reporting to measure the viewability of ads. This guide explains how Active View reporting works with IMA, as well as how to verify that the SDK is able to correctly capture viewability signals.

How Active View reporting works with the IMA SDK

1. The StreamDisplayContainer is created by passing in an instance of VideoStreamPlayer.

2. Active View receives measurements on that VideoStreamPlayer (getLocationOnScreen and getGlobalVisibleRect).

Verifying that the SDK can measure ad viewability

To check whether that the SDK is able to capture viewability signals, look for network requests sent to https://pagead2.googlesyndication.com/pcs/activeview and check for the mtos parameter. For more information, see Monitor Active View measurement.

The following sample stream is available for viewability testing:

CMS ID: "2556080", video ID: "tears-of-steel-omid"

To test using this stream, first check the network logs for ima-test-verification.js to be downloaded and then a ping fired to https://pagead2.googlesyndication.com/pagead/gen_204 at the start of ad playback.

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.