Geçiş reklamları, ana makine uygulamasının arayüzünü kapsayan tam ekran reklamlardır. Genellikle bir uygulamanın akışındaki doğal geçiş noktalarında (örneğin, bir oyunda seviyeler arasındaki duraklamalar sırasında) gösterilirler. Bir uygulamada geçiş reklamı gösterildiğinde, kullanıcı reklama dokunup hedefine devam etme veya reklamı kapatıp uygulamaya dönmeyi tercih edebilir. Örnek olay.
Bu kılavuzda, geçiş reklamlarının bir Unity uygulamasına nasıl entegre edileceği açıklanmaktadır.
Ön koşullar
- Başlangıç kılavuzunu tamamlayın.
Her zaman test reklamlarıyla test etme
Aşağıdaki örnek kod, test reklamları istemek için kullanabileceğiniz bir reklam birimi kimliği içerir. Her istek için üretim reklamı yerine test reklamları döndürecek şekilde özel olarak yapılandırılmıştır. Bu sayede kullanımı güvenlidir.
Ancak AdMob web arayüzünde bir uygulamayı kaydettikten ve 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ırın.
Android
ca-app-pub-3940256099942544/1033173712
iOS
ca-app-pub-3940256099942544/4411468910
Mobile Ads SDK'sını başlatma
Reklamları yüklemeden önce, MobileAds.Initialize()
çağırarak uygulamanızın Mobile Ads SDK'sını başlatmasını sağlayın. 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 kullanıyorsanız reklamları yüklemeden önce geri çağırmanın gerçekleşmesini bekleyin. Bu işlem, tüm uyumlulaştırma bağdaştırıcılarının başlatılmasını sağlar.
Uygulama
Geçiş reklamlarını entegre etmek için başlıca adımlar şunlardır:
- Geçiş reklamını yükleme
- Geçiş reklamını göster
- Geçiş reklamı etkinliklerini dinleme
- Geçiş reklamını temizleme
- Sonraki geçiş reklamını önceden yükle
Geçiş reklamını yükleme
Geçiş reklamı yükleme işlemi, InterstitialAd
sınıfında statik Load()
yöntemi kullanılarak gerçekleştirilir. Yükleme yöntemi; reklam yükleme başarılı veya başarısız olduğunda çağrılan bir tamamlama işleyici, AdRequest
nesnesi ve reklam birimi kimliği gerektirir. Yüklenen InterstitialAd
nesnesi, tamamlama işleyicide parametre olarak sağlanır. Aşağıdaki örnekte InterstitialAd
dosyasının nasıl yükleneceği gösterilmektedir.
// These ad units are configured to always serve test ads.
#if UNITY_ANDROID
private string _adUnitId = "ca-app-pub-3940256099942544/1033173712";
#elif UNITY_IPHONE
private string _adUnitId = "ca-app-pub-3940256099942544/4411468910";
#else
private string _adUnitId = "unused";
#endif
private InterstitialAd _interstitialAd;
/// <summary>
/// Loads the interstitial ad.
/// </summary>
public void LoadInterstitialAd()
{
// Clean up the old ad before loading a new one.
if (_interstitialAd != null)
{
_interstitialAd.Destroy();
_interstitialAd = null;
}
Debug.Log("Loading the interstitial ad.");
// create our request used to load the ad.
var adRequest = new AdRequest();
// send the request to load the ad.
InterstitialAd.Load(_adUnitId, adRequest,
(InterstitialAd ad, LoadAdError error) =>
{
// if error is not null, the load request failed.
if (error != null || ad == null)
{
Debug.LogError("interstitial ad failed to load an ad " +
"with error : " + error);
return;
}
Debug.Log("Interstitial ad loaded with response : "
+ ad.GetResponseInfo());
_interstitialAd = ad;
});
}
Geçiş reklamını göster
Yüklenen bir geçiş reklamını göstermek için InterstitialAd
örneğinde Show()
yöntemini çağırın. Reklamlar, yükleme başına bir kez gösterilebilir. Reklamın gösterilmeye hazır olduğunu doğrulamak için CanShowAd()
yöntemini kullanın.
/// <summary>
/// Shows the interstitial ad.
/// </summary>
public void ShowInterstitialAd()
{
if (_interstitialAd != null && _interstitialAd.CanShowAd())
{
Debug.Log("Showing interstitial ad.");
_interstitialAd.Show();
}
else
{
Debug.LogError("Interstitial ad is not ready yet.");
}
}
Geçiş reklamı etkinliklerini dinleme
Reklamınızın davranışını daha da özelleştirmek için reklamın yaşam döngüsünde bir dizi etkinliği kullanabilirsiniz. Aşağıda gösterildiği gibi, bir temsilci kaydederek bu etkinlikleri izleyin.
private void RegisterEventHandlers(InterstitialAd interstitialAd)
{
// Raised when the ad is estimated to have earned money.
interstitialAd.OnAdPaid += (AdValue adValue) =>
{
Debug.Log(String.Format("Interstitial ad paid {0} {1}.",
adValue.Value,
adValue.CurrencyCode));
};
// Raised when an impression is recorded for an ad.
interstitialAd.OnAdImpressionRecorded += () =>
{
Debug.Log("Interstitial ad recorded an impression.");
};
// Raised when a click is recorded for an ad.
interstitialAd.OnAdClicked += () =>
{
Debug.Log("Interstitial ad was clicked.");
};
// Raised when an ad opened full screen content.
interstitialAd.OnAdFullScreenContentOpened += () =>
{
Debug.Log("Interstitial ad full screen content opened.");
};
// Raised when the ad closed full screen content.
interstitialAd.OnAdFullScreenContentClosed += () =>
{
Debug.Log("Interstitial ad full screen content closed.");
};
// Raised when the ad failed to open full screen content.
interstitialAd.OnAdFullScreenContentFailed += (AdError error) =>
{
Debug.LogError("Interstitial ad failed to open full screen content " +
"with error : " + error);
};
}
Geçiş reklamını temizleme
Bir InterstitialAd
ile işiniz bittiğinde, referansı bırakmadan önce Destroy()
yöntemini çağırdığınızdan emin olun:
_interstitialAd.Destroy();
Bu işlem, eklentiye nesnenin artık kullanılmadığı ve kapladığı belleğin yeniden kullanılabileceği konusunda bilgi verir. Bu yöntemin çağrılmaması bellek sızıntılarına neden olur.
Sonraki geçiş reklamını önceden yükle
Geçiş reklamları tek kullanımlık bir nesnedir. Bu, geçiş reklamı gösterildikten sonra nesnenin tekrar kullanılamayacağı anlamına gelir. Başka bir geçiş reklamı istemek için yeni bir InterstitialAd
nesnesi oluşturun.
Bir geçiş reklamını sonraki gösterim fırsatına hazırlamak için OnAdFullScreenContentClosed
veya OnAdFullScreenContentFailed
reklam etkinliği oluşturulduktan sonra geçiş reklamını önceden yükleyin.
private void RegisterReloadHandler(InterstitialAd interstitialAd)
{
// Raised when the ad closed full screen content.
interstitialAd.OnAdFullScreenContentClosed += ()
{
Debug.Log("Interstitial Ad full screen content closed.");
// Reload the ad so that we can show another as soon as possible.
LoadInterstitialAd();
};
// Raised when the ad failed to open full screen content.
interstitialAd.OnAdFullScreenContentFailed += (AdError error) =>
{
Debug.LogError("Interstitial ad failed to open full screen content " +
"with error : " + error);
// Reload the ad so that we can show another as soon as possible.
LoadInterstitialAd();
};
}
En iyi uygulamalar
- Geçiş reklamlarının uygulamanız için doğru reklam türü olup olmadığını belirleyin.
- Geçiş reklamları, doğal geçiş noktalarına sahip uygulamalarda en iyi sonucu verir. Uygulama içinde bir görevin sonuçlanması (ör. resim paylaşma veya oyun seviyesini tamamlama) böyle bir nokta oluşturur. Geçiş reklamlarını en iyi şekilde görüntülemek için uygulamanızın akışında hangi noktalarda olduğunu ve kullanıcının nasıl yanıt verebileceğini göz önünde bulundurduğunuzdan emin olun.
- Geçiş reklamı görüntülerken işlemi duraklatın.
- Metin, resim veya video gibi birkaç farklı geçiş reklamı türü vardır. Uygulamanızda bir geçiş reklamı görüntülendiğinde, reklamın bunlardan yararlanabilmesi için bazı kaynakların kullanımını askıya alması da önemlidir. Örneğin, bir geçiş reklamı göstermek için çağrı yaptığınızda, uygulamanız tarafından üretilen tüm ses çıkışlarını duraklattığınızdan emin olun. Sesleri çalmaya
OnAdFullScreenContentClosed()
etkinliğinde devam edebilirsiniz. Sesleri, kullanıcı reklamla etkileşimi bitirdiğinde çağrılabilir. Ayrıca, oyun döngüsü gibi yoğun hesaplama görevlerini reklam gösterilirken geçici olarak durdurabilirsiniz. Bu da kullanıcının yavaş veya yanıt vermeyen grafikler ya da takılan videolar yaşamamasını sağlar. - Kullanıcıyı reklama boğmayın.
- Uygulamanızda geçiş reklamlarının sıklığını artırmak, geliri artırmanın mükemmel bir yolu gibi görünse de kullanıcı deneyiminin kalitesini düşürebilir ve tıklama oranlarını düşürebilir. Kullanıcıların, uygulamanızın keyfini süremeyecekleri kadar sık kesinti yaşamadıklarından emin olun.
Ek kaynaklar
- HelloWorld örneği: Tüm reklam biçimlerinin minimum düzeyde uygulanması.