視頻廣告

此模組實作插屏視頻與激勵視頻廣告。閱讀 JOGOS_SDK 簡介 頁面與您的遊戲引擎相關的部分，並依下列方式使用視頻廣告的相關功能：

window.JOGOS_SDK.ad;

廣告要求

請務必閱讀我們的廣告要求，因為如果您的遊戲不遵守這些要求，您的遊戲將被拒絕，且沒有任何反饋。

請求播放視頻廣告

我們支援兩種不同類型的視頻廣告：插屏廣告（midgame）與激勵廣告（rewarded）；

• 插屏廣告：當使用者死亡、完成關卡等時，視情況可觸發遊戲插屏廣告。
• 激勵廣告：使用者主動請求觀看激勵廣告以換取獎勵（額外生命、角色死亡時復活、額外物品、額外屬性等）。

// 回調函式
const callbacks = {
  // 開始播放廣告時會呼叫此函式
  onstarted: () => console.log('ad started'),
  // 播放廣告結束時會呼叫此函式
  onfinished: () => console.log('ad finished'),
  // 播放廣告出錯時會呼叫此函式
  onerror: (error) => console.log('ad error:', error),
};

// 請求顯示插屏廣告
window.JOGOS_SDK.ad.requestAd('midgame', callbacks);
// 請求顯示激勵廣告
window.JOGOS_SDK.ad.requestAd('rewarded', callbacks);

呼叫廣告須知

• 插屏廣告有最低重新整理時間（一般為 60 秒），頻繁呼叫會觸發異常：500 At least a ${time} second interval is required to display new advertisements。

• 激勵廣告每天對每個使用者有最大限制（一般每天 50 次），過多呼叫會觸發異常：500 You can only watch up to ${max} rewarded ads per day。

• 我們建議您設計激勵廣告點時，廣告點設計冷卻時間或每日限額次數。您也可以透過以下介面，取得當前使用者激勵廣告的剩餘次數，來決定您的激勵廣告是否需要隱藏。

const result = await window.JOGOS_SDK.ad.getRewardAdCount();
console.log('Remaining rewardAd count ', result);

廣告攔截檢測

廣告要求

我們的遊戲設計上，允許在使用者有廣告攔截狀態下繼續運作。但檢測機制可能存在誤判，為避免誤判影響正常使用者，建議採取溫和的限制措施：僅對廣告攔截使用者限制增值內容（如特殊皮膚、額外關卡等），並確保使用者關閉廣告攔截後只需重新整理頁面即可恢復完整功能。

使用以下方法檢測使用者是否有使用廣告攔截器：

const result = await window.JOGOS_SDK.ad.hasAdblock();
console.log('Adblock usage fetched', result);