Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
NonceManager
classpublic
Administra un nonce y su informe de eventos para una sola sesión de reproducción de contenido.
Los métodos del ciclo de vida de la sesión de reproducción de contenido, incluidos sendAdClick, sendTouch, sendPlaybackStart y sendPlaybackEnd, se deben llamar a medida que ocurren estos eventos respectivos para habilitar la monetización programática.
Métodos
getNonce
público
getNonce() devuelve una cadena
Muestra
string Es el nonce que se generó para este administrador cuando se cargó.
Este valor nunca cambiará para una instancia de NonceManager determinada. Este valor de nonce solo es válido para una sola sesión de reproducción de contenido con una duración máxima de 6 horas.
sendAdClick
público
sendAdClick() devuelve void
Notifica a los servidores de anuncios de Google que se produjo un clic en un anuncio durante la sesión de reproducción de contenido determinada.
Muestra
void
sendAdImpression
público
sendAdImpression() devuelve void
Se debe llamar cuando se muestre el primer fotograma del anuncio que se solicitó con el nonce generado por este administrador.
Obsoleto
En su lugar, usa `sendPlaybackStart` y `sendPlaybackEnd`.
Muestra
void
sendAdTouch
público
sendAdTouch(userInteractionEvent) devuelve void
Notifica a los servidores de anuncios de Google que se produjo un toque o clic del usuario en el anuncio que no es un clic directo (p.ej., omitir, silenciar, presionar, etc.) durante la sesión de reproducción de contenido determinada.
Parámetro
userInteractionEvent
cast.framework.events.Event
Es el evento de interacción del usuario que activó el framework de Cast.
El valor no debe ser nulo.
Muestra
void
sendPlaybackEnd
público
sendPlaybackEnd() devuelve void
Notifica a los servidores de anuncios de Google que finalizó la reproducción de la sesión de reproducción de contenido determinada. Se debe llamar a este método cuando finaliza la reproducción (p.ej., cuando el reproductor llega al final de la transmisión, cuando el usuario sale de la reproducción a mitad de camino, cuando el usuario abandona la página o cuando avanza al siguiente elemento de contenido en la configuración de una playlist).
Este método finaliza las llamadas asíncronas a los servidores de Google que se iniciaron en sendPlaybackStart.
Muestra
void
sendPlaybackStart
público
sendPlaybackStart() devuelve void
Notifica a los servidores de anuncios de Google que se inició la reproducción de la sesión de reproducción de contenido determinada. Se debe llamar a este método cuando se inicie el reproductor de video. Esto puede ocurrir en respuesta a una acción iniciada por el usuario (clic para reproducir) o una acción iniciada por la página (reproducción automática).
Este método iniciará llamadas asíncronas a los servidores de Google para recopilar los indicadores necesarios para la supervisión y la detección de IVT.
[null,null,["Última actualización: 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`"]]
