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:
window.JOGOS_SDK.ad;
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.).
// 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.
const result = await window.JOGOS_SDK.ad.getRewardAdCount();
console.log('Quantidade restante de anúncios incentivados ', result);
Detecção de Bloqueio de Anúncios
Use o método abaixo para detectar se o usuário está bloqueando anúncios:
const result = await window.JOGOS_SDK.ad.hasAdblock();
console.log('Detecção de bloqueador de anúncios', result);