Geçiş reklamları

Geçiş reklamları, barındıkları uygulamanın arayüzünü kaplayan tam ekran reklamlardır. Genellikle bir uygulamanın akışındaki doğal geçiş noktalarında (ör. oyun seviyeleri arasındaki duraklatmalar sırasında) gösterilir. Bir uygulama bir kullanıcı reklama dokunabilir ve o reklamı tıklayarak devam edebilir veya kapatıp uygulamaya geri dönün.

Bu kılavuzda, geçiş reklamlarının bir Unity uygulamasına nasıl entegre edileceği açıklanmaktadır.

Ön koşullar

• Başlangıç kılavuzunu tamamlayın.

Her zaman test reklamlarıyla test etme

Aşağıdaki örnek kod, istekte bulunmak için kullanabileceğiniz bir reklam birimi kimliği içerir. test reklamları. Google Etiket Yöneticisi'nin yerine test reklamları döndürecek şekilde her istek için özel üretim reklamları oluşturun. Bu, kullanımı güvenli hale getirir.

Ancak bir uygulamayı Google Play'e kaydettikten sonra Ad Manager web arayüzü ve kendi reklam biriminizi oluşturma Uygulamanızda kullanılacak kimlikler, cihazınızı test olarak açıkça yapılandırın cihaz bahsedeceğim.

/21775744923/example/interstitial

Mobile Ads SDK'sını başlatma

Reklamları yüklemeden önce, şunu çağırarak uygulamanızın Mobile Ads SDK'sını başlatmasını sağlayın: MobileAds.Initialize() Bunun yalnızca bir kez yapılması gerekir. İdeal olarak uygulama lansmanında bu yapılır.

using GoogleMobileAds;
using GoogleMobileAds.Api;

public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize((InitializationStatus initStatus) =>
        {
            // This callback is called once the MobileAds SDK is initialized.
        });
    }
}

Uyumlulaştırma özelliğini kullanıyorsanız reklamları Bu işlem, tüm uyumlulaştırma bağdaştırıcılarının başlatılmasını sağlar.

Uygulama

Geçiş reklamlarını entegre etmek için başlıca adımlar şunlardır:

1. Geçiş reklamını yükleme
2. Geçiş reklamını göster
3. Geçiş reklamı etkinliklerini dinleme
4. Geçiş reklamını temizleme
5. Sonraki geçiş reklamını önceden yükle

Geçiş reklamını yükleme

Geçiş reklamının yüklenmesi,Load() InterstitialAd sınıf. Yükleme yöntemi, bir reklam birimi kimliği, AdManagerAdRequest nesne ve bir tamamlama işleyici reklam yükleme başarılı veya başarısız olduğunda çağrılır. Yüklenen AdManagerInterstitialAd nesnesi, tamamlama işleyicisi olabilir. Aşağıdaki örnekte, AdManagerInterstitialAd

  // This ad unit is configured to always serve test ads.
  private string _adUnitId = "/21775744923/example/interstitial";

  private InterstitialAd _interstitialAd;

  /// <summary>
  /// Loads the interstitial ad.
  /// </summary>
  public void LoadInterstitialAd()
  {
      // Clean up the old ad before loading a new one.
      if (_interstitialAd != null)
      {
            _interstitialAd.Destroy();
            _interstitialAd = null;
      }

      Debug.Log("Loading the interstitial ad.");

      // create our request used to load the ad.
      var adRequest = new AdManagerAdRequest();

      // send the request to load the ad.
      AdManagerInterstitialAd.Load(_adUnitId, adRequest,
          (InterstitialAd ad, LoadAdError error) =>
          {
              // if error is not null, the load request failed.
              if (error != null || ad == null)
              {
                  Debug.LogError("interstitial ad failed to load an ad " +
                                 "with error : " + error);
                  return;
              }

              Debug.Log("Interstitial ad loaded with response : "
                        + ad.GetResponseInfo());

              _interstitialAd = ad;
          });
  }

Uyarı: Aşağıdaki durumlarda reklam isteği tamamlama bloğundan yeni bir reklam yüklenmeye çalışılıyorsa Reklamın yüklenememesi kesinlikle önerilmez. Reklam isteğinin tamamlanması bloğundan reklam yüklemeniz gerekiyorsa sınırlı ağ bağlantısı gibi durumlarda sürekli olarak başarısız reklam isteklerinin oluşmasını önlemek için reklam yükleme yeniden denemelerini sınırlayın.

