Geçiş reklamları

Platform seçin: Android iOS Unity Flutter

Geçiş reklamları, barındıkları uygulamanın arayüzünü kaplayan tam ekran reklamlardır. Genellikle uygulamaların akışındaki doğal geçiş noktalarında (ör. oyun seviyeleri arasındaki duraklatmalar sırasında) görüntülenirler. Bir uygulama geçişli reklam gösterdiğinde kullanıcı, reklama dokunup hedef sayfaya gitmeyi veya reklamı kapatıp uygulamaya dönmeyi seçebilir. Örnek olay.

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

Ön koşullar

Her zaman test reklamlarıyla test yapın

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ığından kullanımı güvenlidir.

Ancak AdMob web arayüzüne bir uygulama kaydettikten ve uygulamanızda kullanılmak üzere kendi reklam birimi kimliklerinizi oluşturduktan sonra geliştirme sırasında cihazınızı açıkça 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() çağrısı yaparak Mobile Ads SDK'sını başlatmasını sağlayın. Bu işlemin yalnızca bir kez yapılması gerekir. İdeal olarak uygulama başlatılırken yapılmalıdı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 kullanıyorsanız reklamları yüklemeden önce geri çağırma işleminin gerçekleşmesini bekleyin. Bu sayede tüm uyumlulaştırma bağdaştırıcılarının başlatıldığından emin olabilirsiniz.

Uygulama

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

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

Geçiş reklamını yükleme

Geçiş reklamı yükleme işlemi, Load() sınıfındaki statik InterstitialAd yöntemi kullanılarak gerçekleştirilir. Yükleme yöntemi için bir reklam birimi kimliği, bir AdRequest nesnesi ve reklam yükleme işlemi başarılı olduğunda veya başarısız olduğunda çağrılan bir tamamlanma işleyicisi gerekir. Yüklenen InterstitialAd nesnesi, tamamlanma işleyicisinde parametre olarak sağlanır. Aşağıdaki örnekte, bir InterstitialAd 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 _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österme

Yüklenen bir geçiş reklamını göstermek için Show() örneğinde InterstitialAd 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 fazla özelleştirmek için reklamın yaşam döngüsündeki çeşitli etkinliklere bağlanabilirsiniz. Aşağıda gösterildiği gibi bir temsilci 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ı temizleme

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

_interstitialAd.Destroy();

Bu, 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ükleme

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

Bir geçiş reklamını bir sonraki gösterim fırsatı için hazırlamak üzere, OnAdFullScreenContentClosed veya OnAdFullScreenContentFailed reklam etkinliği tetiklendikten 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ı olan uygulamalarda en iyi performansı gösterir. Uygulama içinde resim paylaşma veya oyun seviyesini bitirme gibi bir görevin tamamlanması, bu tür bir nokta oluşturur. Uygulamanızın akışında hangi noktalarda geçiş reklamlarının en iyi şekilde gösterileceğini ve kullanıcının nasıl yanıt vereceğini göz önünde bulundurduğunuzdan emin olun.
Geçiş reklamı gösterilirken işlemi duraklatın.
Metin, resim veya video gibi birkaç farklı türde geçiş reklamı kullanabilirsiniz. Uygulamanız bir geçiş reklamı gösterdiğinde, reklamın bu kaynaklardan yararlanabilmesi için bazı kaynakların kullanımını da askıya aldığından emin olmanız önemlidir. Örneğin, bir geçiş reklamı gösterme çağrısı yaptığınızda uygulamanız tarafından üretilen tüm ses çıkışlarını duraklattığınızdan emin olun. Kullanıcı reklamla etkileşimi tamamladığında çağrılabilen OnAdFullScreenContentClosed() etkinliğinde ses çalmaya devam edebilirsiniz. Ayrıca, reklam gösterilirken oyun döngüsü gibi yoğun hesaplama görevlerini geçici olarak durdurmayı da düşünebilirsiniz. Bu sayede kullanıcının yavaş veya yanıt vermeyen grafikler ya da kesintili video deneyimi yaşaması önlenir.
Kullanıcıyı reklamlarla boğmayın.
Uygulamanızdaki geçiş reklamlarının sıklığını artırmak geliri artırmak için iyi bir yöntem gibi görünse de kullanıcı deneyimini olumsuz etkileyebilir ve tıklama oranlarını düşürebilir. Kullanıcıların, uygulamanızı kullanmaktan keyif alamayacak kadar sık kesintiye uğramadığından emin olun.

Ek kaynaklar

* Örnek kullanım alanı