Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
NonceManager
classpublic
Administra un nonce y sus informes de eventos para una sola sesión de reproducción de contenido.
Se debe llamar a los métodos del ciclo de vida de la sesión de reproducción de contenido, incluidos sendAdClick, sendAdTouch, sendPlaybackStart y sendPlaybackEnd, ya que se producen estos eventos respectivos para habilitar la monetización programática.
Métodos
getNonce
público
getNonce() muestra una cadena.
Devuelve
string El nonce que se generó para este administrador cuando se cargó.
Este valor nunca cambiará para una instancia NonceManager determinada. Este valor de nonce solo es válido para una única sesión de reproducción de contenido con una duración máxima de 6 horas.
sendAdClick
público
sendAdClick() muestra 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.
Devuelve
void
sendAdImpression
público
sendAdImpression() muestra void.
Se debería llamar cuando se muestre el primer fotograma del anuncio que se solicitó con el nonce que generó este administrador.
Funciones obsoletas
En su lugar, usa `sendPlaybackStart` y `sendPlaybackEnd`.
Devuelve
void
sendAdTouch
público
sendAdTouch(clickOrTouchEvent) muestra el resultado.
Notifica a los servidores de anuncios de Google que un usuario toca o hace clic en el anuncio en lugar de un clic (por ejemplo, omitir, silenciar, presionar y más) durante la sesión de reproducción de contenido determinada.
Parámetro
clickOrTouchEvent
(MouseEvent no nulo o TouchEvent no nulo)
El evento táctil o de clic del navegador que se activó para la interacción del usuario
Devuelve
void
sendPlaybackEnd
público
El valor de sendPlaybackEnd() muestra el resultado nulo.
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 (por ejemplo, cuando el reproductor llega al final de la transmisión, cuando el usuario la abandona en medio de la reproducción, cuando el usuario abandona la página o cuando pasa 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.
Devuelve
void
sendPlaybackStart
público
sendPlaybackStart() muestra 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 debería invocar en "inicio del reproductor de video". Puede deberse 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 detección del IVT.
[null,null,["Última actualización: 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`"]]
