Anúncios em vídeo

Este módulo implementa anúncios em vídeo intersticiais e anúncios em vídeo recompensados. Leia a página JOGOS_SDK Introdução e veja a seção relacionada ao seu motor de jogo, depois utilize as funcionalidades de anúncios em vídeo conforme descrito abaixo:

window.JOGOS_SDK.ad;

Requisitos de anúncio

Por favor, leia atentamente nossos requisitos de anúncio, pois se o seu jogo não cumprir estes requisitos, ele será rejeitado sem qualquer feedback.

Solicitação de reprodução de anúncios em vídeo

Suportamos dois tipos de anúncios em vídeo: anúncios intersticiais (midgame) e anúncios recompensados (rewarded);

• Anúncios intersticiais: podem ser exibidos quando o usuário morre, completa uma fase ou em outros eventos do jogo.
• Anúncios recompensados: o usuário escolhe assistir para ganhar recompensas (vidas extras, reviver personagem, itens adicionais, atributos extras etc.).

// Funções de callback
const callbacks = {
  // Chamado quando o anúncio começa
  onstarted: () => console.log('ad started'),
  // Chamado quando o anúncio termina
  onfinished: () => console.log('ad finished'),
  // Chamado quando ocorre um erro no anúncio
  onerror: (error) => console.log('ad error:', error),
};

// Solicitar exibição de anúncio intersticial
window.JOGOS_SDK.ad.requestAd('midgame', callbacks);
// Solicitar exibição de anúncio recompensado
window.JOGOS_SDK.ad.requestAd('rewarded', callbacks);

Avisos ao chamar anúncios

• Anúncios intersticiais possuem tempo mínimo de atualização (geralmente 60 segundos). Chamadas frequentes dispararão erro: 500 At least a ${time} second interval is required to display new advertisements.

• Anúncios recompensados têm limite máximo diário (geralmente 50 vezes por usuário). Chamadas em excesso dispararão erro: 500 You can only watch up to ${max} rewarded ads per day.

• Recomendamos projetar pontos de anúncios recompensados com tempo de cooldown ou limite diário. Você também pode usar a API abaixo para obter o número de anúncios recompensados restantes do usuário, para decidir se deve esconder o anúncio recompensado.

const result = await window.JOGOS_SDK.ad.getRewardAdCount();
console.log('Remaining rewardAd count ', result);

Detecção de bloqueio de anúncios

Requisitos de anúncio

Nosso design de jogo permite que ele continue funcionando mesmo quando o usuário bloqueia anúncios. No entanto, o mecanismo de detecção pode gerar falsos positivos. Para evitar impacto aos usuários normais, recomendamos restrições suaves: limitar apenas conteúdo adicional (como skins especiais, fases extras) para usuários com bloqueio de anúncios e garantir que ao desativar o bloqueio, o usuário só precise atualizar a página para recuperar todas as funcionalidades.

Use os seguintes métodos para detectar se o usuário está usando um bloqueador de anúncios:

const result = await window.JOGOS_SDK.ad.hasAdblock();
console.log('Adblock usage fetched', result);