刊登位置類型
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
所有對 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 客戶經理,我們會逐步參考這些意見回饋來調整這些類別。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2022-08-16 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2022-08-16 (世界標準時間)。"],[[["All calls to `adBreak()` require a placement type string describing the game's state when the ad is shown (e.g., loading, paused, reward offered)."],["The placement type impacts the ad experience (interstitial or rewarded) and the API's behavior, so accurate specification is crucial for optimal performance."],["Placement types include `preroll` (before UI loads), `start` (after UI loads), `pause`, `next`, `browse`, and `reward`, each with specific use cases."],["While the current placement types cover common scenarios, developers with unique placements should inform their Google Account Manager for potential refinements to the categories."]]],["The `adBreak()` function requires a placement type string, which defines the game's state when an ad appears. Placement types include `'preroll'` (game loading, before UI), `'start'` (game loaded, UI visible), `'pause'` (game paused), `'next'` (level transition), `'browse'` (exploring non-gameplay options), and `'reward'` (player offered an in-game reward for watching an ad). The selected placement directly impacts ad type and API behavior. `'preroll'` preloads ads and is preferable for the first ad.\n"]]