Skip to content

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:

javascript
window.JOGOS_SDK.ad;
Requisitos de anuncios

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.).
javascript
// 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.

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

Detección de bloqueadores de anuncios

Requisitos de anuncios
Nuestro diseño de juego permite que continúe funcionando cuando el bloqueo de anuncios está activado, pero el mecanismo de detección puede tener falsos positivos. Para evitar que los falsos positivos afecten a los usuarios normales, recomendamos adoptar medidas restrictivas suaves: solo restrinja el contenido de valor añadido (como skins especiales, niveles adicionales, etc.) a los usuarios con bloqueadores de anuncios, y asegúrese de que la funcionalidad completa se pueda restaurar simplemente actualizando la página después de desactivar el bloqueador de anuncios. Asegúrese de mejorar la función de guardado automático para evitar la pérdida de progreso debido a la actualización de la página, lo que podría afectar la experiencia del usuario.

Use el siguiente método para detectar si el usuario ha bloqueado los anuncios:

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