İpucu: Reklam yükleme çağrısından önce, önceden yüklenmiş reklamların önbelleğini oluşturmak için gerektiğinde reklamların sıfır gecikmeyle gösterilebilmesi için bunları göstermektir. Reklamların süresi bir saat sonra dolduğu için bu önbelleği temizlemeli ve yeni reklam görebilirsiniz.

Geçiş reklamını göster

Yüklenen bir geçiş reklamını göstermek için şu sayfada Show() yöntemini çağırın: AdManagerInterstitialAd örneği. Reklamlar her biri için bir kez gösterilebilir yükleyin. Reklamın gösterilmeye hazır olduğunu doğrulamak için CanShowAd() yöntemini kullanın.

Not: Geçiş reklamları, akışın akışındaki doğal duraklamalar sırasında Örneğin, oyunun seviyeleri arasında veya kullanıcının bir görevi tamamlamasından sonra gerçekleşenler.

/// <summary>
/// Shows the interstitial ad.
/// </summary>
public void ShowInterstitialAd()
{
    if (_interstitialAd != null && _interstitialAd.CanShowAd())
    {
        Debug.Log("Showing interstitial ad.");
        _interstitialAd.Show();
    }
    else
    {
        Debug.LogError("Interstitial ad is not ready yet.");
    }
}

Geçiş reklamı etkinliklerini dinleme

Reklamınızın davranışını daha da özelleştirmek için, reklam hedeflemesinde etkinliklerdir. Yetki verilmiş bir kullanıcı kaydederek bu etkinlikleri izleyin aşağıda gösterildiği gibidir.

private void RegisterEventHandlers(InterstitialAd interstitialAd)
{
    // Raised when the ad is estimated to have earned money.
    interstitialAd.OnAdPaid += (AdValue adValue) =>
    {
        Debug.Log(String.Format("Interstitial ad paid {0} {1}.",
            adValue.Value,
            adValue.CurrencyCode));
    };
    // Raised when an impression is recorded for an ad.
    interstitialAd.OnAdImpressionRecorded += () =>
    {
        Debug.Log("Interstitial ad recorded an impression.");
    };
    // Raised when a click is recorded for an ad.
    interstitialAd.OnAdClicked += () =>
    {
        Debug.Log("Interstitial ad was clicked.");
    };
    // Raised when an ad opened full screen content.
    interstitialAd.OnAdFullScreenContentOpened += () =>
    {
        Debug.Log("Interstitial ad full screen content opened.");
    };
    // Raised when the ad closed full screen content.
    interstitialAd.OnAdFullScreenContentClosed += () =>
    {
        Debug.Log("Interstitial ad full screen content closed.");
    };
    // Raised when the ad failed to open full screen content.
    interstitialAd.OnAdFullScreenContentFailed += (AdError error) =>
    {
        Debug.LogError("Interstitial ad failed to open full screen content " +
                       "with error : " + error);
    };
}

Geçiş reklamını temizleme

Bir AdManagerInterstitialAd ile işiniz bittiğinde, referansınızı bırakmadan önce Destroy() yöntemini çağırdığınızdan emin olun:

_interstitialAd.Destroy();

Bu işlem, eklentiye nesnenin artık kullanılmadığını ve kapladığı belleğin geri alınabileceğini bildirir. Bu yöntemin çağrılmaması bellek sızıntılarına neden olur.

Sonraki geçiş reklamını önceden yükle

Geçiş reklamları tek kullanımlık bir nesnedir. Yani, bir geçiş reklamının gösterilirse nesne tekrar kullanılamaz. Başka bir geçiş reklamı istemek için yeni AdManagerInterstitialAd nesnesi oluşturun.

Bir geçiş reklamını bir sonraki gösterim fırsatına hazırlamak için bir kez OnAdFullScreenContentClosed veya OnAdFullScreenContentFailed reklam etkinliği yükseltildi.

private void RegisterReloadHandler(InterstitialAd interstitialAd)
{
    // Raised when the ad closed full screen content.
    interstitialAd.OnAdFullScreenContentClosed += ()
    {
        Debug.Log("Interstitial Ad full screen content closed.");

        // Reload the ad so that we can show another as soon as possible.
        LoadInterstitialAd();
    };
    // Raised when the ad failed to open full screen content.
    interstitialAd.OnAdFullScreenContentFailed += (AdError error) =>
    {
        Debug.LogError("Interstitial ad failed to open full screen content " +
                       "with error : " + error);

        // Reload the ad so that we can show another as soon as possible.
        LoadInterstitialAd();
    };
}

Uygulama etkinlikleri

