NonceManager
管理单个内容播放会话的 Nonce 及其事件报告。
必须调用内容播放会话生命周期方法(包括 sendAdClick
、sendAdTouch
、sendPlaybackStart
和 sendPlaybackEnd
),因为这些事件发生时才能启用程序化创收。
方法
getNonce
getNonce() 返回字符串
- 返回
-
string
加载此管理器时生成的 Nonce。对于给定的NonceManager
实例,此值永远不会改变。此 Nonce 值仅对单个内容播放会话有效,时长上限为 6 小时。
sendAdClick
sendAdClick() 会返回 void
通知 Google 广告服务器在指定内容播放会话期间发生了广告点击。
- 返回
-
void
sendAdImpression
sendAdImpression() 会返回 void
当使用此管理器生成的 Nonce 请求的广告第一帧显示时,应调用此方法。
- 已弃用
- 请改用“sendPlaybackStart”和“sendPlaybackEnd”。
- 返回
-
void
sendAdTouch
sendAdTouch(clickOrTouchEvent) 会返回 void
通知 Google 广告服务器:在指定内容播放会话期间,用户触摸或点击了广告(例如,跳过、静音、点按等)。
参数 |
|
---|---|
clickOrTouchEvent |
(非 null MouseEvent 或非空 TouchEvent) 为用户互动触发的浏览器触摸或点击事件。 |
- 返回
-
void
sendPlaybackEnd
sendPlaybackEnd() 会返回 void
向 Google 广告服务器发送通知,告知其指定内容播放会话的播放已结束。应在播放结束时(例如,播放器播放到结尾、用户中途退出播放、用户离开页面或前进到播放列表设置中的下一个内容项时)调用此方法。
此方法会结束对 Google 服务器的异步调用(从 sendPlaybackStart
开始)。
- 返回
-
void
sendPlaybackStart
sendPlaybackStart() 会返回 void
向 Google 广告服务器发送通知,告知其指定内容播放会话已开始播放。此方法应在“视频播放器启动”时调用。这可以是响应用户发起的操作(点击播放)或页面发起的操作(自动播放)。
此方法将启动对 Google 服务器的异步调用,以收集监控和检测 IVT 所需的信号。
- 返回
-
void