Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
NonceManager
classherkese açık
Tek bir içerik oynatma oturumu için tek seferlik bir tek seferlik rastgele sayısı ve etkinlik raporlamasını yönetir.
Programatik para kazanmayı etkinleştirmek için sendAdClick, sendAdTouch, sendPlaybackStart ve sendPlaybackEnd gibi içerik oynatma oturumu yaşam döngüsü yöntemleri, bu ilgili etkinlikler meydana geldiğinde çağrılmalıdır.
Yöntemler
getNonce
herkese açık
getNonce() dize döndürür
İlerlemeler
string Yüklendiğinde bu yönetici için tek seferlik rastgele sayı oluşturuldu.
Bu değer belirli bir NonceManager örneği için hiçbir zaman değişmez. Bu tek seferlik değer değeri, maksimum 6 saate kadar tek bir içerik oynatma oturumu için geçerlidir.
sendAdClick
herkese açık
sendAdClick(), void değerini döndürür
Belirli bir içerik oynatma oturumu sırasında bir reklamın tıklandığında
Google reklam sunucularına bildirimde bulunur.
İlerlemeler
void
sendAdImpression
herkese açık
sendAdImpression() geçersiz döndürür
Bu yönetici tarafından oluşturulan tek seferlik rastgele sayıyla istenen reklamın ilk çerçevesi görüntülendiğinde çağrılmalıdır.
Kullanımdan kaldırıldı
Bunun yerine "sendPlaybackStart" ve "sendPlaybackEnd" ifadelerini kullanın.
Google reklam sunucularına, belirli bir içerik oynatma oturumu sırasında kullanıcının tıklama dışında bir reklama dokunduğunu veya tıkladığını bildirir (örneğin atlama, sesi kapatma, dokunma ve diğer işlemler).
Parametre
clickOrTouchEvent
(null olmayan MouseEvent veya null olmayan TouchEvent)
Kullanıcı etkileşimi için tetiklenen tarayıcı dokunma veya tıklama etkinliği.
İlerlemeler
void
sendPlaybackEnd
herkese açık
sendplayEnd(), void değerini döndürür
Google reklam sunucularına, belirtilen içerik oynatma oturumu için oynatmanın sona erdiğini bildirir. Bu, oynatma sona erdiğinde (örneğin, oynatıcı yayının sonuna ulaştığında, kullanıcı oynatmadan yarıda çıktığında, sayfadan ayrıldığında veya bir oynatma listesi ayarında bir sonraki içerik öğesine ilerlediğinde) çağrılmalıdır.
Bu yöntem, sendPlaybackStart içinde başlatılan Google sunucularına eşzamansız çağrıları sonlandırır.
İlerlemeler
void
sendPlaybackStart
herkese açık
sendPlaybackStart() geçersiz değerini döndürür
Google reklam sunucularına, belirtilen içerik oynatma oturumu için oynatmanın başladığını bildirir. Bu, "video oynatıcı başlangıcı"nda çağrılmalıdır. Bu, kullanıcı tarafından başlatılan bir işleme (tıkla oynat) veya sayfa tarafından başlatılan bir işleme (otomatik oynatma) yanıt olarak yapılabilir.
Bu yöntem, IVT izleme ve algılama için gereken sinyalleri toplamak amacıyla Google sunucularına eşzamansız çağrılar başlatır.
[null,null,["Son güncelleme tarihi: 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`"]]