Uygulama etkinlikleri, çocuğunuzun uygulama koduna mesaj gönderebilen reklamlar oluşturmanıza olanak tanır. Uygulama Ardından, bu mesajlara dayalı olarak işlem yapabilir.

AppEvent kullanarak Ad Manager'a özgü uygulama etkinliklerini dinleyebilirsiniz. Bu etkinlikler ve yükleme çağrılmadan önce bile, reklamın yaşam döngüsü boyunca herhangi bir zamanda gerçekleşebilir.

namespace GoogleMobileAds.Api.AdManager;

/// The App event message sent from the ad.
public class AppEvent
{
    // Name of the app event.
    string Name;
    // Argument passed from the app event.
    string Value;
}

Bir reklamda uygulama etkinliği gerçekleştiğinde OnAppEventReceived tetiklenir. Burada kodunuzda bu etkinliğin nasıl işleneceğini gösteren örnek:

_interstitialAd.OnAppEventReceived += (AppEvent args) =>
{
    Debug.Log($"Received app event from the ad: {args.Name}, {args.Value}.");
};

Uygulamanızın arka plan rengini nasıl değiştireceğinizi gösteren bir örneği aşağıda bulabilirsiniz renk adlı bir uygulama etkinliğine bağlı olarak şunları yapabilirsiniz:

_interstitialAd.OnAppEventReceived += (AppEvent args) =>
{
  if (args.Name == "color")
  {
    Color color;
    if (ColorUtility.TryParseColor(arg.Value, out color))
    {
      gameObject.GetComponent<Renderer>().material.color = color;
    }
  }
};

Burada da, renk uygulaması etkinliği gönderen ilgili reklam öğesi gösterilmektedir:

<html>
<head>
  <script src="//www.gstatic.com/afma/api/v1/google_mobile_app_ads.js"></script>
  <script>
    document.addEventListener("DOMContentLoaded", function() {
      // Send a color=green event when ad loads.
      admob.events.dispatchAppEvent("color", "green");

      document.getElementById("ad").addEventListener("click", function() {
        // Send a color=blue event when ad is clicked.
        admob.events.dispatchAppEvent("color", "blue");
      });
    });
  </script>
  <style>
    #ad {
      width: 320px;
      height: 50px;
      top: 0px;
      left: 0px;
      font-size: 24pt;
      font-weight: bold;
      position: absolute;
      background: black;
      color: white;
      text-align: center;
    }
  </style>
</head>
<body>
  <div id="ad">Carpe diem!</div>
</body>
</html>

En iyi uygulamalar

Geçiş reklamlarının uygulamanız için doğru reklam türü olup olmadığını belirleyin.

Geçiş reklamları, doğal geçiş noktalarına sahip uygulamalarda en iyi sonucu verir. Uygulamada bir görevin tamamlanması (ör. resim paylaşma veya bir bir puan oluşturuyor. Projenizin hangi noktalarında uygulamanın en iyi görüntülü geçiş reklamlarına nasıl ulaştığını ve kullanıcının nasıl yanıt verebileceğini belirler.

Geçiş reklamı görüntülerken işlemi duraklatın.

Metin, reklam ağı reklamı, reklam kampanyası resim veya video. Uygulamanızda bir aynı zamanda reklamın kullanıcıya uygun şekilde yayınlanmasını sağlamak için bazı kaynakları bunlardan yararlanabilirsiniz. Örneğin, bir geçiş reklamında, uygulamanız tarafından üretilen tüm ses çıkışlarını duraklattığınızdan emin olun. OnAdFullScreenContentClosed() etkinliğinde sesleri çalmaya devam edebilirsiniz. Bu reklamlar, kullanıcı reklamla etkileşimi bitirdiğinde çağrılabilir. İçinde ayrıca yoğun hesaplama görevlerini geçici olarak durdurabilirsiniz. oyun döngüsü boyunca yürütülür. Bu, kullanıcının yavaş veya yanıt vermeyen grafikler ya da titreyen videolar sorunuyla karşılaşabilirsiniz.

Kullanıcıyı reklama boğmayın.

Uygulamanızda geçiş reklamlarının sıklığını artırmak çok iyi bir yol gibi görünse de, kullanıcı deneyimini daha düşük tıklama oranları sağlar. Kullanıcıların sürekli olarak uygulamanızdan artık keyif alamamalarına neden olan durumlarla karşılaşabilirsiniz.

Ek kaynaklar

• HelloWorld örneği: Tüm reklam biçimlerinin minimum düzeyde uygulanması.