Banner reklamlar

Banner görünümleri, ekranda yer kaplayan dikdörtgen şekilli resim veya metin reklamlardır. Kullanıcılar uygulamayla etkileşim kurarken ekranın üst veya alt kısmına sabitlenmiş olarak ya da kullanıcı sayfayı kaydırırken içerikle satır içi şekilde kalırlar ve belirli bir süre sonra otomatik olarak yenilenebilirler. Mobil reklamcılığa yeni başladıysanız bu kılavuzlar işe başlamak için harika bir kaynak olacaktır. Örnek olay.

Bu kılavuzda, banner görünümlerini Unity uygulamasına nasıl entegre edeceğiniz gösterilmektedir. Kılavuzda, kod snippet'leri ve talimatların yanı sıra banner'ları doğru şekilde boyutlandırma hakkında bilgiler ve ek kaynaklara bağlantılar da yer almaktadır.

Ön koşullar

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

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.

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.

BannerView örneği

Aşağıdaki örnek kodda, banner görünümünün nasıl kullanılacağı ayrıntılı olarak açıklanmaktadır. Örnekte, bir banner görünümü örneği oluşturuyor, banner görünümüne reklam yüklemek için AdRequest kullanıyor ve yaşam döngüsü etkinliklerini işleyerek özelliklerini genişletiyorsunuz.

Banner görünümü oluşturma

Banner görünümü kullanmanın ilk adımı, GameObject bağlı bir C# komut dosyasında banner görünümü örneği oluşturmaktır.

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

  BannerView _bannerView;

  /// <summary>
  /// Creates a 320x50 banner view at top of the screen.
  /// </summary>
  public void CreateBannerView()
  {
      Debug.Log("Creating banner view");

      // If we already have a banner, destroy the old one.
      if (_bannerView != null)
      {
          DestroyAd();
      }

      // Create a 320x50 banner at top of the screen
      _bannerView = new BannerView(_adUnitId, AdSize.Banner, AdPosition.Top);
  }

BannerView için oluşturucunun aşağıdaki parametreleri vardır:

• adUnitId: BannerView öğesinin reklam yüklemesi gereken reklam birimi kimliği.
• AdSize: Kullanmak istediğiniz reklam boyutu. Ayrıntılar için Banner boyutları bölümüne bakın.
• AdPosition: Banner görüntülemelerinin yerleştirileceği konum. AdPosition numaralandırılmış türü, geçerli reklam konumu değerlerini listeler.

Platforma bağlı olarak farklı reklam birimlerinin nasıl kullanıldığına dikkat edin. iOS'te reklam isteğinde bulunmak için iOS reklam birimi, Android'de istekte bulunmak için Android reklam birimi kullanmanız gerekir.

(İsteğe bağlı) Özel konuma sahip bir banner görünümü oluşturma

BannerView öğesinin ekranda yerleştirileceği yer üzerinde AdPosition değerlerinin sunduğundan daha fazla kontrol sahibi olmak için parametre olarak x ve y koordinatlarına sahip olan oluşturucuyu kullanın:

// Create a 320x50 banner views at coordinate (0,50) on screen.
_bannerView = new BannerView(_adUnitId, AdSize.Banner, 0, 50);

BannerView öğesinin sol üst köşesi, oluşturucuya iletilen x ve y değerlerine yerleştirilir. Burada başlangıç noktası, ekranın sol üst köşesidir.

(İsteğe bağlı) Özel boyutta bir banner görünümü oluşturma

AdSize sabiti kullanmanın yanı sıra reklamınız için özel bir boyut da belirtebilirsiniz:

// Use the AdSize argument to set a custom size for the ad.
AdSize adSize = new AdSize(250, 250);
_bannerView = new BannerView(_adUnitId, adSize, AdPosition.Bottom);

Banner reklam yükleme

Reklam yüklemek için bir AdRequest oluşturun ve bunu LoadAd() yöntemine iletin.

/// <summary>
/// Creates the banner view and loads a banner ad.
/// </summary>
public void LoadAd()
{
    // create an instance of a banner view first.
    if(_bannerView == null)
    {
        CreateBannerView();
    }

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

    // send the request to load the ad.
    Debug.Log("Loading banner ad.");
    _bannerView.LoadAd(adRequest);
}

Banner görüntüleme etkinliklerini dinleme

Reklamınızın davranışını özelleştirmek için reklamın yaşam döngüsündeki çeşitli etkinliklere (ör. yükleme, açma veya kapatma) bağlanabilirsiniz. Bu etkinlikleri dinlemek için bir temsilci kaydedin:

/// <summary>
/// listen to events the banner view may raise.
/// </summary>
private void ListenToAdEvents()
{
    // Raised when an ad is loaded into the banner view.
    _bannerView.OnBannerAdLoaded += () =>
    {
        Debug.Log("Banner view loaded an ad with response : "
            + _bannerView.GetResponseInfo());
    };
    // Raised when an ad fails to load into the banner view.
    _bannerView.OnBannerAdLoadFailed += (LoadAdError error) =>
    {
        Debug.LogError("Banner view failed to load an ad with error : "
            + error);
    };
    // Raised when the ad is estimated to have earned money.
    _bannerView.OnAdPaid += (AdValue adValue) =>
    {
        Debug.Log(String.Format("Banner view paid {0} {1}.",
            adValue.Value,
            adValue.CurrencyCode));
    };
    // Raised when an impression is recorded for an ad.
    _bannerView.OnAdImpressionRecorded += () =>
    {
        Debug.Log("Banner view recorded an impression.");
    };
    // Raised when a click is recorded for an ad.
    _bannerView.OnAdClicked += () =>
    {
        Debug.Log("Banner view was clicked.");
    };
    // Raised when an ad opened full screen content.
    _bannerView.OnAdFullScreenContentOpened += () =>
    {
        Debug.Log("Banner view full screen content opened.");
    };
    // Raised when the ad closed full screen content.
    _bannerView.OnAdFullScreenContentClosed += () =>
    {
        Debug.Log("Banner view full screen content closed.");
    };
}

Banner görünümünü yok etme

Banner görünümünü kullanmayı bitirdiğinizde kaynakları serbest bırakmak için Destroy() işlevini çağırdığınızdan emin olun.

/// <summary>
/// Destroys the banner view.
/// </summary>
public void DestroyAd()
{
    if (_bannerView != null)
    {
        Debug.Log("Destroying banner view.");
        _bannerView.Destroy();
        _bannerView = null;
    }
}

İşte bu kadar. Uygulamanız artık banner reklam göstermeye hazır.

Reklamı yenileme

Reklam biriminizi yenilenecek şekilde yapılandırdıysanız reklam yüklenemediğinde başka bir reklam isteğinde bulunmanız gerekmez. Google Mobile Ads SDK'sı, AdMob kullanıcı arayüzünde belirttiğiniz tüm yenileme hızlarına uyar. Yenilemeyi etkinleştirmediyseniz yeni bir istek gönderin. Yenileme hızı ayarlama gibi reklam birimi yenileme hakkında daha fazla bilgi için Banner reklamlarda otomatik yenileme özelliğini kullanma başlıklı makaleyi inceleyin.

Banner boyutları

Aşağıdaki tabloda standart banner boyutları listelenmiştir.

Ek kaynaklar

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

• Örnek kullanım alanı