Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
NonceManager
classepublic
Gerencia um valor de uso único e os relatórios de eventos dele para uma única sessão de reprodução de
conteúdo.
Os métodos do ciclo de vida da sessão de reprodução de conteúdo, incluindo sendAdClick, sendAdTouch, sendPlaybackStart e sendPlaybackEnd, precisam ser chamados quando esses respectivos eventos ocorrem para ativar a monetização programática.
Métodos
getNonce
públicas
getNonce() retorna uma string
Retorna
string O valor de uso único gerado para esse administrador quando ele foi carregado.
Esse valor nunca muda para uma determinada instância de NonceManager. Esse
valor de uso único é válido somente para uma única sessão de reprodução de conteúdo até uma
duração máxima de seis horas.
sendAdClick
públicas
sendAdClick() retorna nulo
Notifica os servidores de anúncios do Google de que um clique em um anúncio ocorreu durante
a sessão determinada de reprodução de conteúdo.
Retorna
void
sendAdImpression
públicas
sendAdImpression() retorna nulo
Deve ser chamado quando o primeiro frame do anúncio solicitado com o valor de uso único gerado por esse gerenciador é exibido.
Descontinuado
Use "sendPlaybackStart" e "sendPlaybackEnd".
Retorna
void
sendAdTouch
públicas
sendAdTouch(clickOrTouchEvent) retorna nulo
Notifica os servidores de anúncios do Google de que um usuário tocou ou clicou no anúncio que não foi clicado (por exemplo, pular, desativar som, tocar etc.) durante a sessão específica de reprodução de conteúdo.
Parâmetro
clickOrTouchEvent
(MouseEvent não nulo ou TouchEvent não nulo)
O evento de toque ou clique do navegador que foi disparado para a interação do usuário.
Retorna
void
sendPlaybackEnd
públicas
sendPlaybackEnd() retorna nulo
Notifica os servidores de anúncios do Google de que a reprodução da sessão de reprodução de conteúdo especificada foi encerrada. Precisa ser chamado quando a reprodução termina (por exemplo, quando o player chega ao fim do stream, quando o usuário sai da reprodução no meio da reprodução, quando o usuário sai da página ou ao avançar para o próximo item de conteúdo em uma configuração de playlist).
Esse método encerra as chamadas assíncronas para os servidores do Google iniciadas em
sendPlaybackStart.
Retorna
void
sendPlaybackStart
públicas
sendPlaybackStart() retorna nulo
Notifica os servidores de anúncios do Google de que a reprodução da sessão de reprodução de conteúdo especificada foi iniciada. Deve ser chamado na "inicialização do player de vídeo". Isso pode ser em resposta a uma ação iniciada pelo usuário (reproduzir com um clique) ou a uma ação iniciada pela página (reprodução automática).
Esse método vai iniciar chamadas assíncronas aos servidores do Google a fim de coletar
sinais necessários para o monitoramento e a detecção de IVT.
[null,null,["Última atualização 2025-08-21 UTC."],[[["\u003cp\u003eThe Programmatic Access Libraries automatically collect data like IP address, user interactions, diagnostics, and device identifiers for advertising and analytics.\u003c/p\u003e\n"],["\u003cp\u003eThis data is shared for purposes of advertising, analytics, and fraud prevention and is encrypted during transmission using TLS protocol.\u003c/p\u003e\n"],["\u003cp\u003eApp developers can control the collection of Android advertising IDs and explore features like Limited Ads for data management.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers are responsible for disclosing data collection and usage practices in the Google Play Data safety section based on their app's specific implementation and features used.\u003c/p\u003e\n"],["\u003cp\u003eThis page focuses on the latest version of the Programmatic Access Libraries; developers should update to the latest version and review this page regularly to ensure accurate disclosures.\u003c/p\u003e\n"]]],[],null,["# Class: NonceManager\n\nNonceManager\n============\n\nclass public\n\nManages a nonce and its event reporting for a single content playback\nsession.\nThe content playback session lifecycle methods, including `sendAdClick`,\n`sendAdTouch`, `sendPlaybackStart`, and `sendPlaybackEnd` must be called as\nthese respective events occur in order to enable programmatic monetization.\n\nMethods\n-------\n\n### getNonce\n\npublic\n\ngetNonce() returns string\n\nReturns\n\n: `string` The nonce generated for this manager when it was loaded.\n This value will never change for a given `NonceManager` instance. This\n nonce value is only valid for a single content playback session up to a\n maximum duration of 6 hours.\n\n### sendAdClick\n\npublic\n\nsendAdClick() returns void\n\nNotifies Google ad servers that a clickthrough on an ad has occurred during\nthe given content playback session.\n\nReturns\n\n: `void`\n\n### sendAdImpression\n\npublic\n\nsendAdImpression() returns void\n\nShould be called when the first frame of the ad that was requested with\nthe nonce generated by this manager is displayed.\n\nDeprecated\n: Use \\`sendPlaybackStart\\` and \\`sendPlaybackEnd\\` instead.\n\nReturns\n\n: `void`\n\n### sendAdTouch\n\npublic\n\nsendAdTouch(clickOrTouchEvent) returns void\n\nNotifies Google ad servers that a user touch or click on the ad other than\na clickthrough (for example, skip, mute, tap, and more.) has occurred\nduring the given content playback session.\n\n| #### Parameter ||\n|-------------------|------------------------------------------------------------------------------------------------------------------------|\n| clickOrTouchEvent | (non-null MouseEvent or non-null TouchEvent) The browser touch or click event that was fired for the user interaction. |\n\nReturns\n\n: `void`\n\n### sendPlaybackEnd\n\npublic\n\nsendPlaybackEnd() returns void\n\nNotifies Google ad servers that playback for the given content playback\nsession has ended. This should be called when playback ends (for example,\nwhen the player reaches end of stream, or when the user exits playback\nmid-way, or when the user leaves the page, or when advancing to the next\ncontent item in a playlist setting).\n\nThis method ends the asynchronous calls to Google servers started in\n`sendPlaybackStart`.\n\nReturns\n\n: `void`\n\n### sendPlaybackStart\n\npublic\n\nsendPlaybackStart() returns void\n\nNotifies Google ad servers that playback for the given content playback\nsession has started. This should be called on \"video player start\". This\nmay be in response to a user-initiated action (click-to-play) or a page\ninitiated action (autoplay).\n\nThis method will start asynchronous calls to Google servers to collect\nsignals needed for IVT monitoring and detection.\n\nReturns\n\n: `void`"]]
