Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O SDK do IMA precisa ser capaz de informar quando os anúncios estão visíveis para os usuários para que ele possa
enviar os indicadores corretos de volta ao servidor de anúncios. O IMA usa
relatórios do Active View
para medir a visibilidade dos anúncios. Este guia explica como os relatórios do Active View funcionam com o IMA e como verificar se o SDK consegue capturar corretamente os indicadores de visibilidade.
Como os relatórios do Active View funcionam com o SDK do IMA
O Active View recebe medições sobre esse VideoStreamPlayer
(getLocationOnScreen e getGlobalVisibleRect).
Como verificar se o SDK pode medir a visibilidade do anúncio
Para verificar se o SDK consegue capturar indicadores de visibilidade, procure
solicitações de rede enviadas para https://pagead2.googlesyndication.com/pcs/activeview
e verifique o parâmetro mtos. Para mais informações, consulte
Monitorar a medição da visualização ativa.
O seguinte stream de exemplo está disponível para testes de visibilidade:
ID do CMS: "2556080", ID do vídeo: "tears-of-steel-omid"
Para testar o uso desse stream, primeiro verifique se os registros de rede mostram que
ima-test-verification.js foi feito o download e, em seguida, se um ping foi disparado para
https://pagead2.googlesyndication.com/pagead/gen_204 no início da reprodução
do anúncio.
[null,null,["Última atualização 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)."]]
