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.

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 Ad Manager web arayüzünde 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.

/21775744923/example/adaptive-banner

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ılması sağlanır.

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şturun, banner görünümüne reklam yüklemek için AdManagerAdRequest kullanın ve yaşam döngüsü etkinliklerini işleyerek özelliklerini genişletin.

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

Banner görünümü kullanmanın ilk adımı, banner görünümü örneği oluşturmaktır.

// Create a 320x50 banner at top of the screen.
adManagerBannerView = new AdManagerBannerView("AD_UNIT_ID", AdSize.Banner, AdPosition.Top);
AdManagerBannerViewSnippets.cs

AD_UNIT_ID yerine reklam birimi kimliğinizi yazın.

AdManagerBannerView için oluşturucunun parametreleri şunlardır:

• adUnitId: Yüklenecek banner reklamın reklam birimi kimliği.
• AdSize: Kullanmak istediğiniz banner boyutu.
• AdPosition: Banner görüntülemelerinin yerleştirileceği konum.

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

AdPosition değerlerinin sunduğundan daha fazla kontrolle banner görünümünün ekranda yerleştirileceği yeri belirlemek için x ve y koordinatlarını parametre olarak alan oluşturucuyu kullanın:

// Create a 320x50 banner views at coordinate (0,50) on screen.
adManagerBannerView = new AdManagerBannerView("AD_UNIT_ID", AdSize.Banner, 0, 50);
AdManagerBannerViewSnippets.cs

Banner görünümünün sol üst köşesi, oluşturucuya iletilen x ve y değerlerine göre konumlandırılır. Burada başlangıç noktası ekranın sol üstüdür.

(İ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:

// Create a 250x250 banner at the bottom of the screen.
AdSize adSize = new AdSize(250, 250);
adManagerBannerView = new AdManagerBannerView("AD_UNIT_ID", adSize, AdPosition.Bottom);
AdManagerBannerViewSnippets.cs

(İsteğe bağlı) Birden fazla reklam boyutu

Ad Manager, bir AdManagerBannerView içinde yayınlanmaya uygun olabilecek birden fazla reklam boyutu belirtmenize olanak tanır. Bu özelliği SDK'da uygulamadan önce farklı boyutlardaki reklam öğeleriyle ilişkili aynı reklam birimlerini hedefleyen bir satır öğesi oluşturun.

Uygulamanızda, AdSize parametrelerini ValidAdSizes'ye iletin:

// Create a 250x250 banner at the bottom of the screen.
adManagerBannerView = new AdManagerBannerView("AD_UNIT_ID", AdSize.Banner, AdPosition.Top);

// Add multiple ad sizes.
adManagerBannerView.ValidAdSizes = new List<AdSize>
{
    AdSize.Banner,
    new AdSize(120, 20),
    new AdSize(250, 250),
};
AdManagerBannerViewSnippets.cs

AdManagerAdView, yenileme sırasında boyut değiştirirse düzeniniz yeni boyuta otomatik olarak uyum sağlayabilmelidir. AdManagerAdView, bir sonraki reklam döndürülene kadar ilk parametrede iletilen boyutu varsayılan olarak kullanır.

Banner reklam yükleme

AdManagerBannerView yerleştirildikten sonra AdManagerBannerView sınıfında AdManagerBannerView yöntemiyle bir reklam yüklemeye devam edin.LoadAd() Hedefleme bilgileri, hariç tutma etiketleri ve yayıncı tarafından sağlanan kimlik gibi çalışma zamanı bilgilerini içeren bir parametresi alır.

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

// Send a request to load an ad into the banner view.
adManagerBannerView.LoadAd(new AdManagerAdRequest());
AdManagerBannerViewSnippets.cs

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:

adManagerBannerView.OnBannerAdLoaded += () =>
{
    // Raised when an ad is loaded into the banner view.
};
adManagerBannerView.OnBannerAdLoadFailed += (LoadAdError error) =>
{
    // Raised when an ad fails to load into the banner view.
};
adManagerBannerView.OnAdPaid += (AdValue adValue) =>
{
    // Raised when the ad is estimated to have earned money.
};
adManagerBannerView.OnAdImpressionRecorded += () =>
{
    // Raised when an impression is recorded for an ad.
};
adManagerBannerView.OnAdClicked += () =>
{
    // Raised when a click is recorded for an ad.
};
adManagerBannerView.OnAdFullScreenContentOpened += () =>
{
    // Raised when an ad opened full screen content.
};
adManagerBannerView.OnAdFullScreenContentClosed += () =>
{
    // Raised when the ad closed full screen content.
};
AdManagerBannerViewSnippets.cs

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

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

if (adManagerBannerView != null)
{
    // Always destroy the banner view when no longer needed.
    adManagerBannerView.Destroy();
    adManagerBannerView = null;
}
AdManagerBannerViewSnippets.cs

İş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ı, Ad Manager 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 Mobil uygulamalarda reklamların yenileme hızı başlıklı makaleyi inceleyin.

Banner boyutları

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

Uygulama etkinlikleri

Uygulama etkinlikleri, uygulama kodlarına mesaj gönderebilen reklamlar oluşturmanıza olanak tanır. Uygulama daha sonra bu iletilere göre işlem yapabilir.

AppEvent kullanarak Ad Manager'a özgü uygulama etkinliklerini dinleyebilirsiniz. Bu etkinlikler, yükleme çağrılmadan önce bile reklamın yaşam döngüsünün herhangi bir noktasında gerçekleşebilir.

Bir reklamda uygulama etkinliği gerçekleştiğinde OnAppEventReceived tetiklenir. Bu etkinliğin kodunuzda nasıl işleneceğine dair bir örnek aşağıda verilmiştir:

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

Aşağıda, uygulamanızın arka plan rengini, renk adlı bir uygulama etkinliğine bağlı olarak nasıl değiştireceğinizi gösteren bir örnek verilmiştir:

adManagerBannerView.OnAppEventReceived += (AppEvent args) =>
{
    if (args.Name == "color")
    {
        Color color;
        if (ColorUtility.TryParseHtmlString(args.Data, out color))
        {
            renderer.material.color = color;
        }
    }
};
AdManagerBannerViewSnippets.cs

Aşağıda, renk uygulama etkinliğini gönderen ilgili reklam öğesi yer almaktadır:

<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: 0;
      left: 0;
      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>
AppEventSnippets.html

Ek kaynaklar

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