Banner reklamlar

Banner görünümleri, ekranda yer kaplayan dikdörtgen resim veya metin reklamlardır. Kullanıcılar uygulamayla etkileşim kurarken ekranda kalırlar ve sayfayı yenileyebilirler belirli bir süre sonra otomatik olarak. Mobilde yeniyseniz bu aşamalar mükemmel bir başlangıç.

Bu kılavuzda, banner görünümlerinin bir Unity uygulamasına nasıl entegre edileceği gösterilmektedir. Ayrıca ve talimatların yanı sıra boyut ve konum ayarlamayla ilgili bilgiler de içerir. düzgün şekilde banner'lar ve ek kaynaklara bağlantılar.

Ön koşullar

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

Her zaman test reklamlarıyla test etme

Aşağıdaki örnek kod, istekte bulunmak için kullanabileceğiniz bir reklam birimi kimliği içerir. test reklamları. Google Etiket Yöneticisi'nin yerine test reklamları döndürecek şekilde her istek için özel üretim reklamları oluşturun. Bu, kullanımı güvenli hale getirir.

Ancak bir uygulamayı Google Play'e kaydettikten sonra Ad Manager web arayüzü ve kendi reklam biriminizi oluşturma Uygulamanızda kullanılacak kimlikler, cihazınızı test olarak açıkça yapılandırın cihaz bahsedeceğim.

/6499/example/banner

Mobile Ads SDK'sını başlatma

Reklamları yüklemeden önce, şunu çağırarak uygulamanızın Mobile Ads SDK'sını başlatmasını sağlayın: MobileAds.Initialize() Bunun yalnızca bir kez yapılması gerekir. İdeal olarak uygulama lansmanında bu yapılı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 özelliğini kullanıyorsanız reklamları Bu işlem, 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ı ayrıntılı olarak açıklamaktadır. Bu örnekte banner görünümünün örneğini oluşturabilir, Banner görünümüne reklam yüklemek için AdManagerAdRequest ve yaşam döngüsü olaylarını yöneterek kapasitesini genişletiyor.

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

Banner görünümü kullanmanın ilk adımı, banner görünümünün GameObject öğesine ekli bir C# komut dosyasında.

  // This ad unit is configured to always serve test ads.
  private string _adUnitId = "/6499/example/banner";

  AdManagerBannerView _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 AdManagerBannerView(_adUnitId, AdSize.Banner, AdPosition.Top);
  }

Bir AdManagerBannerView oluşturucusu aşağıdakilere sahiptir: parametre:

• adUnitId: Reklamın ait olduğu reklam birimi kimliği AdManagerBannerView, reklamları yüklemelidir.
• AdSize: Kullanmak istediğiniz reklam boyutu. Banner boyutlarına bakın. inceleyebilirsiniz.
• AdPosition: Banner görünümlerinin yerleştirilmesi gereken konum. İlgili içeriği oluşturmak için kullanılan AdPosition sıralaması, geçerli reklam konumu değerlerini listeler.

Platforma bağlı olarak farklı reklam birimlerinin nasıl kullanıldığına dikkat edin. Şunu kullanmanız gerekiyor: iOS'te reklam isteklerinde bulunmak için bir iOS reklam birimi ve talep ediyor.

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

AdManagerBannerView öğesinin nerede olduğunu daha iyi kontrol etmek için sayfada, AdPosition değerlerinin sunduğundan daha fazla yer kaplarsa oluşturucuyu kullanın bu değişken için değer olarak x ve y koordinatlarını kullanabilirsiniz:

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

AdManagerBannerView öğesinin sol üst köşesi oluşturucuya iletilen x ve y değerlerine yerleştirilir. Burada başlangıç noktası dokunun.

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

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

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

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

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

Uygulamanızda, ValidAdSizes öğesine birden fazla AdSize parametresi iletin:

var adView = new AdManagerBannerView(_adUnitId, AdSize.Banner, AdPosition.Top);
adView.ValidAdSizes = new List<AdSize>
{
    AdSize.Banner, new AdSize(120, 20), new AdSize(250, 250),
};

Yenileme zamanında AdManagerAdView boyutu değişirse düzeniniz şunları yapabilir: yeni boyuta otomatik olarak uyarlanır. AdManagerAdView, varsayılan olarak boyuta ayarlanır sonraki reklam döndürülene kadar ilk parametreye geçirilir.

Banner reklam yükleme

AdManagerBannerView uygulandıktan sonra, yükleme işlemine devam edin AdManagerBannerView içinde LoadAd() yöntemini kullanan bir reklam sınıfını kullanır. Bu işlem, hedefleme bilgileri, hariç tutma etiketleri ve yayıncı gibi çalışma zamanı bilgileri verilen kimliği tanımlayabileceksiniz.

/// <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)
    {
        CreateAdManagerBannerView();
    }

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

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

İpucu: Reklam yükleme çağrısından önce, önceden yüklenmiş reklamların önbelleğini oluşturmak için gerektiğinde reklamların sıfır gecikmeyle gösterilebilmesi için bunları göstermektir. Reklamların süresi bir saat sonra dolduğu için bu önbelleği temizlemeli ve yeni reklam görebilirsiniz.

Banner görüntüleme etkinliklerini dinleme

Reklamınızın davranışını özelleştirmek için Google Ads'de bir dizi etkinlikten reklamın yaşam döngüsünü (ör. yükleme, açma veya kapatma) Bunları dinlemek için etkinlikler için, bir delege 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ü kaldır

Banner görünümünü kullanmayı tamamladığınızda, videoyu yayınlamak için Destroy() öğesini çağırmayı unutmayın. kaynaklar.

/// <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.

Şerit boyutları

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

dp (GxY) cinsinden boyut	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 Boy 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
Uyarlanabilir Banner'lar hakkında daha fazla bilgi edinin. Akıllı Banner'ların yerini alması amaçlanmıştır.

Not: Bir Android uygulaması, düzeni için çok büyük bir banner yüklemeye çalışırsa SDK bu bilgileri göstermez, bunun yerine bir hata mesajı kaydeder.

Uygulama etkinlikleri

Uygulama etkinlikleri, çocuğunuzun uygulama koduna mesaj gönderebilen reklamlar oluşturmanıza olanak tanır. Uygulama Ardından, bu mesajlara dayalı olarak işlem yapabilir.

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

namespace GoogleMobileAds.Api.AdManager;

/// The App event message sent from the ad.
public class AppEvent
{
    // Name of the app event.
    string Name;
    // Argument passed from the app event.
    string Value;
}

Bir reklamda uygulama etkinliği gerçekleştiğinde OnAppEventReceived tetiklenir. Burada kodunuzda bu etkinliğin nasıl işleneceğini gösteren örnek:

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

Uygulamanızın arka plan rengini nasıl değiştireceğinizi gösteren bir örneği aşağıda bulabilirsiniz renk adlı bir uygulama etkinliğine bağlı olarak şunları yapabilirsiniz:

_bannerview.OnAppEventReceived += (AppEvent args) =>
{
  if (args.Name == "color")
  {
    Color color;
    if (ColorUtility.TryParseColor(arg.Value, out color))
    {
      gameObject.GetComponent<Renderer>().material.color = color;
    }
  }
};

Burada da, renk uygulaması etkinliği gönderen ilgili reklam öğesi gösterilmektedir:

<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: 0px;
      left: 0px;
      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>

Ek kaynaklar

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