Mostrare un annuncio interstitial per giochi H5

Gli annunci interstitial per giochi sono un formato ad accesso limitato. Per ottenere l'accesso, puoi inviare un'email all'indirizzo h5support@google.com.

Questo articolo fornisce note ed esempi che dimostrano come mostrare un annuncio interstitial per giochi H5 utilizzando la libreria Tag publisher di Google (GPT).

Gli interstitial per giochi sono annunci a pagina intera gestiti da GPT che vengono resi visibili agli utenti tramite un attivatore manuale nei giochi che vengono eseguiti su pagine web.

In questa pagina

Requisiti e consigli

  • I publisher non sono autorizzati a utilizzare l'interstitial per giochi H5 nell'inventario non di gioco. Con l'implementazione di questo formato, i publisher accettano automaticamente questa condizione. È inoltre necessario rispettare le Norme per i publisher di Google e le Linee guida di Google Ad Manager per i partner. 
  • Google si riserva il diritto di approvare o non approvare i publisher in qualsiasi momento; i publisher che violano le norme verranno successivamente esclusi dalla lista consentita.
  • Gli annunci interstitial per giochi generano la propria area annuncio. A differenza degli altri tipi di annunci, non è necessario definire un elemento <div> per gli annunci interstitial per giochi. Questi annunci creano e inseriscono automaticamente un proprio contenitore nella pagina quando un annuncio viene riempito.
  • 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, quindi ti consigliamo di ritardare la chiamata iniziale finché non sono state definite le aree annuncio statiche.
  • La gestione del traffico degli annunci interstitial manuali richiede la stessa configurazione di unità pubblicitarie ed elementi pubblicitari degli interstitial per il web standard.

Inizia a utilizzare il tagging

  1. Crea uno spazio GPT utilizzando googletag.defineOutOfPageSlot() e imposta il formato OutOfPage su googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL.
    Consulta le indicazioni tecniche per gli sviluppatori relative a GPT per gli annunci interstitial per giochi H5. 
  2. Una volta definito lo spazio, aggiungi un listener di eventi che monitori l'evento gameManualInterstitialSlotReady. Nel callback del listener di eventi, chiama il metodo makeGameManualInterstitialVisible() sull'oggetto evento fornito per visualizzare l'annuncio.
  3. Dopo aver dichiarato tutte le altre aree annuncio statiche, una chiamata a googletag.display attiverà una richiesta di completamento dell'area interstitial per giochi.
Esempio completo di tag annuncio interstitial per giochi

Esempio

<!doctype html>

<html>

<head>

  <meta charset="utf-8">

  <meta name="viewport" content="width=device-width, initial-scale=1">

  <title>Game Manual Interstitial Ad Example</title>

  <script async src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"></script>

  <script>

    window.googletag = window.googletag || { cmd: [] };

    let gameManualInterstitialSlot;

    

    googletag.cmd.push(function () {

      // Define a game manual interstitial ad slot.

      defineGameManualInterstitialSlot();

      // Define static ad slots.

      staticSlot = googletag.defineSlot(

        '/6355419/Travel/Europe', [100, 100], 'static-ad-1')

        .addService(googletag.pubads());

      // Enable SRA and services.

      googletag.pubads().enableSingleRequest();

      googletag.enableServices();

    });

    function defineGameManualInterstitialSlot() {

      gameManualInterstitialSlot = googletag.defineOutOfPageSlot(

        '/6355419/Travel/Europe/France/Paris',

        googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL);

      // Slot returns null if the page or device does not support interstitials.

      if (gameManualInterstitialSlot) {

        gameManualInterstitialSlot.addService(googletag.pubads());

        printStatus('Waiting for interstitial to be ready...');

        // Add event listener to register click handler once interstitial loads.

        // If this event doesn't fire, try clearing local storage and refreshing

        // the page.

        googletag.pubads().addEventListener('gameManualInterstitialSlotReady',

          (slotReadyEvent) => {

            if (gameManualInterstitialSlot === slotReadyEvent.slot) {

              printStatus('Interstitial is ready.');

              const button = document.getElementById('trigger');

              button.style.display = 'block';

              button.addEventListener('click', () => {

                slotReadyEvent.makeGameManualInterstitialVisible();

                printStatus('Interstitial is active.');

              }, { once: true });

            }

          });

        googletag.pubads().addEventListener('gameManualInterstitialSlotClosed',

          resumeGame);

      }

    }

    function resumeGame() {

      document.getElementById('trigger').style.display = 'none';

      // Game manual interstitial ad slots are one-time use, so destroy the old slot and create a new one.

      googletag.destroySlots([gameManualInterstitialSlot]);

      defineGameManualInterstitialSlot();

      googletag.display(gameManualInterstitialSlot);

    }

    function printStatus(status) {

      document.getElementById('status').innerText = status;

    }

  </script>

  <style>

    button {

      display: none;

    }

    div.content {

      position: fixed;

      top: 50%;

    }

  </style>

</head>

<body>

  <div id="static-ad-1" style="width: 100px; height: 100px;"></div>

  <div class="content">

    <span id="status">Game manual interstitial is not supported on this page.</span>

    <p>

      <button id="trigger">TRIGGER INTERSTITIAL</button>

    </p>

  </div>

  <script>

    googletag.cmd.push(function () {

      // Ensure the first call to display comes after static ad slot

      // divs are defined.

      googletag.display(staticSlot);

    });

  </script>

