Mostrare un annuncio interstitial per giochi H5

Questo esempio mostra un annuncio interstitial per giochi utilizzando la libreria Tag publisher di Google (GPT). Gli interstitial per giochi sono annunci a pagina intera gestiti da GPT che vengono visualizzati agli utenti che giocano a giochi basati sul web in base a un attivatore manuale. Per maggiori informazioni sugli annunci interstitial per giochi, consulta Mostrare un annuncio interstitial per giochi H5.

Per visualizzare e interagire con gli annunci interstitial per giochi, utilizza i seguenti eventi GPT:

Evento Attivato quando…
GamingInterstitialSlotReady Un annuncio interstitial per giochi è pronto per essere mostrato all'utente.

Per visualizzare l'interstitial, chiama makeGameManualInterstitialVisible() sull'oggetto evento fornito.
GamingInterstitialSlotClosed L'utente ha chiuso un annuncio interstitial per giochi visualizzato in precedenza.

Utilizza questo evento per eseguire la logica personalizzata ogni volta che un annuncio interstitial per giochi viene chiuso.

Strutture di gioco

Gli annunci interstitial per giochi possono essere visualizzati a schermo intero o all'interno del frame del tuo gioco, a seconda della sua struttura. Per maggiori dettagli, consulta Strutture per giochi H5.

L'implementazione di esempio presuppone che il gioco H5 venga visualizzato direttamente nella finestra più in alto, utilizzando la struttura A schermo intero. In questo caso, anche il rendering dell'annuncio interstitial per giochi viene eseguito a schermo intero.

Tuttavia, lo stesso codice funziona anche se posizionato all'interno di un frame secondario, utilizzando la struttura Iframe/WebView. Per vincolare l'annuncio interstitial per giochi alla tela del gioco H5, inserisci il gioco in un iframe, come mostrato nell'esempio seguente:

<!doctype html>
<html>
  <head>
    <!-- The Google Publisher Tag here, if any, will only be responsible for serving ads outside of the H5 game. -->
    <title>Page for this example H5 game</title>
    <!-- Your <head> content here. -->
  </head>
  <body>
    <span id="example-text">Example H5 game</span>

    <!-- Sample code is served here. The Google Publisher Tag loaded in this frame will only be used within the H5 game. -->
    <iframe src="https://www.example.com" title="Example game" allow="autoplay"></iframe>
  </body>
</html>

Note sull'utilizzo

  • Per garantire un'esperienza utente ottimale, GPT richiede annunci interstitial per giochi solo nelle pagine che supportano correttamente il formato. A causa di questa limitazione, defineOutOfPageSlot() potrebbe restituire un valore null. Devi controllare in questo caso per assicurarti di non svolgere operazioni non necessarie.

  • Richiedi gli annunci interstitial per giochi solo nelle pagine o negli ambienti in cui vuoi che venga visualizzato un interstitial. Gli annunci interstitial per giochi possono essere pubblicati su computer, tablet e dispositivi mobili.

  • Gli annunci interstitial per giochi generano la propria area annuncio. A differenza degli altri tipi di annunci, non è necessario definire un valore <div> per gli annunci interstitial per giochi. Questi annunci creano e inseriscono automaticamente un proprio contenitore nella pagina quando un annuncio viene riempito.

  • Gli annunci interstitial per giochi sono di uso una tantum. Non puoi aggiornare un'area annuncio interstitial per giochi. Devi invece distruggere l'area e ricrearla, come mostrato nell'implementazione di esempio.

  • Gli annunci interstitial per giochi hanno una quota limite fissa.La quota limite impedisce che l'evento gamingInterstitialSlotReady venga attivato più di una volta ogni 120 secondi.

  • Se utilizzi un'architettura di richiesta singola (SRA) su una pagina con più aree, non chiamare display() finché non vengono creati valori div di aree annuncio statiche. Come spiegato nelle best practice per gli annunci, la prima chiamata a display() richiede ogni area annuncio definita prima di quel punto. Sebbene le aree annuncio degli interstitial per giochi non richiedano un valore <div> predefinito, le aree annuncio statiche lo richiedono. Chiamare display() prima che questi elementi siano presenti nella pagina può generare indicatori di qualità inferiori. Ti consigliamo di posticipare la chiamata iniziale fino a dopo la definizione degli spazi statici.

Esempio di implementazione

Visualizza la demo