비디오 광고

이 모듈은 인터스티셔리얼 및 리워드 비디오 광고를 구현합니다. 사용하시는 게임 엔진에 맞는 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 오류 발생.

리워드 광고 지점 설계 시 쿨타임이나 일일 한도를 권장합니다. 아래 API로 남은 횟수를 조회해 버튼 숨김 여부를 결정할 수 있습니다.

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);