</body>

</html>

Eventi GPT

I seguenti eventi GPT vengono utilizzati per visualizzare e interagire con gli annunci interstitial per giochi:

Evento Attivato quando…

gameManualInterstitialSlotReady

Un'area annuncio interstitial per giochi è pronta per essere visualizzata.

Per visualizzare l'interstitial, chiama makeGameManualInterstitialVisible() sull'oggetto evento fornito.

gameManualInterstitialSlotClosed

Un'area annuncio interstitial per giochi che era in fase di visualizzazione è stata chiusa. Viene utilizzato per eseguire la logica personalizzata ogni volta che l'interstitial per giochi viene chiuso.

Si può eseguire il rendering dell'interstitial per giochi a schermo intero o all'interno del frame del gioco, a seconda di come viene visualizzato il gioco. Scopri di più sulle strutture degli annunci per giochi H5. 

Il codice campione riportato di seguito presuppone che il gioco H5 venga posizionato direttamente nello stesso frame superiore della pagina (utilizzando la struttura "A schermo intero"). In questo caso, anche il rendering dell'annuncio interstitial per giochi verrà 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, il gioco dovrà essere inserito in un iframe.

Esempio

<!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>

  <iframe src="https://www.example-game.com" title="Example game" allow="autoplay">

    <!-- Sample code is served here. The Google Publisher Tag loaded in this frame will only be used within the H5 game. -->

  </iframe>

</body>

</html>

Note sull'utilizzo di GPT

  • Per garantire un'esperienza utente ottimale, GPT richiede annunci interstitial per giochi solo nelle pagine che supportano correttamente il formato. Per questo motivo, defineOutOfPageSlot() potrebbe restituire un valore null. 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 mobile.
  • L'interstitial viene visualizzato quando chiami makeGameManualInterstitialVisible dall'evento GameManualInterstitialSlotReady.
  • Gli annunci interstitial per giochi hanno una quota limite fissa. In questo modo si impedisce che l'evento gameManualInterstitialSlotReady venga attivato più di una volta ogni 30 secondi.
Puoi utilizzare la simulazione mobile degli Strumenti per sviluppatori di Chrome per testare gli annunci interstitial per giochi su dispositivi mobile da un ambiente computer.

Gestione del traffico

  1. Crea una nuova unità pubblicitaria o riutilizza un'unità esistente. Seleziona 320 x 480, 300 x 250 e 336 x 280 come dimensioni dell'unità pubblicitaria.
  2. Crea gli elementi pubblicitari. Seleziona le impostazioni dell'elemento pubblicitario appropriate in base al tuo caso d'uso:
  Impostazioni dell'elemento pubblicitario
Caso d'uso Tipo di annuncio Tipo di elemento pubblicitario Creatività previste Targeting > Inventario
Pubblicare un annuncio display con prenotazione Display
  • Sponsorizzazione
  • Standard

 

320 x 480, 300 x 250 o 336 x 280

 

 

 

L'unità pubblicitaria creata o selezionata nel passaggio precedente
Pubblicare un annuncio non riservato Display
  • Priorità in base al prezzo
  • Rete
  • Collettivo
Pubblicare un annuncio video di prenotazione (ad es. un tag VAST o un file MP4) Video o audio
  • Sponsorizzazione
  • Standard
 300 x 250 v o 320 x 480 v
Pubblicare annunci di backfill/asta aperta Display Ad Exchange Tutte le dimensioni richieste
Nota: per assicurarti che la domanda display e video sia idonea per il backfill / l'asta aperta, assicurati che le protezioni "Blocca annunci display" o "Blocca annunci non in-stream" siano disattivate per l'unità pubblicitaria. 

Serie di video sulla gestione del traffico: inizia a utilizzare gli annunci interstitial per giochi H5

Guarda i video di questa serie in due parti per iniziare a utilizzare gli annunci interstitial per giochi H5

Parte 1:  annunci interstitial per i giochi H5 su Ad Manager
H5 Gaming Interstitial Ads on Ad Manager

 

Parte 2: annunci con premio per i giochi H5 su Ad Manager
Rewarded Ads for H5 Gaming on Ad Manager

Report

Il formato interstitial per giochi viene indicato come "Interstitial" nella dimensione Formato inventario.

È stato utile?

Come possiamo migliorare l'articolo?

Hai bisogno di ulteriore assistenza?

Prova i passaggi successivi indicati di seguito:

Pubblica una domanda nella community di assistenza Ricevi risposte dai membri della community
Contattaci Dacci ulteriori informazioni e potremo aiutarti
true
Massimizza le tue entrate con i consigli personalizzati oggi stesso.

Visita la pagina Consigli di ottimizzazione per Google Ad Manager per visualizzare suggerimenti personalizzati per massimizzare le tue entrate.

Massimizza ora

Ricerca
Cancella ricerca
Chiudi ricerca
Menu principale
15342878747567857293
true
Cerca nel Centro assistenza
false
true
true
true
true
true
148
false
false
false
false
false