Publicités vidéo

Ce module implémente les publicités vidéo interstitielles et les publicités vidéo récompensées. Lisez la page JOGOS_SDK Introduction et les sections pertinentes pour votre moteur de jeu, puis utilisez les fonctionnalités de publicité vidéo comme suit :

window.JOGOS_SDK.ad;

Exigences publicitaires

Veuillez lire attentivement nos exigences publicitaires, car si votre jeu ne respecte pas ces exigences, il sera refusé sans aucun retour.

Demande de lecture d’une publicité vidéo

Nous prenons en charge deux types de publicités vidéo : les interstitielles (midgame) et les récompensées (rewarded) :

• Publicités interstitielles : peuvent être déclenchées lorsque l’utilisateur meurt, termine un niveau, etc.
• Publicités récompensées : l’utilisateur choisit de regarder une publicité pour obtenir une récompense (vie supplémentaire, résurrection après mort, objets supplémentaires, attributs supplémentaires, etc.).

// Fonctions de rappel
const callbacks = {
  // Appelé au début de la lecture de l’annonce
  onstarted: () => console.log('ad started'),
  // Appelé à la fin de la lecture de l’annonce
  onfinished: () => console.log('ad finished'),
  // Appelé en cas d’erreur pendant la lecture
  onerror: (error) => console.log('ad error:', error),
};

// Demander l’affichage d’une publicité interstitielle
window.JOGOS_SDK.ad.requestAd('midgame', callbacks);
// Demander l’affichage d’une publicité récompensée
window.JOGOS_SDK.ad.requestAd('rewarded', callbacks);

Notes sur l’utilisation des publicités

• Les publicités interstitielles ont un intervalle minimum de rafraîchissement (généralement 60 secondes). Un appel trop fréquent déclenche l’erreur : 500 At least a ${time} second interval is required to display new advertisements.

• Les publicités récompensées ont un maximum quotidien (généralement 50 par utilisateur). Un dépassement déclenche l’erreur : 500 You can only watch up to ${max} rewarded ads per day.

• Nous recommandons de concevoir les points de publicité récompensée avec un temps de recharge ou une limite quotidienne. Vous pouvez également utiliser l’API suivante pour obtenir le nombre de publicités récompensées restantes pour l’utilisateur et décider si la publicité doit être masquée.

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

Détection de blocage des publicités

Exigences publicitaires

Notre conception de jeu permet de continuer même si l’utilisateur utilise un bloqueur de publicités. Cependant, le mécanisme de détection peut être sujet à des faux positifs. Pour éviter d’affecter les utilisateurs normaux, il est recommandé de limiter les contenus premium uniquement pour les utilisateurs avec bloqueur (comme des skins spéciaux, niveaux supplémentaires) et de s’assurer qu’une fois le bloqueur désactivé, un simple rafraîchissement de la page restaure toutes les fonctionnalités.

Utilisez les méthodes suivantes pour détecter si l’utilisateur utilise un bloqueur de publicités :

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