Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
NonceManager
classpublic
Zarządza liczbą jednorazową i raportowaniem jej zdarzeń w ramach pojedynczej sesji odtwarzania treści.
Aby można było włączyć automatyzację zarabiania, musisz wywoływać metody cyklu życia sesji odtwarzania treści, w tym sendAdClick, sendAdTouch, sendPlaybackStart i sendPlaybackEnd, ponieważ występują te zdarzenia.
Metody
getNonce
public (Publiczny)
getNonce() zwraca ciąg znaków.
Zwroty
string Liczba jednorazowa wygenerowana dla tego menedżera po jego wczytaniu.
Ta wartość nigdy się nie zmieni w przypadku danej instancji NonceManager. Ta wartość jednorazowa jest ważna tylko przez 1 sesję odtwarzania treści, która trwa maksymalnie 6 godzin.
sendAdClick
public (Publiczny)
sendAdClick() zwraca nieważną
Informuje serwery reklam Google, że podczas danej sesji odtwarzania treści wystąpiło kliknięcie reklamy.
Zwroty
void
sendAdImpression
public (Publiczny)
sendAdimpression() zwraca pustą wartość
Powinno być wywoływane po wyświetleniu pierwszej ramki reklamy żądanej za pomocą liczby jednorazowej wygenerowanej przez tego menedżera.
Wycofano
Zamiast tego użyj poleceń „sendPlaybackStart” i „sendPlaybackEnd”.
Zwroty
void
sendAdTouch
public (Publiczny)
sendAdTouch(clickOrTouchEvent) zwraca nieważną
Informuje serwery reklam Google, że użytkownik kliknął lub kliknął reklamę inną niż kliknięcie (np. pominięcie, wyciszenie, kliknięcie itp.) podczas danej sesji odtwarzania treści.
Parametr
clickOrTouchEvent
(wartość nienull MouseEvent lub nienull TouchEvent)
Zdarzenie kliknięcia lub dotknięcia w przeglądarce, które zostało wywołane w związku z interakcją użytkownika.
Zwroty
void
sendPlaybackEnd
public (Publiczny)
sendPlaybackEnd() zwraca wartość nieważną
Powiadamia serwery reklam Google, że odtwarzanie danej sesji odtwarzania treści zostało zakończone. Należy ją wywołać po zakończeniu odtwarzania (na przykład gdy odtwarzacz dobiegnie końca, użytkownik zatrzyma odtwarzanie w połowie odtwarzania, gdy użytkownik opuści stronę lub przejdzie do następnego elementu treści w ustawieniach playlisty).
Ta metoda kończy asynchroniczne wywołania serwerów Google rozpoczętych w sendPlaybackStart.
Zwroty
void
sendPlaybackStart
public (Publiczny)
sendPlaybackStart() zwraca pustą wartość
Powiadamia serwery reklam Google, że rozpoczęło się odtwarzanie w ramach danej sesji odtwarzania treści. Ta opcja powinna się nazywać podczas „uruchamiania odtwarzacza wideo”. Może to być reakcja na działanie zainicjowane przez użytkownika (kliknij, aby odtworzyć) lub działanie na stronie (autoodtwarzanie).
Ta metoda spowoduje asynchroniczne wywołania serwerów Google w celu zbierania sygnałów potrzebnych do monitorowania i wykrywania nieprawidłowego ruchu.
[null,null,["Ostatnia aktualizacja: 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`"]]
