Pubblicità video

Questo modulo implementa pubblicità video interstiziali e a ricompensa. Leggi la sezione relativa al tuo motore di gioco nella pagina Introduzione a JOGOS_SDK e utilizza le funzionalità delle pubblicità video come segue:

window.JOGOS_SDK.ad;

Requisiti pubblicitari

Leggi attentamente i nostri requisiti pubblicitari perché se il tuo gioco non li rispetta, verrà rifiutato senza feedback.

Richiedere la riproduzione di pubblicità video

Supportiamo due tipi di pubblicità video: interstiziale (midgame) e a ricompensa (rewarded);

• Pubblicità interstiziale: Può essere attivata quando l'utente muore, completa un livello, ecc.
• Pubblicità a ricompensa: L'utente richiede volontariamente di visualizzare la pubblicità in cambio di premi (vite extra, resurrezione del personaggio, oggetti bonus, ecc.).

// Funzioni di callback
const callbacks = {
  // Chiamata all'inizio della pubblicità
  onstarted: () => console.log('ad started'),
  // Chiamata alla fine della pubblicità
  onfinished: () => console.log('ad finished'),
  // Chiamata in caso di errore
  onerror: (error) => console.log('ad error:', error),
};

// Richiedi pubblicità interstiziale
window.JOGOS_SDK.ad.requestAd('midgame', callbacks);
// Richiedi pubblicità a ricompensa
window.JOGOS_SDK.ad.requestAd('rewarded', callbacks);

Note importanti

• Le pubblicità interstiziali hanno un tempo minimo di refresh (solitamente 60 secondi). Richieste troppo frequenti genereranno un errore: 500 At least a ${time} second interval is required to display new advertisements.

• Le pubblicità a ricompensa hanno un limite giornaliero (solitamente 30 per utente al giorno). Superare il limite genererà un errore: 500 You can only watch up to ${max} rewarded ads per day.

• Consigliamo di implementare un sistema di cooldown o limiti giornalieri per le pubblicità a ricompensa. Puoi usare questa API per verificare il numero rimanente:

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

Rilevamento blocca pubblicità

Requisiti pubblicitari

Il nostro gioco può funzionare con i blocca-pubblicità attivi, ma il meccanismo di rilevamento potrebbe generare falsi positivi. Per evitare di penalizzare utenti normali, consigliamo restrizioni moderate: limitare solo contenuti premium (skin speciali, livelli extra...) agli utenti con blocca-pubblicità, assicurandosi che le funzionalità siano ripristinate dopo la disattivazione. Implementa un sistema di salvataggio automatico per evitare perdite di progresso.

Usa questo metodo per rilevare i blocca-pubblicità:

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