Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
NonceManager
classpublic
Verwaltet eine Nonce und die zugehörige Ereignisberichterstellung für eine einzelne Wiedergabesitzung.
Die Methoden des Wiedergabesitzungslebenszyklus für Inhalte, einschließlich sendAdClick, sendTouch, sendPlaybackStart und sendPlaybackEnd, müssen aufgerufen werden, wenn die entsprechenden Ereignisse eintreten, um die programmatische Monetarisierung zu ermöglichen.
Methoden
getNonce
Öffentlich
getNonce() gibt String zurück
Ausgabe
string Die Nonce, die für diesen Manager beim Laden generiert wurde.
Dieser Wert ändert sich für eine bestimmte NonceManager-Instanz nie. Dieser Nonce-Wert ist nur für eine einzelne Contentwiedergabesitzung mit einer maximalen Dauer von 6 Stunden gültig.
sendAdClick
Öffentlich
sendAdClick() gibt „void“ zurück
Benachrichtigt die Google-Ad-Server, dass während der angegebenen Inhaltswiedergabesitzung ein Klick auf eine Anzeige erfolgt ist.
Ausgabe
void
sendAdImpression
Öffentlich
sendAdImpression() gibt „void“ zurück
Sollte aufgerufen werden, wenn der erste Frame der Anzeige, die mit der von diesem Manager generierten Nonce angefordert wurde, angezeigt wird.
Verworfen
Verwenden Sie stattdessen „sendPlaybackStart“ und „sendPlaybackEnd“.
Ausgabe
void
sendAdTouch
Öffentlich
sendAdTouch(userInteractionEvent) returns void
Benachrichtigt die Google-Anzeigenserver, dass während der angegebenen Wiedergabesitzung des Inhalts eine Nutzerberührung oder ein Nutzerklick auf die Anzeige stattgefunden hat, die nicht als Klick-Conversion gezählt wird (z. B. Überspringen, Stummschalten, Tippen).
Parameter
userInteractionEvent
cast.framework.events.Event
Das vom Cast-Framework ausgelöste Nutzerinteraktionsereignis.
Der Wert darf nicht null sein.
Ausgabe
void
sendPlaybackEnd
Öffentlich
sendPlaybackEnd() gibt „void“ zurück
Benachrichtigt die Google-Anzeigenserver, dass die Wiedergabe für die angegebene Inhaltswiedergabesitzung beendet wurde. Dieses Ereignis sollte aufgerufen werden, wenn die Wiedergabe endet, z.B. wenn der Player das Ende des Streams erreicht, der Nutzer die Wiedergabe vorzeitig beendet, der Nutzer die Seite verlässt oder wenn in einer Playlist zum nächsten Inhaltselement gewechselt wird.
Diese Methode beendet die asynchronen Aufrufe an Google-Server, die in sendPlaybackStart gestartet wurden.
Ausgabe
void
sendPlaybackStart
Öffentlich
sendPlaybackStart() gibt „void“ zurück
Benachrichtigt die Google-Anzeigenserver, dass die Wiedergabe für die angegebene Inhaltswiedergabesitzung begonnen hat. Diese Funktion 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 das Monitoring und die Erkennung ungültiger Zugriffe erforderlich sind.
[null,null,["Zuletzt aktualisiert: 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`"]]
