Anuncios de video

Este módulo implementa anuncios de video intersticiales y anuncios de video recompensados. Lea la página JOGOS_SDK Introducción y consulte la sección relacionada con su motor de juego, luego utilice las funciones de anuncios de video de la siguiente manera:

window.JOGOS_SDK.ad;

Requisitos de anuncio

Asegúrese de leer nuestros requisitos de anuncio, ya que si su juego no cumple con estos requisitos, será rechazado sin ninguna retroalimentación.

Solicitar reproducción de anuncios de video

Soportamos dos tipos de anuncios de video: anuncios intersticiales (midgame) y anuncios recompensados (rewarded);

• Anuncios intersticiales: se pueden activar cuando el usuario muere, completa un nivel u otros eventos en el juego.
• Anuncios recompensados: el usuario opta por ver el anuncio a cambio de recompensas (vidas extra, revivir personaje, ítems adicionales, atributos adicionales, etc.).

// Funciones de callback
const callbacks = {
  // Se llama cuando el anuncio comienza
  onstarted: () => console.log('ad started'),
  // Se llama cuando el anuncio termina
  onfinished: () => console.log('ad finished'),
  // Se llama si ocurre un error en el anuncio
  onerror: (error) => console.log('ad error:', error),
};

// Solicitar mostrar anuncio intersticial
window.JOGOS_SDK.ad.requestAd('midgame', callbacks);
// Solicitar mostrar anuncio recompensado
window.JOGOS_SDK.ad.requestAd('rewarded', callbacks);

Consideraciones al usar anuncios

• Los anuncios intersticiales tienen un tiempo mínimo de refresco (generalmente 60 segundos). Llamadas frecuentes dispararán el error: 500 At least a ${time} second interval is required to display new advertisements.

• Los anuncios recompensados tienen un límite máximo diario (generalmente 50 por usuario). Llamadas en exceso dispararán el error: 500 You can only watch up to ${max} rewarded ads per day.

• Recomendamos diseñar puntos de anuncios recompensados con tiempo de enfriamiento o límite diario. También puede usar la siguiente API para obtener la cantidad restante de anuncios recompensados del usuario, para decidir si se debe ocultar el anuncio.

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

Detección de bloqueadores de anuncios

Requisitos de anuncio

El diseño de nuestro juego permite continuar funcionando incluso cuando el usuario tiene un bloqueador de anuncios activo. Sin embargo, el mecanismo de detección puede generar falsos positivos. Para evitar afectar a los usuarios normales, se recomienda aplicar restricciones suaves: limitar solo contenido adicional (como skins especiales, niveles extra) para usuarios con bloqueo de anuncios y asegurar que al desactivar el bloqueador, el usuario solo necesite refrescar la página para recuperar todas las funcionalidades.

Use los siguientes métodos para detectar si el usuario está usando un bloqueador de anuncios:

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