Banner reklamlar, ekranda bir yeri kaplayan dikdörtgen resim veya metin reklamlardır. Kullanıcılar uygulamayla etkileşimde bulunurken ekranda kalırlar ve belirli bir süre sonra otomatik olarak yenilenebilirler. Mobil reklamcılığa yeni başladıysanız başlangıç için mükemmel bir seçenektir. Başarılı örnek.
Bu kılavuzda, AdMob'dan banner reklamları bir Unity uygulamasına nasıl entegre edeceğiniz açıklanmaktadır. Ayrıca, kod snippet'leri ve talimatların yanı sıra, banner'ları doğru şekilde boyutlandırma ve ek kaynakların bağlantıları hakkında bilgiler de 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 kodda, banner görünümünün nasıl kullanılacağı açıklanmaktadır. Örnekte bir banner görünümü örneği oluşturur, banner görünümüne bir reklam yüklemek için AdRequest
kullanır ve ardından yaşam döngüsü etkinliklerini işleyerek işlevi genişletirsiniz.
Banner görünümü oluşturma
Banner görünümünü kullanmanın ilk adımı, GameObject
alanına bağlı 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
reklamlarının yüklenmesi gereken AdMob reklam birimi kimliği.AdSize
: Kullanmak istediğiniz AdMob reklam boyutu (ayrıntılar için Banner boyutları bölümüne bakın).AdPosition
: Banner reklamın yerleştirilmesi gereken konum.AdPosition
sıralaması, geçerli reklam konumu değerlerini listeler.
Farklı reklam birimlerinin platforma bağlı olarak nasıl kullanıldığını not edin. iOS'ta reklam isteğinde bulunmak için iOS reklam birimi, Android'de istek yapmak için Android reklam birimi kullanmanız gerekir.
(İsteğe bağlı) Özel konum içeren bir banner görünümü oluşturma
Bir BannerView
öğesinin ekranda nereye yerleştirileceği üzerinde AdPosition
değerleri tarafından sağlanandan daha fazla kontrol için parametre olarak x ve y koordinatlarına sahip BannerViewconstructor
özelliğini 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, kaynak oluşturucuya iletilen x ve y değerlerine konumlandırılır. Burada kaynak, ekranın sol üst kısmıdır.
(İsteğe bağlı) Özel boyutla bir banner görünümü oluşturma
AdSize
sabiti kullanmaya ek olarak 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ükle
Banner görünümünü kullanmanın ikinci adımı, AdRequest
oluşturmak ve LoadAd()
yöntemine geçirmektir.
/// <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.Builder()
.AddKeyword("unity-admob-sample")
.Build();
// send the request to load the ad.
Debug.Log("Loading banner ad.");
_bannerView.LoadAd(adRequest);
}
Banner görünümü etkinliklerini dinleyin
Reklamınızın davranışını özelleştirmek için reklamın yaşam döngüsündeki yükleme, açma, kapatma gibi ç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ü kullandığınızda, 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 AdMob'dan banner reklamlar görüntülemeye 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 alması planlanan Uyarlanabilir Banner'lar hakkında daha fazla bilgi edinin. |
Ek kaynaklar
Örnekler
- HelloWorld örneği: Tüm reklam biçimlerinin minimum düzeyde uygulanması.