Geçiş reklamları, bir uygulamanın arayüzünü kaplayana kadar görünen tam ekran reklamlardır. kullanıcı tarafından kapatıldı. Genellikle doğal geçiş noktalarında gösterilir. Örneğin, etkinlikler arasında veya aradaki duraklama sırasında bir oyunda hangi seviyelerde. Uygulamada geçiş reklamı gösterildiğinde seçim kullanıcıya sahiptir reklama dokunup hedefine devam etmesini veya reklamı kapatıp geri dönmesini uygulamaya geri dönelim. Örnek olay.
Bu kılavuzda, Google Mobile Ads C++ SDK'sı kullanılarak geçiş reklamlarının Android ve iOS uygulamalarına nasıl entegre edileceği gösterilmektedir.
Ön koşullar
- Başlayın bölümünü tamamlayın.
- (Yalnızca Android) JNI
jobject
referanslarıyla çalışma hakkında bilgi (bkz. Android JNI ipuçları).
Her zaman test reklamlarıyla test etme
Uygulamalarınızı oluştururken ve test ederken, uygulamalarınızın yanı sıra üretim reklamlarıdır. Aksi takdirde hesabınız askıya alınabilir.
Test reklamlarını yüklemenin en kolay yolu, aşağıdakiler için özel test reklam birimi kimliğimizi kullanmaktır: cihaz platformuna göre değişen geçiş reklamları:
- Android:
ca-app-pub-3940256099942544/1033173712
- iOS:
ca-app-pub-3940256099942544/4411468910
Bu reklamlar, her istek için test reklamı döndürecek şekilde özel olarak yapılandırılmıştır ve kod yazma, test etme ve hata ayıklama sırasında kendi uygulamalarınızda kullanabilirsiniz. Ancak, reklam biriminizi yayınlamadan önce bunu kendi reklam birimi kimliğinizle değiştirdiğinizden emin olun. uygulamasını indirin.
Mobile Ads SDK'sının test reklamlarının işleyiş şekli hakkında daha fazla bilgi için Test Reklamları.
Uygulama
Geçiş reklamlarını entegre etmek için başlıca adımlar şunlardır:
- Bir reklam yükleyin.
- Geri çağırma işlevleri için kaydolun.
- Reklamı görüntüleyin ve yaşam döngüsü olaylarını yönetin.
InterstitialAd
yapılandırın
Geçiş reklamları InterstitialAd
nesne halinde görüntülenir. Bu nedenle ilk adım
uygulamanıza geçiş reklamlarını entegre etmek için, bir
InterstitialAd
nesne algılandı.
Uygulamanızın C++ koduna aşağıdaki üstbilgeyi ekleyin:
#include "firebase/gma/interstial_ad.h"
Bir
InterstitialAd
nesnesini tanımlama ve örneklendirme:firebase::gma::InterstitialAd* interstitial_ad; interstitial_ad = new firebase::gma::InterstitialAd();
Üst görünümünüzü bir
AdParent
türüne yayınlayarakInterstitialAd
örneğini başlatın. Üst görünüm, bir Android için JNIjobject
referansıdırActivity
veya bir iOSUIView
işaretçisi.// my_ad_parent is a jobject reference to an Android Activity or // a pointer to an iOS UIView. firebase::gma::AdParent ad_parent = static_cast<firebase::gma::AdParent>(my_ad_parent); firebase::Future<void> result = interstitial_ad->Initialize(ad_parent);
Geleceği bir değişken olarak tutmaya alternatif olarak,
InterstitialAd
nesnesindeInitializeLastResult()
çağrısını yaparak başlatma işleminin durumunu düzenli olarak kontrol edebilirsiniz. Faydalı olabilir ilk kullanıma hazırlama sürecini takip etmek için kullanabilirsiniz.// Monitor the status of the future in your game loop: firebase::Future<void> result = interstitial_ad->InitializeLastResult(); if (result.status() == firebase::kFutureStatusComplete) { // Initialization completed. if(future.error() == firebase::gma::kAdErrorCodeNone) { // Initialization successful. } else { // An error has occurred. } } else { // Initialization on-going. }
firebase::Future
ile çalışma hakkında daha fazla bilgi için bkz.
Metodun tamamlanma durumunu izlemek için Vadeli İşlemleri kullanın
aramaları için de kullanılabilir.
Reklam yükle
Reklamın yüklenmesi, LoadAd()
InterstitialAd
nesne algılandı. Yükleme yöntemi, InterstitialAd
nesnesini başlatmanızı, reklam birimi kimliğinizin ve bir AdRequest
nesnenizin olmasını gerektirir. Durumu izlemek için kullanabileceğiniz bir firebase::Future
döndürülür
ve yükleme işleminin sonucudur.
Aşağıdaki kod, InterstitialAd
yüklendikten sonra reklamın nasıl yükleneceğini gösterir
başarıyla başlatıldı:
firebase::gma::AdRequest ad_request;
firebase::Future<firebase::gma::AdResult> load_ad_result;
load_ad_result = interstitial_ad->LoadAd(interstitial_ad_unit_id, ad_request);
Geri çağırma işlevleri için kaydolun
Geçiş reklamı sunumu ve yaşam döngüsü etkinlikleriyle ilgili bildirim almak için FullScreenContentListener
sınıfını genişletmeniz gerekir. Özel FullScreenContentListener
alt sınıfınız InterstitialAd::SetFullScreenContentListener()
yöntemi aracılığıyla kaydedilebilir. Reklam başarıyla veya başarısız bir şekilde sunulduğunda ve kapatıldığında bu sınıfa geri çağırma çağrıları gönderilir.
Aşağıdaki kod, sınıfın nasıl genişletileceğini ve reklama nasıl atanacağını gösterir:
class ExampleFullScreenContentListener : public firebase::gma::FullScreenContentListener { public: ExampleFullScreenContentListener() {} void OnAdClicked() override { // This method is invoked when the user clicks the ad. } void OnAdDismissedFullScreenContent() override { // This method is invoked when the ad dismisses full screen content. } void OnAdFailedToShowFullScreenContent(const AdError& error) override { // This method is invoked when the ad failed to show full screen content. // Details about the error are contained within the AdError parameter. } void OnAdImpression() override { // This method is invoked when an impression is recorded for an ad. } void OnAdShowedFullScreenContent() override { // This method is invoked when the ad showed its full screen content. } }; ExampleFullScreenContentListener* full_screen_content_listener = new ExampleFullScreenContentListener(); interstitial_ad->SetFullScreenContentListener(full_screen_content_listener);
InterstitialAd
tek kullanımlık bir nesnedir. Yani, bir geçiş reklamının bir defada
reklam gösterilirse tekrar gösterilemez. En iyi uygulama olarak başka bir web sitesi
anahtar kelimenizin OnAdDismissedFullScreenContent()
yönteminde
Bir sonraki geçiş reklamının yüklenmeye başlaması için FullScreenContentListener
otomatik olarak eklenir.
Reklamı görüntüleme
Geçiş reklamları, bir uygulamanın akışındaki doğal duraklamalar sırasında görüntülenmelidir.
Bir oyunun seviyeleri arasında veya kullanıcının bir görevi tamamladıktan sonra geçmesi iyi bir örnektir.
FullScreenContentListener
, bir reklamın ne zaman
tam ekran içeriğini gösterdiğinde Show()
tarafından döndürülen içerik de
Reklam başarıyla gösterildiğinde.
firebase::Future<void> result = interstitial_ad->Show();
En iyi uygulamalar
- Geçiş reklamlarının uygulamanız için doğru reklam türü olup olmadığını düşünün.
- Geçiş reklamları, doğal geçiş noktalarına sahip uygulamalarda en iyi sonucu verir. İlgili içeriği oluşturmak için kullanılan Uygulama içinde bir görevin tamamlanması (ör. resim paylaşma veya oyun tamamlama) bir nokta oluşturur. Çünkü kullanıcı çalışmasını kesintiye uğratmadan bir geçiş reklamı sunmaktır. Uygulamanızın iş akışının hangi noktalarında dönüşüm gerçekleştireceğinizi Görüntülü geçiş reklamlarını ve kullanıcının nasıl yanıt verebileceğini gösterir.
- Bir geçiş reklamı görüntülerken işlemi duraklatmayı unutmayın.
- Birkaç farklı geçiş reklamı türü vardır: metin, resim,
video ve daha fazlası. Uygulamanızda bir
aynı zamanda reklamın kullanıcıya uygun şekilde yayınlanmasını sağlamak için bazı kaynakları
bunlardan yararlanabilirsiniz. Örneğin, bir
geçiş reklamında, uygulamanız tarafından üretilen tüm ses çıkışlarını duraklattığınızdan emin olun.
Sesleri çalmaya şu yöntemi kullanarak devam edebilirsiniz:
OnAdDismissedFullScreenContent
kullanıcı tarafından çağrılacak olan yüklüFullScreenContentListener
reklamla etkileşimi bitirdi. Ayrıca, içeriği geçici olarak reklam gösterilirken yapılan yoğun hesaplama görevleri (oyun döngüsü gibi) görüntülenir. Bu, kullanıcının yavaş veya kötü amaçlı yazılım deneyimi yanıt vermeyen grafikler veya titreyen videolar. - Yükleme süresi için yeterli süre tanıyın.
- Geçiş reklamlarını doğru zamanda bir sonraki aşamaya geçebilirseniz, kullanıcının bir an önce geri yükleyebilirsiniz. Reklamı göstermek istemediğinizden önce yüklemek, hazır olduğunda uygulamanızın tam olarak yüklenmiş bir geçiş reklamı biri gösteriliyor.
- Kullanıcıyı reklama boğmayın.
- Uygulamanızda geçiş reklamlarının sıklığını artırmak çok iyi bir yol gibi görünse de, kullanıcı deneyimini ve daha düşük tıklama oranları sağlar. Kullanıcıların sürekli olarak uygulamanızdan artık keyif alamamalarına neden olan durumlarla karşılaşabilirsiniz.
- Geçiş reklamını göstermek için "yükleme tamamlama" gelecekteki halini kullanmayın.
- Bu durum, kötü bir kullanıcı deneyimine yol açabilir. Bunun yerine, reklamı yüklemeden önce göstermeniz gerekir.
Ek kaynaklar
GitHub'da örnek
- Örneğimizin kaynak kodunu görüntüleyin hızlı başlangıç uygulaması bölümüne gidin.
Mobile Ads Garage eğitim videoları
Başarı öyküleri
Sonraki adımlar
- Henüz yapmadıysanız AdMob kullanıcı arayüzü.
- Reklam hedefleme ve geçiş reklamı yönergelerine uyun.