Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
NonceManager
classpublic
Gère un nonce et ses rapports sur les événements pour une seule session de lecture de contenu.
Les méthodes du cycle de vie de la session de lecture de contenu, y compris sendAdClick, sendAdTouch, sendPlaybackStart et sendPlaybackEnd, doivent être appelées lorsque ces événements respectifs se produisent afin d'activer la monétisation programmatique.
Méthodes
getNonce
publics
getNonce() renvoie une chaîne.
Renvoie
string nonce généré pour ce gestionnaire lors de son chargement.
Cette valeur ne sera jamais modifiée 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
publics
sendAdClick() renvoie vide
Notifie les serveurs publicitaires Google qu'un clic sur une annonce s'est produit pendant la session de lecture de contenu donnée.
Renvoie
void
sendAdImpression
publics
sendAdImpression() renvoie vide
Doit être appelé lorsque le premier frame de l'annonce demandé avec le nonce généré par ce gestionnaire est affiché.
Obsolète
Utilisez plutôt "sendPlaybackStart" et "sendPlaybackEnd".
Renvoie
void
sendAdTouch
publics
sendAdTouch(clickOrTouchEvent) renvoie la valeur "void"
Notifie les serveurs publicitaires Google qu'un utilisateur appuie ou clique sur l'annonce, autrement qu'en cliquant sur l'annonce (par exemple, ignorer, couper le son, appuyer, etc.) au cours de la session de lecture de contenu en question.
Paramètres
clickOrTouchEvent
(Événement MouseEvent non nul ou TouchEvent non nul)
Événement de clic ou d'appui sur le navigateur qui a été déclenché suite à l'interaction de l'utilisateur.
Renvoie
void
sendPlaybackEnd
publics
sendPlaybackEnd() renvoie la valeur void
Notifie les serveurs publicitaires Google que la lecture de la session de lecture du contenu donnée est terminée. Cette méthode doit être appelée à la fin de la lecture (par exemple, lorsque le lecteur atteint la fin d'une diffusion, lorsque l'utilisateur quitte la lecture en cours de lecture, lorsque l'utilisateur quitte la page ou lorsqu'il passe au contenu suivant d'une playlist).
Cette méthode met fin aux appels asynchrones vers les serveurs Google démarrés dans sendPlaybackStart.
Renvoie
void
sendPlaybackStart
publics
sendPlaybackStart() renvoie vide
Notifie les serveurs publicitaires Google que la lecture de la session de lecture du contenu donnée a commencé. Elle doit être appelée lors de l'action "video player start". Cela peut être en réponse à une action déclenchée par l'utilisateur (click-to-play) ou à une action déclenchée par une 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 de l'IVT.
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 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`"]]
