Anuncios de vídeo
Este módulo implementa anuncios de vídeo intersticiales y anuncios de vídeo recompensados. Lea la sección relacionada con su motor de juego en la página Introducción a JOGOS_SDK
y use las funciones relacionadas con los anuncios de vídeo de la siguiente manera:
window.JOGOS_SDK.ad;
Asegúrese de leer nuestros Requisitos de anuncios, porque si su juego no cumple con estos requisitos, será rechazado sin ningún tipo de feedback.
Solicitar reproducción de anuncios de vídeo
Soportamos dos tipos diferentes de anuncios de vídeo: anuncios intersticiales (midgame
) y anuncios recompensados (rewarded
);
- Anuncios intersticiales: Los anuncios intersticiales del juego pueden activarse según corresponda cuando el usuario muere, completa un nivel, etc.
- Anuncios recompensados: Los usuarios solicitan activamente ver anuncios recompensados a cambio de recompensas (vidas extras, reaparición cuando el personaje muere, objetos adicionales, atributos extras, etc.).
// Función de callback
const callbacks = {
// Esta función se llamará cuando comience a reproducirse el anuncio
onstarted: () => console.log('ad started'),
// Esta función se llamará cuando finalice la reproducción del anuncio
onfinished: () => console.log('ad finished'),
// Esta función se llamará si ocurre un error durante la reproducción del anuncio
onerror: (error) => console.log('ad error:', error),
};
// Solicitar mostrar anuncios intersticiales
window.JOGOS_SDK.ad.requestAd('midgame', callbacks);
// Solicitar mostrar anuncios recompensados
window.JOGOS_SDK.ad.requestAd('rewarded', callbacks);
Notas sobre la llamada a anuncios
Los anuncios intersticiales tienen un tiempo de actualización mínimo (generalmente 60 segundos). Las llamadas frecuentes activarán una excepción:
500 At least a ${time} second interval is required to display new advertisements
.Los anuncios recompensados tienen un límite máximo diario (generalmente 30 veces por usuario por día). Las llamadas excesivas activarán una excepción:
500 You can only watch up to ${max} rewarded ads per day
.Recomendamos que al diseñar los puntos de anuncio recompensado, establezca un período de enfriamiento o un límite diario para estos puntos. También puede usar la siguiente interfaz para obtener el número restante de anuncios recompensados para el usuario actual y decidir si sus anuncios recompensados necesitan ocultarse.
const result = await window.JOGOS_SDK.ad.getRewardAdCount();
console.log('Remaining rewardAd count ', result);
Detección de bloqueadores de anuncios
Use el siguiente método para detectar si el usuario ha bloqueado los anuncios:
const result = await window.JOGOS_SDK.ad.hasAdblock();
console.log('Adblock usage fetched', result);