Annunci video

Questo modulo implementa annunci video interstitial e ricompensa.
Leggi la sezione del motore di gioco che utilizzi nella pagina Introduzione a JOGOS_SDK e usa le funzionalità come mostrato di seguito:

window.JOGOS_SDK.ad;

Requisiti pubblicitari

Leggere obbligatoriamente i nostri Requisiti pubblicitari; il mancato rispetto comporterà il rifiuto del gioco senza alcun feedback.

Richiedere la riproduzione di un annuncio video

Supportiamo due tipi di annunci video: interstitial (midgame) e ricompensa (rewarded).

• Interstitial: può essere mostrato a morte del giocatore, completamento livello, ecc.
• Ricompensa: l’utente chiede di guardare l’annuncio in cambio di premi (vite extra, resurrezione, oggetti, bonus, ecc.).

// funzioni di callback
const callbacks = {
  // chiamata quando l’annuncio inizia
  onstarted: () => console.log('ad started'),
  // chiamata quando l’annuncio finisce
  onfinished: () => console.log('ad finished'),
  // chiamata in caso di errore
  onerror: (error) => console.log('ad error:', error),
};

// richiesta interstitial
window.JOGOS_SDK.ad.requestAd('midgame', callbacks);
// richiesta rewarded
window.JOGOS_SDK.ad.requestAd('rewarded', callbacks);

Note d’uso

• Gli interstitial hanno un intervallo minimo (solitamente 60 s); chiamate troppo frequenti restituiscono:
  500 At least a ${time} second interval is required to display new advertisements.
• I rewarded hanno un limite giornaliero (es. 50 visualizzazioni per utente); superato il limite si ottiene:
  500 You can only watch up to ${max} rewarded ads per day.

Consigliamo di prevedere cooldown o limite giornaliero per ogni punto rewarded. Potete inoltre ottenere il numero di visualizzazioni rimaste per decidere se nascondere il bottone:

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

Rilevamento ad-block

Requisiti pubblicitari

Il gioco continua a funzionare anche se rilevato un ad-blocker. Poiché il rilevamento può generare falsi positivi, applicare solo restrizioni lievi (es. contenuti premium come skin speciali o livelli extra) e assicurarsi che, disattivato l’ad-block, basti un refresh per ripristinare tutto.

Verificare la presenza di un ad-blocker:

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