Skip to content

Banner

Este módulo implementa a exibição e remoção de anúncios em banner. Após ler a seção relacionada ao seu motor de jogo na página Introdução ao JOGOS_SDK, você pode usar as funcionalidades relacionadas da seguinte forma:

javascript
window.JOGOS_SDK.banner;
Requisitos de anúncios

Por favor, leia attentamente nossos Requisitos de anúncios, porque se o seu jogo não cumprir esses requisitos, ele será rejeitado sem qualquer feedback.

Solicitar exibição de anúncio em banner

Existem 5 tamanhos disponíveis para anúncios em banner:

  • Leaderboard (728x90)
  • Médio (300x250)
  • Dispositivo móvel (320x50)
  • Página inicial (468x60)
  • Dispositivo móvel grande (320x100)
Restrições
  • Apenas 2 anúncios em banner de tamanhos diferentes podem ser exibidos ao mesmo tempo
  • A mesma posição de anúncio em banner deve ser exibida por 60 segundos antes de ser atualizada novamente
  • Se o banner não seguir as regras e tamanhos acima, é provável que não seja exibido

Primeiro, você precisa criar um contêiner para o anúncio em banner na tela, especificando opcionalmente a largura e a altura:

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

Em seguida, use o seguinte método para solicitar a exibição do anúncio em banner (note que o id deve coincidir com o id do contêiner):

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

No máximo dois anúncios em banner podem ser exibidos ao mesmo tempo; caso contrário, uma exceção será lançada: '500 At most two banners can be displayed at the same time'.

A execução deste método com o mesmo id substituirá o anúncio original. A execução repetida dentro de um período especificado (normalmente 60 segundos) lançará uma exceção: 500 The time for each call to method requestBanner cannot exceed ${time} seconds.

Remover banner especificado

Em seguida, use o seguinte método para remover o banner com o id especificado:

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

Remover todos os banners

Em seguida, use o seguinte método para remover todos os banners:

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

Teste local

Durante o teste local, anúncios reais não serão exibidos. Para ver o efeito final de exibição, você pode empacotar seu jogo e enviá-lo para a ferramenta QA da plataforma de desenvolvedores para teste.