Skip to content

Vídeo Publicitário

Este módulo implementa anúncios de vídeo interstitial e vídeos publicitários incentivados. Leia a seção relacionada ao seu motor de jogo na página Visão Geral do JOGOS_SDK e utilize as funcionalidades relacionadas a vídeos publicitários conforme descrito abaixo:

javascript
window.JOGOS_SDK.ad;
Requisitos de Publicidade

Certifique-se de ler nossos Requisitos de Publicidade, pois se seu jogo não atender a esses requisitos, ele será rejeitado sem feedback.

Solicitar exibição de vídeo publicitário

Oferecemos suporte a dois tipos diferentes de anúncios de vídeo: anúncios intersticiais (midgame) e anúncios incentivados (rewarded);

  • Anúncios intersticiais: Podem ser acionados em momentos estratégicos, como quando o usuário morre ou completa um nível.
  • Anúncios incentivados: O usuário solicita ativamente assistir a um anúncio incentivado em troca de recompensas (vidas extras, ressuscitação de personagens, itens adicionais, atributos extras, etc.).
javascript
// Funções de retorno de chamada
const callbacks = {
  // Esta função é chamada quando o anúncio começa a ser reproduzido
  onstarted: () => console.log('anúncio iniciado'),
  // Esta função é chamada quando a reprodução do anúncio é concluída
  onfinished: () => console.log('anúncio finalizado'),
  // Esta função é chamada se ocorrer um erro durante a reprodução do anúncio
  onerror: (error) => console.log('erro no anúncio:', error),
};

// Solicita a exibição de um anúncio interstitial
window.JOGOS_SDK.ad.requestAd('midgame', callbacks);
// Solicita a exibição de um anúncio incentivado
window.JOGOS_SDK.ad.requestAd('rewarded', callbacks);

Notas Importantes sobre Chamadas de Anúncios

  • Anúncios intersticiais têm um tempo mínimo de atualização (geralmente 60 segundos). Chamadas frequentes podem acionar a exceção: 500 É necessário um intervalo de pelo menos ${time} segundos para exibir novos anúncios.

  • Anúncios incentivados têm um limite máximo diário (geralmente 30 visualizações por usuário por dia). Chamadas excessivas podem acionar a exceção: 500 Você só pode assistir a um máximo de ${max} anúncios incentivados por dia.

  • Recomendamos que, ao projetar pontos de exibição de anúncios incentivados, implemente tempos de resfriamento ou limites diários. Você também pode usar a interface abaixo para obter o número restante de anúncios incentivados do usuário atual e decidir se o botão de anúncio incentivado deve ser ocultado.

javascript
const result = await window.JOGOS_SDK.ad.getRewardAdCount();
console.log('Quantidade restante de anúncios incentivados ', result);

Detecção de Bloqueio de Anúncios

Requisitos de Publicidade
Nosso sistema permite que os jogos continuem funcionando mesmo com bloqueadores de anúncios ativados, mas a detecção pode ser imprecisa. Para evitar afetar usuários legítimos, recomendamos medidas de restrição suaves: limite apenas o conteúdo premium (como skins especiais, níveis extras, etc.) para usuários com bloqueadores de anúncios e garanta que o recurso completo seja restaurado após a atualização da página. Certifique-se de implementar um sistema de salvamento automático para evitar perda de progresso devido a atualizações da página.

Use o método abaixo para detectar se o usuário está bloqueando anúncios:

javascript
const result = await window.JOGOS_SDK.ad.hasAdblock();
console.log('Detecção de bloqueador de anúncios', result);