Bu sayfa, Cloud Translation API ile çevrilmiştir.

Banner reklamlar

Banner reklamlar, dikdörtgen bir resim veya metin içeren reklamlardır. Ekranda bir yer kaplar. Bunlar, kullanıcılar uygulama ile etkileşimde bulunurken ekranda kalır ve belirli bir süre sonra otomatik olarak yenilenebilir. Mobil reklamcılığa yeni başladıysanız bu yerleşimlerle başlamak iyi bir fikir olabilir. Başarılı örnek.

Bu kılavuzda, AdMob'daki banner reklamları bir Unity uygulamasına nasıl entegre edeceğiniz gösterilmektedir. 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 içerir.

Ön koşullar

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

Her zaman test reklamlarıyla test edin

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 tasarlanmıştır. Böylece kullanımı güvenli olur.

Bununla birlikte, AdMob kullanıcı arayüzüne bir uygulama kaydedip uygulamanızda kullanmak üzere kendi reklam birimi kimliklerinizi oluşturduktan sonra geliştirme sırasında cihazınızı açık bir şekilde test cihazı olarak yapılandırmanız gerekir.

Android

ca-app-pub-3940256099942544/6300978111

iOS

ca-app-pub-3940256099942544/2934735716

Mobile Ads SDK'sını ilk kullanıma hazırlayın

Reklam yüklemeden önce uygulamanızın MobileAds.Initialize() çağırarak Mobile Ads SDK'sını başlatmasını sağlayın. Bu işlemin ideal olarak uygulamanın başlatılması sırasında yalnızca bir kez 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, tüm uyumlulaştırma bağdaştırıcılarının başlatılmasını sağlar.

BannerView örneği

Aşağıdaki örnek kod, banner görünümünün nasıl kullanılacağını açıklar. Bu örnekte, banner görünümünün bir örneğini oluşturuyor, banner görünümüne bir reklam yüklemek için bir AdRequest kullanıyor ve ardından yaşam döngüsü olaylarını yöneterek işlevselliği genişletiyorsunuz.

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

Banner görünümünü kullanmanın ilk adımı, GameObject öğesine 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 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 oluşturucusu aşağıdaki parametrelere sahiptir:

adUnitId: BannerView tarafından reklam yüklenmesi gereken AdMob reklam birimi kimliği.
AdSize: Kullanmak istediğiniz AdMob reklam boyutu (ayrıntılar için Banner boyutlarına bakın).
AdPosition: Banner reklamın yerleştirilmesi gereken konum. AdPosition sıralama, geçerli reklam konumu değerlerini listeler.

Farklı reklam birimlerinin platforma bağlı olarak nasıl kullanıldığını öğrenin. iOS'te reklam isteğinde bulunmak için bir iOS reklam birimi ve Android'de istek yapmak için bir Android reklam birimi kullanmanız gerekir.

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

Bir BannerView öğesinin ekranda nereye yerleştirileceği üzerinde AdPosition değerleri tarafından sunulandan daha fazla kontrol için x ve y koordinatlarını BannerViewconstructor olarak kullanın:

// Create a 320x50 banner ad 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 kaynak, ekranın sol üst kısmındadır.

(İsteğe bağlı) Özel boyutlu 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

Banner görünümünün ikinci adımı, AdRequest oluşturup LoadAd() yöntemine iletmektir.

/// <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();
    adRequest.Keywords.Add("unity-admob-sample");

    // 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 yükleme, açma, kapatma gibi reklam yaşam döngüsündeki çeşitli etkinliklere odaklanabilirsiniz. Bu etkinlikleri dinlemek için bir yetki verilmiş kullanıcı kaydedin:

/// <summary>
/// listen to events the banner 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ü kaldır

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

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

İşte bu kadar. Uygulamanız artık AdMob'dan banner reklamlar göstermeye hazır.

Banner boyutları

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

dp cinsinden boyut (GxY)	Açıklama	Kullanılabilirlik	AdSize sabiti
320x50	Standart Banner	Telefonlar ve Tabletler	`BANNER`
320x100	Büyük Banner	Telefonlar ve Tabletler	`LARGE_BANNER`
300x250	IAB Orta Dikdörtgen	Telefonlar ve Tabletler	`MEDIUM_RECTANGLE`
468x60	IAB Tam Boyutlu Banner	Tabletler	`FULL_BANNER`
728x90	IAB Skor Tablosu	Tabletler	`LEADERBOARD`
Sağlanan genişlik x Uyarlanabilir yükseklik	Uyarlanabilir banner	Telefonlar ve Tabletler	Yok
Ekran genişliği x 32\|50\|90	Akıllı banner	Telefonlar ve Tabletler	`SMART_BANNER`
Akıllı Banner'ların yerini alan Uyarlanabilir Banner'lar hakkında daha fazla bilgi edinin.