刊登位置類型

所有對 adBreak() 的呼叫都必須指定刊登位置類型。這個字串會在廣告顯示時說明遊戲狀態。你的遊戲是否正在載入內容?玩家是否暫停了遊戲?或者他們是否在遊戲中獲得了獎勵?

您使用的精確類型很重要。這類廣告可直接影響實際放送的廣告類型,包括插頁式廣告和獎勵廣告。但也可能影響 API 行為的其他可見度。請務必正確指定刊登位置類型,以便 API 達到最佳成效。

刊登位置類型 說明
'preroll' 您的遊戲尚未載入 UI,且並未播放音效。遊戲中的每次網頁載入頁面只能有一個「片頭」刊登位置。

範例:玩家在遊戲目錄中點選您的遊戲。系統會顯示遊戲面板,且在遊戲轉譯 UI 或啟用廣告音效之前。玩家可點擊廣告,或是關閉遊戲的時間點。
'start' 已載入您的遊戲,且 UI 已顯示且已啟用音效,玩家可與遊戲互動,但尚未開始遊戲。

範例:顯示簡短載入畫面「載入中...」,並顯示插頁式廣告。玩家可以點擊廣告或關閉廣告,以便繼續遊戲。

注意:start 刊登位置相比,preroll 的工作效果更好。preroll 會等待 API 初始化並自動預先載入廣告。您應使用 preroll,而非 start,以便在遊戲載入期間放送的第一則廣告顯示 (在使用者介面顯示之前)。start您的 UI 顯示後,會是一個更好的刊登位置,且玩家能夠與遊戲互動。
start你也可以在遊戲重新啟動時使用,而且每次載入網頁時也可以有多個 start 刊登位置。如果start刊登位置是遊戲的第一個刊登位置 (亦即不使用 preroll 刊登位置),您可能需要手動要求廣告預先載入
'pause' 玩家暫停玩遊戲。

範例:玩家暫停玩遊戲,並顯示插頁式廣告。廣告會持續顯示在畫面上,直到播放器關閉為止。繼續玩遊戲時,遊戲仍會暫停。讓玩家繼續執行遊戲並繼續遊戲。
'next' 玩家進入下一級。

範例:玩家剛完成一個關卡。使用者輕觸一個「下一步」按鈕,並顯示插頁式廣告。使用者觀看並關閉廣告,然後進入下一級。
'browse' 玩家會探索遊戲過程以外的選項。

範例:玩家想修改角色的風格。使用者輕觸按鈕 [選項...],然後隨即顯示插頁式廣告。觀看者關閉廣告後關閉廣告,然後繼續前往角色編輯器。
'reward' 在這類遊戲中,玩家可獲得點數以獲得獎勵。

範例:玩家剛死亡,即將失去生命。觀看廣告後,他們就會獲得額外獎勵。Ad Placement API 會呼叫您的程式碼,向玩家提供獎勵。他們輕觸獎勵按鈕並觀看所有影片廣告。他們會開始接受新的生命,並繼續遊戲。

注意:這組刊登位置類型是開發中的有效區域。

如果遊戲中的刊登位置無法自然融入上述任一類別,請通知 Google 客戶經理,我們會逐步參考這些意見回饋來調整這些類別。