Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
NonceManager
lớpcông khai
Quản lý một số chỉ dùng một lần và báo cáo sự kiện của số chỉ dùng một lần trong một phiên phát nội dung.
Phải gọi các phương thức trong vòng đời của phiên phát nội dung, bao gồm sendAdClick, sendAdTouch, sendPlaybackStart và sendPlaybackEnd khi các sự kiện tương ứng này xảy ra để bật tính năng kiếm tiền có lập trình.
Phương thức
getNonce
công khai
getNonce() trả về chuỗi
Giá trị trả về
string Số chỉ dùng một lần được tạo cho trình quản lý này khi được tải.
Giá trị này sẽ không bao giờ thay đổi đối với một thực thể NonceManager nhất định. Giá trị số chỉ dùng một lần này chỉ hợp lệ trong một phiên phát nội dung duy nhất trong thời lượng tối đa 6 giờ.
sendAdClick
công khai
sendAdClick() trả về vô hiệu
Thông báo cho các máy chủ quảng cáo của Google rằng một lượt nhấp vào quảng cáo đã xảy ra trong
phiên phát nội dung nhất định.
Giá trị trả về
void
sendAdImpression
công khai
sendAdImpression() trả về vô hiệu
Sẽ được gọi khi khung đầu tiên của quảng cáo được yêu cầu cùng với
số chỉ dùng một lần do người quản lý này tạo được hiển thị.
Không được dùng nữa
Thay vào đó, hãy sử dụng "sendPlaybackStart" và "sendPlaybackEnd".
Giá trị trả về
void
sendAdTouch
công khai
sendAdTouch(clickOrTouchEvent) trả về vô hiệu
Thông báo cho các máy chủ quảng cáo của Google rằng người dùng chạm hoặc nhấp vào quảng cáo chứ không phải
nhấp chuột qua (ví dụ: bỏ qua, tắt tiếng, nhấn, v.v.) đã xảy ra
trong phiên phát nội dung nhất định.
Thông số
clickOrTouchEvent
(MouseEvent không rỗng hoặc TouchEvent không có giá trị null)
Sự kiện nhấp chuột hoặc chạm trên trình duyệt đã được kích hoạt cho hoạt động tương tác của người dùng.
Giá trị trả về
void
sendPlaybackEnd
công khai
sendPlaybackEnd() trả về vô hiệu
Thông báo cho các máy chủ quảng cáo của Google rằng quá trình phát nội dung
nhất định đã kết thúc. Lệnh này sẽ được gọi khi quá trình phát kết thúc (ví dụ: khi người dùng đến cuối sự kiện phát trực tuyến, hoặc khi người dùng thoát khỏi chế độ phát giữa chừng, hoặc khi người dùng rời khỏi trang hoặc khi chuyển đến mục nội dung tiếp theo trong chế độ cài đặt danh sách phát).
Phương thức này kết thúc các lệnh gọi không đồng bộ đến máy chủ của Google được bắt đầu trong sendPlaybackStart.
Giá trị trả về
void
sendPlaybackStart
công khai
sendPlaybackStart() trả về vô hiệu
Thông báo cho các máy chủ quảng cáo của Google rằng quá trình phát nội dung
nhất định đã bắt đầu. Thông báo này sẽ được gọi khi "bắt đầu trình phát video". Đây có thể là hành động phản hồi một hành động do người dùng thực hiện (nhấp để phát) hoặc một hành động do người dùng khởi tạo (tự động phát).
Phương thức này sẽ bắt đầu các lệnh gọi không đồng bộ đến máy chủ của Google để thu thập
các tín hiệu cần thiết cho việc giám sát và phát hiện IVT.
[null,null,["Cập nhật lần gần đây nhất: 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`"]]
