Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
NonceManager
classpublic
Gerencia um nonce e o relatório de eventos dele para uma única sessão de
reprodução de conteúdo.
Os métodos de ciclo de vida da sessão de reprodução de conteúdo, incluindo sendAdClick,
sendTouch, sendPlaybackStart e sendPlaybackEnd, precisam ser chamados à medida que
esses eventos respectivos ocorrem para ativar a monetização programática.
Métodos
getNonce
público
getNonce() retorna string
Retorna
string O nonce gerado para este gerenciador quando ele foi carregado.
Esse valor nunca muda para uma determinada instância de NonceManager. Esse valor de nonce é válido apenas para uma sessão de reprodução de conteúdo com duração máxima de 6 horas.
sendAdClick
público
sendAdClick() retorna void
Notifica os servidores de anúncios do Google de que um click-through em um anúncio ocorreu durante
a sessão de reprodução de conteúdo especificada.
Retorna
void
sendAdImpression
público
sendAdImpression() retorna void
Deve ser chamado quando o primeiro frame do anúncio solicitado com
o nonce gerado por este gerenciador for exibido.
Descontinuado
Use `sendPlaybackStart` e `sendPlaybackEnd`.
Retorna
void
sendAdTouch
público
sendAdTouch(userInteractionEvent) retorna void
Notifica os servidores de anúncios do Google de que um toque ou clique do usuário no anúncio que não seja
um clique (por exemplo, pular, silenciar, tocar etc.) ocorreu durante a sessão de
reprodução de conteúdo especificada.
Parâmetro
userInteractionEvent
cast.framework.events.Event
O evento de interação do usuário disparado pelo framework do Cast.
O valor não pode ser nulo.
Retorna
void
sendPlaybackEnd
público
sendPlaybackEnd() retorna void
Notifica os servidores de anúncios do Google de que a reprodução da sessão de reprodução de conteúdo especificada terminou. Isso deve 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 dela, ou
quando o usuário sai da página ou quando avança 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úblico
sendPlaybackStart() retorna void
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. Isso precisa ser chamado no "início do player de vídeo". Isso
pode ser em resposta a uma ação iniciada pelo usuário (clicar para reproduzir) ou a uma ação
iniciada pela página (reprodução automática).
Esse método inicia chamadas assíncronas para servidores do Google para coletar
os indicadores necessários para o monitoramento e a detecção de IVT.
[null,null,["Última atualização 2025-08-21 UTC."],[[["\u003cp\u003eThe NonceManager class manages a unique nonce and reports events for a single content playback session, enabling programmatic monetization.\u003c/p\u003e\n"],["\u003cp\u003eTo enable programmatic monetization, you must call specific lifecycle methods like \u003ccode\u003esendAdClick\u003c/code\u003e, \u003ccode\u003esendTouch\u003c/code\u003e, \u003ccode\u003esendPlaybackStart\u003c/code\u003e, and \u003ccode\u003esendPlaybackEnd\u003c/code\u003e when their corresponding events occur.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egetNonce()\u003c/code\u003e provides a unique nonce for the session, valid for a single playback up to 6 hours.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003esendPlaybackStart()\u003c/code\u003e and \u003ccode\u003esendPlaybackEnd()\u003c/code\u003e should be used to signal the start and end of content playback to Google ad servers, replacing the deprecated \u003ccode\u003esendAdImpression\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eOther methods like \u003ccode\u003esendAdClick\u003c/code\u003e and \u003ccode\u003esendAdTouch\u003c/code\u003e allow reporting of ad interactions for comprehensive monetization tracking.\u003c/p\u003e\n"]]],["The `NonceManager` class manages a unique nonce for a single content playback session, valid for up to 6 hours. Key actions include: retrieving the nonce via `getNonce()`; notifying ad server events with `sendAdClick()`, `sendAdTouch()`, and `sendAdImpression()`; and signaling the start and end of a playback session via `sendPlaybackStart()` and `sendPlaybackEnd()`. `sendPlaybackStart()` begins background monitoring while `sendPlaybackEnd()` concludes it.\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`sendTouch`, `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 nonce value is only valid for a single content playback session up to a 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(userInteractionEvent) returns void\n\nNotifies Google ad servers that a user touch or click on the ad other than\na clickthrough (e.g. skip, mute, tap, etc.) has occurred during the given\ncontent playback session.\n\n| #### Parameter ||\n|----------------------|-------------------------------------------------------------------------------------------------------------|\n| userInteractionEvent | cast.framework.events.Event The user interaction event fired by the Cast framework. Value must not be null. |\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 (e.g. when the\nplayer reaches end of stream, or when the user exits playback mid-way, or\nwhen the user leaves the page, or when advancing to the next content item\nin 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`"]]
