Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
NonceManager
classpublic
Gère un nonce et son signalement d'événement pour une seule session de lecture de contenu.
Les méthodes de cycle de vie de la session de lecture de contenu, y compris sendAdClick, sendTouch, sendPlaybackStart et sendPlaybackEnd, doivent être appelées lorsque ces événements respectifs se produisent afin d'activer la monétisation programmatique.
Méthodes
getNonce
public
getNonce() renvoie une chaîne
Renvoie
string Nonce généré pour ce gestionnaire lors de son chargement.
Cette valeur ne changera jamais pour une instance NonceManager donnée. Cette valeur nonce n'est valide que pour une seule session de lecture de contenu, pour une durée maximale de six heures.
sendAdClick
public
sendAdClick() renvoie void
Avertit les ad servers Google qu'un clic sur une annonce a eu lieu pendant la session de lecture du contenu spécifiée.
Renvoie
void
sendAdImpression
public
sendAdImpression() renvoie void
Doit être appelé lorsque le premier frame de l'annonce demandée avec le nonce généré par ce gestionnaire est affiché.
Obsolète
Utilisez plutôt `sendPlaybackStart` et `sendPlaybackEnd`.
Renvoie
void
sendAdTouch
public
sendAdTouch(userInteractionEvent) returns void
Avertit les serveurs publicitaires Google qu'un utilisateur a appuyé sur l'annonce ou cliqué dessus (autrement que pour accéder au site de l'annonceur, par exemple pour la fermer, la couper, appuyer dessus, etc.) pendant la session de lecture du contenu.
Paramètre
userInteractionEvent
cast.framework.events.Event
Événement d'interaction utilisateur déclenché par le framework Cast.
La valeur ne doit pas être nulle.
Renvoie
void
sendPlaybackEnd
public
sendPlaybackEnd() renvoie void
Avertit les serveurs publicitaires Google que la lecture de la session de lecture de contenu donnée est terminée. Cet événement doit être appelé lorsque la lecture se termine (par exemple, lorsque le lecteur atteint la fin du flux, lorsque l'utilisateur quitte la lecture à mi-parcours, lorsqu'il quitte la page ou lorsqu'il passe à l'élément de contenu suivant dans un paramètre de playlist).
Cette méthode met fin aux appels asynchrones aux serveurs Google lancés dans sendPlaybackStart.
Renvoie
void
sendPlaybackStart
public
sendPlaybackStart() renvoie void
Avertit les serveurs publicitaires Google que la lecture de la session de lecture de contenu donnée a commencé. Cette méthode doit être appelée au début de la lecture de la vidéo. Cela peut se produire en réponse à une action lancée par l'utilisateur (clic pour lire) ou par la page (lecture automatique).
Cette méthode lance des appels asynchrones aux serveurs Google pour collecter les signaux nécessaires à la surveillance et à la détection du trafic incorrect.
Renvoie
void
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/21 (UTC).
[null,null,["Dernière mise à jour le 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`"]]
