Banner

Questo modulo implementa la visualizzazione e la rimozione degli annunci banner. Dopo aver letto la sezione relativa al tuo motore di gioco nella pagina Introduzione a JOGOS_SDK, puoi utilizzare le funzionalità correlate come segue:

window.JOGOS_SDK.banner;

Requisiti per gli annunci

Assicurati di leggere i nostri Requisiti per gli annunci, perché se il tuo gioco non rispetta questi requisiti, verrà rifiutato senza alcun feedback.

Richiedere la visualizzazione di un annuncio banner

Gli annunci banner sono disponibili in 5 dimensioni:

• Leaderboard (728x90)
• Medio (300x250)
• Dispositivo mobile (320x50)
• Homepage (468x60)
• Dispositivo mobile grande (320x100)

Restrizioni

• In un momento dato possono essere visualizzati solo 2 annunci banner di dimensioni diverse
• La stessa posizione di un annuncio banner deve essere visualizzata per 60 secondi prima che possa essere ricaricata
• Se il banner non rispetta le regole e le dimensioni sopra indicate, probabilmente non verrà visualizzato

Per prima cosa, devi creare un contenitore per l'annuncio banner sullo schermo, specificando opzionalmente larghezza e altezza:

<div id="banner-container" style="width: 300px; height: 250px"></div>

Quindi utilizza il seguente metodo per richiedere la visualizzazione dell'annuncio banner (nota che l'id deve corrispondere all'id del contenitore):

try {
  await window.JOGOS_SDK.banner.requestBanner('banner-container');
} catch (e) {
  console.log('Banner request error', e);
}

In un momento dato possono essere visualizzati al massimo due banner; in caso contrario, verrà lanciata un'eccezione: '500 At most two banners can be displayed at the same time'.

Eseguendo questo metodo con lo stesso id, l'annuncio originale verrà sostituito. Eseguendolo ripetutamente entro un determinato periodo di tempo (in genere 60 secondi), verrà lanciata un'eccezione: 500 The time for each call to method requestBanner cannot exceed ${time} seconds.

Rimuovere un banner specifico

Quindi utilizza il seguente metodo per rimuovere il banner con l'id specificato:

await window.JOGOS_SDK.banner.clearBanner('banner-container');

Rimuovere tutti i banner

Quindi utilizza il seguente metodo per rimuovere tutti i banner:

await window.JOGOS_SDK.banner.clearAllBanners();

Test locale

Durante il test locale, non verranno visualizzati annunci reali. Per vedere l'effetto finale di visualizzazione, puoi pacchettizzare il tuo gioco e caricarlo nell'outil QA della piattaforma per sviluppatori per il test.