Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
NonceManager
Kurspublic
Verwaltet eine Nonce und ihre Ereignisberichte für eine einzelne Wiedergabesitzung von Inhalten.
Die Lebenszyklusmethoden der Inhaltswiedergabe-Sitzung, einschließlich sendAdClick, sendAdTouch, sendPlaybackStart und sendPlaybackEnd, müssen beim Eintreten der entsprechenden Ereignisse aufgerufen werden, um die programmatische Monetarisierung zu aktivieren.
Methoden
getNonce
öffentlich
getNonce() gibt einen String zurück
Rückgaben
string Die beim Laden für dieses Verwaltungskonto generierte Nonce.
Dieser Wert ändert sich niemals für eine NonceManager-Instanz. Dieser Nonce-Wert gilt nur für eine einzelne Wiedergabesitzung von Inhalten bis zu einer maximalen Dauer von 6 Stunden.
sendAdClick
öffentlich
sendAdClick() gibt void zurück
Informiert die Google Ad-Server darüber, dass während der jeweiligen Wiedergabesitzung der Inhalte ein Klick auf eine Anzeige stattgefunden hat.
Rückgaben
void
sendAdImpression
öffentlich
sendAdImpression() gibt void zurück
Sollte aufgerufen werden, wenn der erste Frame der Anzeige, der mit der von diesem Manager generierten Nonce angefordert wurde, angezeigt wird.
Eingestellte Funktionen
Verwende stattdessen „sendWiedergabeStart“ und „sendWiedergabeEnd“.
Rückgaben
void
sendAdTouch
öffentlich
sendAdTouch(clickOrTouchEvent) return void
Informiert die Ad-Server von Google darüber, dass ein Nutzer während der entsprechenden Wiedergabesitzung des Inhalts die Anzeige berührt oder darauf geklickt hat (z. B. Überspringen, Stummschalten, Tippen usw.)
Parameter
clickOrTouchEvent
(MouseEvent ungleich null oder TouchEvent nicht null)
Das Touch- oder Klickereignis des Browsers, das für die Nutzerinteraktion ausgelöst wurde.
Rückgaben
void
sendPlaybackEnd
öffentlich
sendWiedergabeEnd() gibt void zurück
Informiert die Google Ad-Server darüber, dass die Wiedergabe in der entsprechenden Sitzung zur Inhaltswiedergabe beendet wurde. Der Aufruf sollte erfolgen, wenn die Wiedergabe endet, z. B. wenn der Player das Ende des Streams erreicht, der Nutzer die Wiedergabe mittendrin beendet, der Nutzer die Seite verlässt oder in einer Playlist-Einstellung zum nächsten Inhaltselement wechselt.
Diese Methode beendet die asynchronen Aufrufe an Google-Server, die in sendPlaybackStart gestartet wurden.
Rückgaben
void
sendPlaybackStart
öffentlich
sendWiedergabeStart() gibt void zurück
Informiert die Google Ad-Server darüber, dass die Wiedergabe für die betreffende Wiedergabesitzung
gestartet wurde. Dies sollte beim Start des Videoplayers aufgerufen werden. Dies kann als Reaktion auf eine vom Nutzer initiierte Aktion (Click-to-Play) oder eine von der Seite initiierte Aktion (Autoplay) erfolgen.
Mit dieser Methode werden asynchrone Aufrufe an Google-Server gestartet, um Signale zu erfassen, die für die Überwachung und Erkennung ungültiger Zugriffe erforderlich sind.
[null,null,["Zuletzt aktualisiert: 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`"]]
