透過 YouTube 內建的營利功能，將 Playables 遊戲轉換為收益。
瞭解以廣告為基礎的營利方式
YouTube 提供遊戲內建營利功能，首先是廣告。我們支援三種遊戲廣告機會：
- 片頭廣告：在遊戲初始載入時顯示的廣告
- 插頁式廣告：在遊戲中的自然分段處顯示廣告，例如完成關卡時
- 獎勵廣告：使用者選擇觀看這類廣告，藉此換取遊戲內物品或體驗
適用遊戲角落的區域和平台中，部分使用者會看到這些廣告空間。
我們會持續強化並擴大以廣告為基礎的營利功能，敬請期待。
整合廣告營利功能
YouTube 會自動處理片頭廣告，你無須進行任何整合工作。
YouTube 會自動處理片頭廣告，但您可以使用 Playables SDK 廣告功能，在約 5 分鐘內導入插頁式廣告和獎勵廣告。
必要條件
整合前須知：
- 請確認您有權存取 Playables 測試套件，以便驗證整合。
- 如果遊戲使用 TypeScript，請務必使用最新型別定義，方便整合。
- 查看是否有程式碼範例，說明如何整合 YouTube 遊戲角落 SDK。
整合插頁式廣告
插頁式廣告的導入作業只需一分鐘。只要在遊戲的自然暫停點 (例如關卡之間、顯示「遊戲結束」畫面後，或遊戲中載入序列期間) 呼叫 requestInterstitialAd() 即可：
try {
await ytgame.ads.requestInterstitialAd();
// Ad request successful
} catch (error) {
// Handle errors, retry logic, etc.
}
整合獎勵廣告
獎勵廣告的整合速度同樣很快。只要玩家明確要求顯示獎勵廣告，就呼叫 requestRewardedAd(id)。
您必須選取並傳遞專屬的獎勵 ID。您可以將這些 ID 直接硬式編碼到遊戲中。
建立 ID 時，請遵守下列規定：
- 請勿加入任何使用者資料。
- 請使用可讀取的字串 (例如
"100-coins-reward-12") 或標準 UUID (例如"21403813-2e22-4316-a8b2-7d4f52a6f6fb")。
try {
const rewardEarned =
await ytgame.ads.requestRewardedAd('reward-id-123');
if (rewardEarned) {
// Handle the earned case.
} else {
// Handle the not earned case.
}
} catch (error) {
// Handle errors, retry logic, etc.
}
如需實作詳細資料和其他範例，請參閱 Playables SDK 廣告功能。
測試廣告營利
準備就緒後，您可以使用 Playables 測試套件驗證整合功能。如要瞭解如何操作，請參閱測試套件指南。
開發和測試版遊戲也會啟用廣告，但僅限部分符合遊戲角落資格的地區和平台。
管理以廣告為基礎的營利方式
整合完成後，您可以在可玩廣告開發人員入口網站中，控制遊戲的這些廣告類型，以便在測試或驗證時開啟或關閉。這些廣告類型預設為「開啟」。
後續步驟
收益分潤試行計畫
遊戲角落營利功能目前處於初期階段，為盡早取得意見回饋，我們將與部分 Playable 創作者進行收益分潤試辦計畫。我們希望隨著時間推移，能與更廣泛的 YouTube 營利計畫保持一致，讓更多創作者透過 Playables 營利。隨著計畫擴大，我們將分享更多資訊。
加入社群
想討論營利事宜、取得整合方面的協助，或提供意見回饋嗎？加入我們的 Discord 社群。