H5 oyun geçiş reklamı görüntüleme

Bu örnekte, Google Yayıncı Etiketi (GPT) kitaplığı kullanılarak bir oyun geçiş reklamı gösterilmektedir. Oyun geçiş reklamları, manuel tetikleyiciye göre web tabanlı oyunlar oynayan kullanıcılara gösterdiğiniz ve GPT tarafından yönetilen tam sayfa reklamlardır. Oyun geçiş reklamları hakkında daha fazla bilgi için H5 oyun geçiş reklamı görüntüleme başlıklı makaleyi inceleyin.

Oyun geçiş reklamlarını görüntülemek ve bunlarla etkileşime geçmek için aşağıdaki GPT etkinliklerini kullanın:

Etkinlik Tetiklenme zamanı...
GamingInterstitialSlotReady Oyun geçiş reklamı kullanıcıya gösterilmeye hazır.

Geçiş reklamını görüntülemek için sağlanan etkinlik nesnesinde makeGameManualInterstitialVisible() işlevini çağırın.
GamingInterstitialSlotClosed Kullanıcı daha önce gösterilen bir oyun geçiş reklamını kapattı.

Bir oyun geçiş reklamı kapatıldığında özel mantık çalıştırmak için bu etkinliği kullanın.

Oyun yapıları

Oyun geçiş reklamları, oyununuzun nasıl yapılandırıldığına bağlı olarak tam ekran veya oyun çerçevesi içinde gösterilebilir. Daha fazla bilgi için H5 Oyunu yapıları başlıklı makaleyi inceleyin.

Örnek uygulamada, H5 oyununun Tam Ekran yapısı kullanılarak doğrudan en üst pencerede oluşturulduğu varsayılır. Bu senaryoda, oyun geçiş reklamı da tam ekranda oluşturulur.

Bununla birlikte, bu kod iFrame/WebView yapısı kullanılarak bir alt çerçevenin içine yerleştirildiğinde de çalışır. Oyun geçiş reklamını H5 oyun tuvaliyle sınırlamak için oyunu aşağıdaki örnekte gösterildiği gibi bir iFrame'e yerleştirin:

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

Kullanım notları

  • GPT, en iyi kullanıcı deneyimini sağlamak için yalnızca biçimi düzgün şekilde destekleyen sayfalarda oyun geçiş reklamları ister. Bu kısıtlama nedeniyle defineOutOfPageSlot(), null döndürebilir. Gereksiz bir iş yapmadığınızdan emin olmak için bu durumu kontrol etmeniz gerekir.

  • Yalnızca bir geçiş reklamının görünmesini istediğiniz sayfalarda veya ortamlarda oyun geçiş reklamları isteyin. Oyun geçiş reklamları; masaüstü, tablet ve mobil cihazlarda yayınlanmaya uygundur.

  • Oyun geçiş reklamları kendi reklam alanlarını oluşturur. Diğer reklam türlerinin aksine, oyun geçiş reklamları için <div> tanımlamaya gerek yoktur. Bu reklamlar, bir reklam yüklendiğinde kendi kapsayıcılarını otomatik olarak oluşturup sayfaya ekler.

  • Oyun geçiş reklamları tek kullanımlıktır. Oyun geçiş reklamı alanını yenileyemezsiniz. Bunun yerine, örnek uygulamada gösterildiği gibi yuvayı yok edip yeniden oluşturmanız gerekir.

  • Oyun geçiş reklamlarının sabit bir sıklık sınırı vardır. Sıklık sınırı, gamingInterstitialSlotReady etkinliğinin her 120 saniyede bir defadan fazla tetiklenmesini engeller.

  • Birden fazla alan içeren sayfada tekli istek mimarisi (SRA) kullanıyorsanız statik reklam alanı div'leri oluşturulana kadar display() çağırmayın. Google Ads En İyi Uygulamaları bölümünde açıklandığı gibi, display() işlevine yapılan ilk çağrı bu noktadan önce tanımlanmış her reklam alanını ister. Oyun geçiş reklamı alanları için önceden tanımlanmış bir <div> gerekmese de statik reklam alanları için gerekir. display(), bu öğeler sayfaya eklenmeden önce çağrılırsa sinyallerin kalitesi düşebilir. İlk çağrıyı, statik alanlar tanımlanana kadar ertelemenizi öneririz.

Örnek uygulama

Demoyu görüntüleyin