NonceManager
管理單一內容播放工作階段的隨機碼和事件回報。
內容播放工作階段生命週期方法 (包括 sendAdClick
、sendTouch
、sendPlaybackStart
和 sendPlaybackEnd
) 必須在發生這些事件時呼叫,才能啟用程式輔助營利。
方法
getNonce
getNonce() 會傳回字串
- 傳回
-
string
這個管理員在載入時產生的隨機值。 這個值在特定NonceManager
執行個體中永遠不會變更。這個隨機碼值僅適用於單一內容播放工作階段,最長時效為 6 小時。
sendAdClick
sendAdClick() 會傳回 void
通知 Google 廣告伺服器,在指定內容播放工作階段期間,使用者點按了廣告。
- 傳回
-
void
sendAdImpression
sendAdImpression() 會傳回 void
顯示以這個管理工具產生的隨機值要求的第一個廣告影格時,應呼叫這個方法。
- 已淘汰
- 請改用 `sendPlaybackStart` 和 `sendPlaybackEnd`。
- 傳回
-
void
sendAdTouch
sendAdTouch(userInteractionEvent) returns void
通知 Google 廣告伺服器,使用者在指定的內容播放工作階段中,觸控或點選廣告 (不包括點閱後動作,例如略過、靜音、輕觸等)。
參數 |
|
---|---|
userInteractionEvent |
cast.framework.events.Event Cast 架構觸發的使用者互動事件。 值不得為空值。 |
- 傳回
-
void
sendPlaybackEnd
sendPlaybackEnd() returns void
通知 Google 廣告伺服器,指定內容播放工作階段已結束。當播放結束時,應呼叫此方法 (例如播放器到達串流結尾、使用者中途結束播放、使用者離開網頁,或在播放清單設定中前往下一個內容項目時)。
這個方法會結束在 sendPlaybackStart
中啟動的 Google 伺服器非同步呼叫。
- 傳回
-
void
sendPlaybackStart
sendPlaybackStart() returns void
通知 Google 廣告伺服器,指定內容播放工作階段已開始播放。這項函式應在「影片播放器啟動」時呼叫。這可能是為了回應使用者啟動的動作 (點按播放),或是頁面啟動的動作 (自動播放)。
這個方法會開始對 Google 伺服器發出非同步呼叫,以收集 IVT 監控和偵測所需的信號。
- 傳回
-
void