Menampilkan iklan interstisial game H5

Contoh ini menampilkan iklan interstisial game menggunakan library Tag Penayang Google (GPT). Interstisial game adalah iklan halaman penuh yang dikelola GPT dan Anda tampilkan kepada pengguna yang memainkan game berbasis web berdasarkan pemicu manual. Untuk informasi selengkapnya tentang interstisial game, lihat Menampilkan iklan interstisial game H5.

Untuk menampilkan dan berinteraksi dengan iklan interstisial game, gunakan peristiwa GPT berikut:

Acara Diaktifkan saat...
GamingInterstitialSlotReady Iklan interstisial game siap ditampilkan kepada pengguna.

Untuk menampilkan interstisial, panggil makeGameManualInterstitialVisible() pada objek peristiwa yang disediakan.
GamingInterstitialSlotClosed Pengguna menutup iklan interstisial game yang sebelumnya ditampilkan.

Gunakan peristiwa ini untuk menjalankan logika kustom setiap kali interstisial game ditutup.

Struktur game

Iklan interstisial game dapat ditampilkan dalam layar penuh atau di dalam bingkai game, bergantung pada struktur game Anda. Untuk mengetahui detail selengkapnya, lihat Struktur Game H5.

Implementasi contoh mengasumsikan bahwa game H5 dirender langsung ke jendela paling atas, menggunakan struktur Layar Penuh. Dalam skenario ini, iklan interstisial game juga dirender pada layar penuh.

Namun, kode yang sama ini juga berfungsi jika ditempatkan di dalam frame turunan, menggunakan struktur iFrame/WebView. Untuk membatasi iklan interstisial game ke kanvas game H5, tempatkan game di iFrame, seperti yang ditunjukkan dalam contoh berikut:

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

Catatan penggunaan

  • Untuk memastikan pengalaman pengguna yang optimal, GPT hanya meminta iklan interstisial game di halaman yang mendukung format dengan benar. Karena pembatasan ini, defineOutOfPageSlot() dapat menampilkan null. Anda harus memeriksa kasus ini untuk memastikan Anda tidak melakukan pekerjaan yang tidak perlu.

  • Hanya minta iklan interstisial game di halaman atau lingkungan tempat Anda ingin menampilkan interstisial. Iklan interstisial game memenuhi syarat untuk ditayangkan ke desktop, tablet, dan perangkat seluler.

  • Iklan interstisial game membuat slot iklan sendiri. Tidak seperti jenis iklan lainnya, Anda tidak perlu menentukan <div> untuk iklan interstisial game. Iklan ini otomatis membuat dan menyisipkan penampung sendiri ke dalam halaman saat iklan terisi.

  • Iklan interstisial game hanya digunakan satu kali. Anda tidak dapat memuat ulang slot iklan interstisial game. Sebagai gantinya, Anda harus menghancurkan slot dan membuatnya ulang, seperti yang ditunjukkan dalam contoh penerapan.

  • Iklan interstisial game memiliki pembatasan frekuensi tetap. Pembatasan frekuensi mencegah peristiwa gamingInterstitialSlotReady diaktifkan lebih dari sekali setiap 120 detik.

  • Jika menggunakan arsitektur permintaan tunggal (SRA) di halaman dengan beberapa slot, jangan panggil display() hingga div slot iklan statis dibuat. Seperti yang dijelaskan dalam Praktik Terbaik Iklan, panggilan pertama ke display() meminta setiap slot iklan yang ditentukan sebelum titik tersebut. Meskipun slot interstisial game tidak memerlukan <div> standar, slot iklan statis memerlukannya. Pemanggilan display() sebelum elemen ini ada di halaman dapat mengakibatkan sinyal kualitas yang lebih rendah. Sebaiknya tunda panggilan awal hingga slot statis ditentukan.

Contoh penerapan

Melihat demo