Geçiş reklamları

Geçiş reklamları, ana makine uygulamasının arayüzünü kaplayan tam ekran reklamlardır. Genellikle bir uygulama akışındaki doğal geçiş noktalarında (ör. bir oyunda seviyeler arasındaki duraklama sırasında) gösterilirler. Bir uygulama geçiş reklamı gösterdiğinde kullanıcı, reklama dokunup hedefine devam etme veya reklamı kapatıp uygulamaya dönme arasında seçim yapabilir. Örnek olay.

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

Ön koşullar

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ılmıştır ve bu sayede kullanımı güvenlidir.

Ancak,AdMob web arayüzüne bir uygulama 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.

Android

ca-app-pub-3940256099942544/1033173712

iOS

ca-app-pub-3940256099942544/4411468910

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 ana 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ı temizleyin
  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ındaki statik Load() yöntemi kullanılarak gerçekleştirilir. Yükleme yöntemi, bir reklam birimi kimliği, bir AdRequest nesnesi ve reklam yükleme başarılı veya başarısız olduğunda çağrılan bir tamamlama işleyicisi gerektirir. Yüklenen InterstitialAd nesnesi, tamamlama işleyicide bir parametre olarak sağlanır. Aşağıdaki örnekte InterstitialAd öğesinin nasıl yükleneceği gösterilmektedir.


  // These ad units are configured to always serve test ads.
#if UNITY_ANDROID
  private string _adUnitId = "ca-app-pub-3940256099942544/1033173712";
#elif UNITY_IPHONE
  private string _adUnitId = "ca-app-pub-3940256099942544/4411468910";
#else
  private string _adUnitId = "unused";
#endif

  private _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 AdRequest();

      // send the request to load the ad.
      InterstitialAd.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;
          });
  }

Geçiş reklamını göster

Yüklenmiş bir geçiş reklamı göstermek için InterstitialAd ö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.

/// <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ündeki çeşitli etkinlikleri bağlayabilirsiniz. Aşağıda gösterildiği gibi, yetki verilmiş bir kullanıcı kaydederek bu etkinlikleri dinleyin.

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ı temizleyin

Bir InterstitialAd işlemini tamamladığınızda, 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 yol açar.

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

Geçiş reklamları tek kullanımlık nesnelerdir. Bu, geçiş reklamı gösterildiğinde nesnenin tekrar kullanılamayacağı anlamına gelir. Başka bir geçiş reklamı istemek için yeni bir InterstitialAd nesnesi oluşturun.

Bir sonraki gösterim fırsatına geçiş reklamı hazırlamak için OnAdFullScreenContentClosed veya OnAdFullScreenContentFailed reklam etkinliği yükseldikten 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();
    };
}

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 olan uygulamalarda en iyi sonucu verir. Uygulama içinde bir görev tamamlamak (ör. resim paylaşmak veya bir oyun seviyesini tamamlamak) söz konusu noktanın oluşmasını sağlar. En iyi görüntülü geçiş reklamlarını uygulama akışınızın hangi noktalarında görüntüleyeceğinizi 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ız geçiş reklamı görüntülediğinde bazı kaynakların kullanımını askıya alarak reklamın bunlardan yararlanabilmesini sağlar. Örneğin, geçiş reklamı görüntüleme çağrısı yaptığınızda uygulamanız tarafından üretilen tüm ses çıkışlarını duraklattığınızdan emin olun. Sesleri OnAdFullScreenContentClosed() etkinliğinde devam ettirebilirsiniz. Sesleri, kullanıcı reklamla etkileşimi bitirdiğinde çağrılabilir. Ayrıca, reklam gösterilirken oyun döngüsü gibi yoğun hesaplama görevlerini geçici olarak durdurabilirsiniz. Bu, kullanıcının yavaş veya yanıt vermeyen grafikler ya da takılmalı videolarla karşılaşmamasını sağlar.
Kullanıcıyı reklamlarla doldurmayın.
Uygulamanızda geçiş reklamlarının sıklığını artırmak geliri artırmanın iyi bir yolu gibi görünse de kullanıcı deneyimini olumsuz yönde etkileyebilir ve tıklama oranlarını düşürebilir. Kullanıcıların uygulama deneyiminizin keyfini çıkaramayacak kadar sık kesinti yaşamadığından emin olun.

Ek kaynaklar

* Örnek kullanım alanı