Skip to content

배너

이 모듈은 배너 광고의 표시 및 제거를 구현합니다. JOGOS_SDK 소개 페이지에서 게임 엔진과 관련된 부분을 읽은 후 다음과 같이 관련 기능을 사용할 수 있습니다:

javascript
window.JOGOS_SDK.banner;
광고 요구 사항

반드시 광고 요구 사항을 읽어주시기 바랍니다. 게임이 이러한 요구 사항을 준수하지 않으면 게임이 거부되며, 어떠한 피드백도 제공되지 않습니다.

배너 광고 표시 요청

배너 광고는 총 5가지 크기로 제공됩니다:

  • 순위표 (728x90)
  • 중간 (300x250)
  • 모바일 기기 (320x50)
  • 메인 페이지 (468x60)
  • 대형 모바일 기기 (320x100)
제한 사항
  • 같은 시간에 크기가 다른 2개의 배너 광고만 표시할 수 있습니다.
  • 같은 배너 광고 위치는 60초 동안 표시된 후에만 다시 광고를 새로고침할 수 있습니다.
  • 배너가 위의 규칙과 크기를 따르지 않으면 표시되지 않을 가능성이 높습니다.

먼저, 화면에 배너 광고용 컨테이너를 생성해야 합니다. 너비와 높이를 선택적으로 지정할 수 있습니다:

html
<div id="banner-container" style="width: 300px; height: 250px"></div>

그런 다음 다음 메서드를 사용하여 배너 광고 표시를 요청합니다 (참고: id는 컨테이너의 id와 일치해야 합니다):

javascript
try {
  await window.JOGOS_SDK.banner.requestBanner('banner-container');
} catch (e) {
  console.log('Banner request error', e);
}

같은 시간에 최대 2개의 배너 광고만 표시할 수 있으며, 그렇지 않으면 예외가 throw됩니다: '500 At most two banners can be displayed at the same time'.

같은 id로 이 메서드를 실행하면 기존 광고가 교체되며, 지정된 시간 내(일반적으로 60초) 반복 실행하면 예외가 throw됩니다: 500 The time for each call to method requestBanner cannot exceed ${time} seconds.

지정된 배너 삭제

그런 다음 다음 메서드를 사용하여 지정된 id의 배너를 삭제할 수 있습니다:

javascript
await window.JOGOS_SDK.banner.clearBanner('banner-container');

모든 배너 삭제

그런 다음 다음 메서드를 사용하여 모든 배너를 삭제할 수 있습니다:

javascript
await window.JOGOS_SDK.banner.clearAllBanners();

로컬 테스트

로컬 테스트 시 실제 광고가 표시되지 않습니다. 최종 표시效果를 확인하려면 게임을 패키징하여 개발자 플랫폼의 QA 도구에 업로드하여 테스트할 수 있습니다.