Afficher une annonce interstitielle pour jeux H5

Cet exemple affiche une annonce interstitielle pour jeux à l'aide de la bibliothèque Google Publisher Tag (GPT). Les interstitiels pour jeux sont des annonces pleine page gérées par GPT que vous affichez auprès des utilisateurs qui jouent à des jeux Web en fonction d'un déclencheur manuel. Pour en savoir plus sur les annonces interstitielles pour jeux, consultez la section Afficher une annonce interstitielle pour jeux H5.

Pour afficher des annonces interstitielles pour jeux et interagir avec elles, utilisez les événements GPT suivants:

Événement Se déclenche dans les cas suivants :
GamingInterstitialSlotReady Une annonce interstitielle pour les jeux est prête à être diffusée auprès de l'utilisateur.

Pour afficher l'interstitiel, appelez makeGameManualInterstitialVisible() sur l'objet d'événement fourni.
GamingInterstitialSlotClosed L'utilisateur a fermé une annonce interstitielle pour jeux précédemment affichée.

Utilisez cet événement pour exécuter une logique personnalisée chaque fois qu'un interstitiel pour jeux est fermé.

Structures de jeu

Les annonces interstitielles pour les jeux peuvent s'afficher en plein écran ou dans le frame de votre jeu, selon la structure de votre jeu. Pour en savoir plus, consultez la section Structures de jeux H5.

L'implémentation exemple suppose que le jeu H5 s'affiche directement dans la fenêtre supérieure, à l'aide de la structure Fullscreen. Dans ce scénario, l'annonce interstitielle pour jeux s'affiche également en plein écran.

Cependant, ce même code fonctionne également lorsqu'il est placé à l'intérieur d'un frame enfant, à l'aide de la structure iFrame/WebView. Pour que l'annonce interstitielle pour jeux corresponde au canevas de jeu H5, placez le jeu dans un iFrame, comme illustré dans l'exemple suivant:

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

Remarques sur l'utilisation

  • Pour garantir une expérience utilisateur optimale, GPT ne demande des annonces interstitielles pour jeux que sur les pages qui acceptent ce format. En raison de cette restriction, defineOutOfPageSlot() peut renvoyer la valeur "null". Vous devez vérifier ce cas pour vous assurer que vous n'effectuez pas de travail inutile.

  • Ne demandez des annonces interstitielles pour jeux que sur les pages ou dans les environnements où vous souhaitez qu'un interstitiel s'affiche. Les annonces interstitielles pour jeux peuvent être diffusées sur les ordinateurs, les tablettes et les appareils mobiles.

  • Les annonces interstitielles pour jeux génèrent leur propre espace publicitaire. Contrairement aux autres types d'annonces, il n'est pas nécessaire de définir un <div> pour les annonces interstitielles pour jeux. Ces annonces créent et insèrent automatiquement leur propre conteneur dans la page lorsqu'une annonce se remplit.

  • Les annonces interstitielles pour jeux sont à usage unique. Vous ne pouvez pas actualiser un espace publicitaire interstitiel pour jeux. À la place, vous devez détruire l'emplacement et le recréer, comme indiqué dans l'exemple d'implémentation.

  • Les annonces interstitielles pour jeux ont une limite de la fréquence d'exposition fixe. La limite de la fréquence d'exposition empêche l'événement gamingInterstitialSlotReady de se déclencher plus d'une fois toutes les 120 secondes.

  • Si vous utilisez l'architecture de demande simple (SRA) sur une page comportant plusieurs espaces publicitaires, n'appelez pas display() tant que des divisions d'espaces publicitaires statiques n'ont pas été créées. Comme expliqué dans les Bonnes pratiques Google Ads, le premier appel à display() demande que chaque espace publicitaire soit défini avant ce point. Bien que les espaces interstitiels pour jeux ne nécessitent pas de <div> prédéfini, les espaces publicitaires statiques en ont besoin. L'appel de display() avant que ces éléments ne soient présents sur la page peut réduire la qualité des signaux. Nous vous recommandons de retarder l'appel initial jusqu'à ce que les espaces publicitaires statiques soient définis.

Exemple d'implémentation

Regarder la démonstration