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:
window.JOGOS_SDK.banner;
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)
- 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:
<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):
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:
await window.JOGOS_SDK.banner.clearBanner('banner-container');
Remover todos os banners
Em seguida, use o seguinte método para remover todos os banners:
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.