Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
NonceManager
classpublic
Gestisce un nonce e i relativi report sugli eventi per una singola sessione di riproduzione dei contenuti.
I metodi del ciclo di vita della sessione di riproduzione dei contenuti, tra cui sendAdClick,
sendAdTouch, sendPlaybackStart e sendPlaybackEnd, devono essere richiamati quando
questi rispettivi eventi si verificano per abilitare la monetizzazione programmatica.
Metodi
getNonce
pubblico
getNonce() restituisce stringa
Ritorni
string Il nonce generato per questo gestore al momento del caricamento.
Questo valore non cambierà mai per una determinata istanza NonceManager. Questo valore nonce è valido solo per una singola sessione di riproduzione di contenuti fino a una durata massima di 6 ore.
sendAdClick
pubblico
sendAdClick() restituisce void
Comunica agli ad server di Google che si è verificato un clickthrough su un annuncio durante la sessione di riproduzione dei contenuti specificata.
Ritorni
void
sendAdImpression
pubblico
sendAdImpression() restituisce void
Deve essere chiamato quando viene visualizzato il primo frame dell'annuncio richiesto con il nonce generato da questo gestore.
Deprecata
Usa invece "sendPlaybackStart" e "sendPlaybackEnd".
Ritorni
void
sendAdTouch
pubblico
sendAdTouch(clickOrTouchEvent) restituisce void
Comunica agli ad server di Google che un utente ha toccato o fatto clic sull'annuncio in modo diverso da un clickthrough (ad esempio, salta, disattiva l'audio, tocca e altro ancora) durante la sessione di riproduzione dei contenuti specifica.
Parametro
clickOrTouchEvent
(MouseEvent non null o TouchEvent non null)
L'evento di tocco o clic del browser attivato per l'interazione dell'utente.
Ritorni
void
sendPlaybackEnd
pubblico
sendRiproduzioneEnd() restituisce void
Comunica agli ad server di Google che la riproduzione della sessione di riproduzione dei contenuti specificata è terminata. Questo comando va richiamato al termine della riproduzione (ad esempio,
quando il player raggiunge la fine dello stream, quando l'utente ne esce a metà, quando abbandona la pagina o quando passa al contenuto successivo
in un'impostazione della playlist).
Questo metodo termina le chiamate asincrone ai server Google avviate in sendPlaybackStart.
Ritorni
void
sendPlaybackStart
pubblico
sendRiproduzioneStart() restituisce void
Comunica all'ad server di Google che è iniziata la riproduzione della sessione di riproduzione dei contenuti specificata. Il nome deve essere chiamato "avvio del video player". Ciò potrebbe essere in risposta a un'azione avviata dall'utente (click-to-play) o a un'azione avviata dalla pagina (riproduzione automatica).
Questo metodo avvierà chiamate asincrone ai server Google per raccogliere gli indicatori necessari per il monitoraggio e il rilevamento dell'IVT.
[null,null,["Ultimo aggiornamento 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`"]]
