Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
NonceManager
classpublic
Mengelola nonce dan pelaporan peristiwanya untuk satu sesi pemutaran
konten.
Metode siklus proses sesi pemutaran konten, termasuk sendAdClick, sendAdTouch, sendPlaybackStart, dan sendPlaybackEnd harus dipanggil karena masing-masing peristiwa tersebut terjadi untuk mengaktifkan monetisasi terprogram.
Metode
getNonce
publik
getNonce() menampilkan string
Hasil
string Nonce yang dibuat untuk pengelola ini saat dimuat.
Nilai ini tidak akan pernah berubah untuk instance NonceManager tertentu. Nilai nonce ini hanya berlaku untuk satu sesi pemutaran konten hingga durasi maksimum 6 jam.
sendAdClick
publik
sendAdClick() menampilkan void
Memberi tahu server iklan Google bahwa klik-tayang pada iklan telah terjadi selama
sesi pemutaran konten tertentu.
Hasil
void
sendAdImpression
publik
sendAdImpression() menampilkan void
Harus dipanggil saat frame pertama iklan yang diminta dengan
nonce yang dihasilkan oleh pengelola ini ditampilkan.
Tidak digunakan lagi
Gunakan `sendPlaybackStart` dan `sendPlaybackEnd` sebagai gantinya.
Hasil
void
sendAdTouch
publik
sendAdTouch(clickOrTouchEvent) menampilkan void
Memberi tahu server iklan Google bahwa pengguna menyentuh atau mengklik iklan selain
klik-tayang (misalnya, lewati, bisukan, ketuk, dan sebagainya) telah terjadi
selama sesi pemutaran konten tertentu.
Parameter
clickOrTouchEvent
(MouseEvent non-null atau TouchEvent non-null)
Peristiwa sentuh atau klik browser yang diaktifkan
untuk interaksi pengguna.
Hasil
void
sendPlaybackEnd
publik
sendPlaybackEnd() menampilkan void
Memberi tahu server iklan Google bahwa pemutaran untuk sesi pemutaran konten tertentu telah berakhir. Metode ini harus dipanggil saat pemutaran berakhir (misalnya saat pemutar mencapai akhir streaming, atau saat pengguna keluar dari pemutaran di tengah jalan, atau saat pengguna meninggalkan halaman, atau saat melanjutkan ke item konten berikutnya dalam setelan playlist).
Metode ini mengakhiri panggilan asinkron ke server Google yang dimulai di
sendPlaybackStart.
Hasil
void
sendPlaybackStart
publik
sendPlaybackStart() menampilkan void
Memberi tahu server iklan Google bahwa pemutaran untuk sesi pemutaran konten tertentu telah dimulai. Ikon ini akan dipanggil di "video player start". Ini
mungkin sebagai respons atas tindakan yang dimulai pengguna (klik untuk putar) atau tindakan
yang dimulai oleh halaman (putar otomatis).
Metode ini akan memulai panggilan asinkron ke server Google guna mengumpulkan
sinyal yang diperlukan untuk pemantauan dan deteksi IVT.
[null,null,["Terakhir diperbarui pada 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`"]]
