비디오 광고

이 모듈은 인터스티셜 비디오 및 리워드 비디오 광고를 구현합니다. 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.

• 리워드 광고에는 일일 최대 제한(일반적으로 사용자당 하루 30회)이 있으며, 너무 많이 호출하면 예외가 발생합니다: 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);