Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
NonceManager
classpublic
Gestisce un nonce e la relativa segnalazione di eventi per una singola sessione di riproduzione dei contenuti.
I metodi del ciclo di vita della sessione di riproduzione dei contenuti, tra cui sendAdClick,
sendTouch, sendPlaybackStart e sendPlaybackEnd, devono essere chiamati quando
si verificano questi rispettivi eventi per attivare la monetizzazione programmatica.
Metodi
getNonce
public
getNonce() restituisce stringa
Resi
string Il nonce generato per questo amministratore al momento del caricamento.
Questo valore non cambierà mai per una determinata istanza di NonceManager. Questo valore nonce è valido solo per una singola sessione di riproduzione dei contenuti per una durata massima di 6 ore.
sendAdClick
public
sendAdClick() restituisce void
Comunica agli ad server di Google che si è verificato un clic passante su un annuncio durante
la sessione di riproduzione dei contenuti specificata.
Resi
void
sendAdImpression
public
sendAdImpression() restituisce void
Deve essere chiamato quando viene visualizzato il primo fotogramma dell'annuncio richiesto con
il nonce generato da questo gestore.
Deprecato
Utilizza invece `sendPlaybackStart` e `sendPlaybackEnd`.
Comunica ai server pubblicitari di Google che durante la sessione di riproduzione dei contenuti specificata si è verificato un tocco o un clic dell'utente sull'annuncio diverso da un clickthrough (ad es. salto, disattivazione dell'audio, tocco e così via).
Parametro
userInteractionEvent
cast.framework.events.Event
L'evento di interazione utente attivato dal framework Cast.
Il valore non deve essere null.
Resi
void
sendPlaybackEnd
public
sendPlaybackEnd() restituisce void
Notifica ai server pubblicitari di Google che la riproduzione per la sessione di riproduzione dei contenuti specificata è terminata. Questo metodo deve essere chiamato al termine della riproduzione (ad es. quando il
player raggiunge la fine dello stream, quando l'utente esce dalla riproduzione a metà, quando l'utente lascia la pagina o quando passa all'elemento di contenuti successivo
in un'impostazione della playlist).
Questo metodo termina le chiamate asincrone ai server di Google avviate in
sendPlaybackStart.
Resi
void
sendPlaybackStart
public
sendPlaybackStart() restituisce void
Comunica ai server pubblicitari di Google che è iniziata la riproduzione per la sessione di riproduzione dei contenuti specificata. Deve essere chiamato all'"avvio del video player". Ciò
può avvenire in risposta a un'azione avviata dall'utente (riproduzione con clic) o a un'azione avviata dalla pagina (riproduzione automatica).
Questo metodo avvierà chiamate asincrone ai server di Google per raccogliere
gli indicatori necessari per il monitoraggio e il rilevamento del traffico non valido.
[null,null,["Ultimo aggiornamento 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`"]]
