Skip to content

Publicités vidéo

Ce module implémente les publicités vidéo interstitielles et incitatives. Consultez la section correspondant à votre moteur de jeu sur la page Introduction à JOGOS_SDK et utilisez les fonctionnalités de publicité vidéo comme suit :

javascript
window.JOGOS_SDK.ad;
Exigences publicitaires

Veuillez lire attentivement nos exigences publicitaires. Si votre jeu ne les respecte pas, il sera rejeté sans aucun retour.

Demander la lecture de publicités vidéo

Nous prenons en charge deux types de publicités vidéo : interstitielles (midgame) et incitatives (rewarded) :

  • Publicités interstitielles : Peuvent être déclenchées lorsque le joueur meurt, termine un niveau, etc.
  • Publicités incitatives : L'utilisateur choisit de regarder une publicité en échange de récompenses (vies supplémentaires, renaissance du personnage, objets bonus, etc.).
javascript
// Fonctions de rappel
const callbacks = {
  // Appelée au début de la publicité
  onstarted: () => console.log('ad started'),
  // Appelée à la fin de la publicité
  onfinished: () => console.log('ad finished'),
  // Appelée en cas d'erreur
  onerror: (error) => console.log('ad error:', error),
};

// Demander une publicité interstitielle
window.JOGOS_SDK.ad.requestAd('midgame', callbacks);
// Demander une publicité incitative
window.JOGOS_SDK.ad.requestAd('rewarded', callbacks);

Notes importantes

  • Les publicités interstitielles ont un délai minimum entre les affichages (généralement 60s). Des requêtes trop fréquentes généreront une erreur : 500 At least a ${time} second interval is required to display new advertisements.

  • Les publicités incitatives ont une limite quotidienne (généralement 30 par utilisateur). Dépasser cette limite générera une erreur : 500 You can only watch up to ${max} rewarded ads per day.

  • Nous recommandons d'implémenter un système de délai ou de quota quotidien pour les publicités incitatives. Vous pouvez utiliser cette API pour vérifier le nombre restant :

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

Détection de blocage des publicités

Exigences publicitaires
Notre jeu peut fonctionner avec un bloqueur de publicités, mais la détection peut être erronée. Pour éviter de pénaliser les utilisateurs normaux, nous recommandons des restrictions modérées : limitez uniquement les contenus premium (skins spéciaux, niveaux supplémentaires, etc.) aux utilisateurs bloquant les publicités, et assurez-vous que les fonctionnalités sont restaurées après la désactivation du bloqueur. Implémentez un système de sauvegarde automatique pour éviter la perte de progression.

Utilisez cette méthode pour détecter les bloqueurs de publicités :

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