Interstitial-Anzeige für H5-Spiele ausliefern

In diesem Beispiel wird eine Interstitial-Anzeige für Spiele mithilfe der Google Publisher-Tag-Bibliothek präsentiert. Interstitials für Spiele sind GPT-verwaltete, ganzseitige Anzeigen, die Nutzern angezeigt werden, die webbasierte Spiele spielen. Weitere Informationen zu Interstitials für Spiele finden Sie unter Interstitial-Anzeige für H5-Spiele ausliefern.

Verwenden Sie die folgenden GPT-Ereignisse, um Interstitial-Anzeigen für Spiele auszuliefern und mit ihnen zu interagieren:

Ereignis Ausgelöst, wenn...
GamingInterstitialSlotReady Eine Interstitial-Anzeige für Spiele kann dem Nutzer präsentiert werden.

Rufen Sie zum Schalten der Interstitial-Anzeige für das angegebene Ereignisobjekt die Methode makeGameManualInterstitialVisible() auf.
GamingInterstitialSlotClosed Der Nutzer hat eine zuvor eingeblendete Interstitial-Anzeige für Spiele geschlossen.

Verwenden Sie dieses Ereignis, um benutzerdefinierte Logik auszuführen, wenn ein Interstitial für Spiele geschlossen wird.

Spielstrukturen

Interstitial-Anzeigen für Spiele können je nach Struktur des Spiels entweder im Vollbildmodus oder innerhalb des Spiel-Frames ausgeliefert werden. Weitere Informationen finden Sie unter H5-Spielstrukturen.

Bei der Beispielimplementierung wird davon ausgegangen, dass das H5-Spiel mit der Struktur Fullscreen direkt im obersten Fenster gerendert wird. In diesem Fall wird die Interstitial-Anzeige für Spiele auch im Vollbildmodus gerendert.

Derselbe Code funktioniert jedoch auch, wenn er innerhalb eines untergeordneten Frames platziert wird (mithilfe der iFrame/WebView-Struktur). Um die Interstitial-Anzeige für Spiele auf die Canvas von H5-Spielen zu beschränken, platzieren Sie das Spiel in einem iFrame, wie im folgenden Beispiel gezeigt:

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

Verwendungshinweise

  • Um eine optimale Nutzererfahrung zu gewährleisten, fordert GPT Interstitial-Anzeigen für Spiele nur auf Seiten an, die das Format unterstützen. Aufgrund dieser Einschränkung kann defineOutOfPageSlot() den Wert „null“ zurückgeben. Sie müssen prüfen, ob dies der Fall ist, damit Sie nicht unnötige Arbeit leisten.

  • Fordern Sie Interstitial-Anzeigen für Spiele nur auf Seiten oder in Umgebungen an, in denen ein Interstitial präsentiert werden soll. Interstitial-Anzeigen für Spiele können auf Computern, Tablets und Mobilgeräten ausgeliefert werden.

  • Für Interstitial-Anzeigen für Spiele wird eine eigene Anzeigenfläche generiert. Anders als bei anderen Anzeigentypen muss bei Interstitial-Anzeigen für Spiele kein <div> definiert werden. Mit diesen Anzeigen wird automatisch ein eigener Container erstellt und auf der Seite eingefügt, wenn eine Anzeige eingeblendet wird.

  • Interstitial-Anzeigen für Spiele können nur einmal verwendet werden. Interstitial-Anzeigenflächen für Spiele können nicht aktualisiert werden. Stattdessen müssen Sie den Slot löschen und neu erstellen, wie in der Beispielimplementierung gezeigt.

  • Interstitial-Anzeigen für Spiele haben ein festes Frequency Capping. Das Frequency Capping verhindert, dass das Ereignis gamingInterstitialSlotReady öfter als einmal alle 120 Sekunden ausgelöst wird.

  • Wenn Sie die Einzelanfrage-Architektur auf einer Seite mit mehreren Anzeigenflächen verwenden, rufen Sie display() erst auf, wenn statische div-Elemente für Anzeigenflächen erstellt wurden. Wie in den Best Practices für Anzeigen beschrieben, wird mit dem ersten Aufruf von display() jede zuvor definierte Anzeigenfläche angefordert. Für Interstitial-Anzeigenflächen für Spiele ist kein vordefiniertes <div> erforderlich, für statische Anzeigenflächen ist das jedoch der Fall. Wenn display() aufgerufen wird, bevor diese Elemente auf der Seite vorhanden sind, kann dies zu Signalen von geringerer Qualität führen. Wir empfehlen, den ersten Aufruf so lange zu verzögern, bis die statischen Anzeigenflächen definiert sind.

Beispielimplementierung

Demo ansehen