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
classpublic
Quản lý một số chỉ dùng một lần và báo cáo sự kiện của số đó cho một phiên phát nội dung duy nhất.
Bạn 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 cả sendAdClick, sendTouch, 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
public
getNonce() trả về chuỗi
Giá trị trả về
string Số chỉ dùng một lần được tạo cho người quản lý này khi người quản lý đượ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ệ cho một phiên phát nội dung duy nhất với thời lượng tối đa là 6 giờ.
sendAdClick
public
sendAdClick() trả về giá trị rỗng
Thông báo cho các máy chủ quảng cáo của Google rằng đã có một lượt nhấp vào quảng cáo trong phiên phát nội dung nhất định.
Giá trị trả về
void
sendAdImpression
public
sendAdImpression() trả về giá trị void
Cần được gọi khi khung hình đầu tiên của quảng cáo được yêu cầu bằng số chỉ dùng một lần do trình 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
public
sendAdTouch(userInteractionEvent) trả về giá trị void
Thông báo cho các máy chủ quảng cáo của Google rằng một lượt chạm hoặc nhấp của người dùng vào quảng cáo (ngoài lượt nhấp 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ố
userInteractionEvent
cast.framework.events.Event
Sự kiện tương tác của người dùng do khung Cast kích hoạt.
Giá trị không được rỗng.
Giá trị trả về
void
sendPlaybackEnd
công khai
sendPlaybackEnd() trả về void
Thông báo cho các máy chủ quảng cáo của Google rằng phiên phát nội dung đã cho đã kết thúc. Bạn nên gọi phương thức này khi quá trình phát kết thúc (ví dụ: khi trình phát đạt đến cuối luồng, hoặc khi người dùng thoát khỏi quá trình phát giữa chừng, hoặc khi người dùng rời khỏi trang, hoặc khi chuyển sang 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 bắt đầu trong sendPlaybackStart.
Giá trị trả về
void
sendPlaybackStart
công khai
sendPlaybackStart() trả về giá trị rỗng
Thông báo cho các máy chủ quảng cáo của Google rằng phiên phát nội dung đã cho đã bắt đầu. Bạn nên gọi hàm này khi "trình phát video bắt đầu". Điều này có thể xảy ra để 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 trang thực hiện (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 lưu lượng truy cập không hợp lệ.
[null,null,["Cập nhật lần gần đây nhất: 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`"]]
