Geçiş reklamları

Geçiş reklamları, ana makine uygulamasının arayüzünü kapsayan tam ekran reklamlardır. Genellikle bir uygulamanın akışındaki doğal geçiş noktalarında (örneğin, bir oyunda seviyeler arasındaki duraklamalar sırasında) gösterilirler. Bir uygulamada geçiş reklamı gösterildiğinde kullanıcı, reklama dokunup hedefine devam etme veya reklamı kapatıp uygulamaya dönmeyi tercih edebilir.

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, test reklamları istemek için kullanabileceğiniz bir reklam birimi kimliği içerir. Her istek için üretim reklamları yerine test reklamları döndürecek şekilde özel olarak yapılandırıldığı için kullanımı güvenlidir.

AncakAd Manager web arayüzünde bir uygulamayı kaydettikten ve uygulamanızda kullanmak için kendi reklam birimi kimliklerinizi oluşturduktan sonra, geliştirme sırasında cihazınızı açık bir şekilde test cihazı olarak yapılandırın.

/6499/example/interstitial

Mobile Ads SDK'sını başlatma

Reklamları yüklemeden önce uygulamanızın MobileAds.Initialize() yöntemini çağırarak Mobile Ads SDK'sını başlatmasını sağlayın. Bu işlem yalnızca bir kez, ideal olarak uygulamanın lansmanında yapılması gerekir.

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 kullanıyorsanız reklamları yüklemeden önce geri çağırmanın gerçekleşmesini bekleyin. 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ı yükleme işlemi, InterstitialAd sınıfında statik Load() yöntemi kullanılarak gerçekleştirilir. Yükleme yöntemi; reklam yükleme başarılı veya başarısız olduğunda çağrılan bir tamamlama işleyici, AdManagerAdRequest nesnesi ve reklam birimi kimliği gerektirir. Yüklenen AdManagerInterstitialAd nesnesi, tamamlama işleyicide parametre olarak sağlanır. Aşağıdaki örnekte AdManagerInterstitialAd dosyasının nasıl yükleneceği gösterilmektedir.

  // This ad unit is configured to always serve test ads.
  private string _adUnitId = "/6499/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ı: Bir reklamın yüklenemediği durumlarda reklam isteği tamamlama bloğundan yeni bir reklam yüklemeye çalışılması kesinlikle önerilmez. Reklam isteği tamamlama bloğundan bir reklam yüklemeniz gerekiyorsa sınırlı ağ bağlantısı gibi durumlarda sürekli başarısız reklam isteklerini önlemek için reklam yükleme denemelerini sınırlayın.

İpucu: Reklam yükleme çağrılarını kullanarak reklam gösterilmeden önce önceden yüklenmiş reklamların önbelleğini oluşturabilirsiniz. Böylece, reklamlar gerektiğinde gecikme olmadan gösterilebilir. Reklamların süresi bir saat sonra sona erdiği için bu önbelleği temizlemeniz ve saat başı yeni reklamlarla yeniden yüklemeniz gerekir.

Geçiş reklamını göster

Yüklenen bir geçiş reklamını göstermek için AdManagerInterstitialAd örneğinde Show() yöntemini çağırın. Reklamlar, yükleme başına bir kez gösterilebilir. Reklamın gösterilmeye hazır olduğunu doğrulamak için CanShowAd() yöntemini kullanın.

Not: Geçiş reklamları, bir uygulamanın akışındaki doğal duraklamalar sırasında (örneğin, bir oyunun seviyeleri arasında veya kullanıcı bir görevi tamamladıktan sonra) gösterilmelidir.

/// <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ın yaşam döngüsünde bir dizi etkinliği kullanabilirsiniz. Aşağıda gösterildiği gibi, bir temsilci kaydederek bu etkinlikleri izleyin.

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ı bırakmadan önce Destroy() yöntemini çağırdığınızdan emin olun:

_interstitialAd.Destroy();

Bu işlem, eklentiye nesnenin artık kullanılmadığı ve kapladığı belleğin yeniden kullanılabileceği konusunda bilgi verir. 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. Bu, geçiş reklamı gösterildikten sonra nesnenin tekrar kullanılamayacağı anlamına gelir. Başka bir geçiş reklamı istemek için yeni bir AdManagerInterstitialAd nesnesi oluşturun.

Bir geçiş reklamını sonraki gösterim fırsatına hazırlamak için OnAdFullScreenContentClosed veya OnAdFullScreenContentFailed reklam etkinliği oluşturulduktan sonra geçiş reklamını önceden yükleyin.

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, kullanıcıların uygulama kodlarına mesaj gönderebilen reklamlar oluşturmanıza olanak tanır. Daha sonra uygulama, bu mesajlara göre işlem yapabilir.

AppEvent kullanarak Ad Manager'daki belirli uygulama etkinliklerini dinleyebilirsiniz. Bu etkinlikler, yük ç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;
}

Reklamda bir uygulama etkinliği gerçekleştiğinde OnAppEventReceived toplanır. Aşağıda, bu etkinliği kodunuzda nasıl işleyeceğinizi gösteren bir örnek verilmiştir:

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

Renk adı olan bir uygulama etkinliğine bağlı olarak uygulamanızın arka plan renginin nasıl değiştirileceğini gösteren bir örneği aşağıda bulabilirsiniz:

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

Aşağıda, renk uygulaması etkinliğini 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. Uygulama içinde bir görevin sonuçlanması (ör. resim paylaşma veya oyun seviyesini tamamlama) böyle bir nokta oluşturur. Geçiş reklamlarını en iyi şekilde görüntülemek için uygulamanızın akışında hangi noktalarda olduğunu ve kullanıcının nasıl yanıt verebileceğini göz önünde bulundurduğunuzdan emin olun.

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

Metin, resim veya video gibi birkaç farklı geçiş reklamı türü vardır. Uygulamanızda bir geçiş reklamı görüntülendiğinde, reklamın bunlardan yararlanabilmesi için bazı kaynakların kullanımını askıya alması da önemlidir. Örneğin, bir geçiş reklamı göstermek için çağrı yaptığınızda, uygulamanız tarafından üretilen tüm ses çıkışlarını duraklattığınızdan emin olun. Sesleri çalmaya OnAdFullScreenContentClosed() etkinliğinde devam edebilirsiniz. Sesleri, kullanıcı reklamla etkileşimi bitirdiğinde çağrılabilir. Ayrıca, oyun döngüsü gibi yoğun hesaplama görevlerini reklam gösterilirken geçici olarak durdurabilirsiniz. Bu da kullanıcının yavaş veya yanıt vermeyen grafikler ya da takılan videolar yaşamamasını sağlar.

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

Uygulamanızda geçiş reklamlarının sıklığını artırmak, geliri artırmanın mükemmel bir yolu gibi görünse de kullanıcı deneyiminin kalitesini düşürebilir ve tıklama oranlarını düşürebilir. Kullanıcıların, uygulamanızın keyfini süremeyecekleri kadar sık kesinti yaşamadıklarından emin olun.

Ek kaynaklar

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