Geçiş reklamları


Geçiş reklamları, bir uygulamanın arayüzünü kaplayana kadar görünen tam ekran reklamlardır. kullanıcı tarafından kapatıldı. Bunlar genellikle uygulamaların akışındaki doğal geçiş noktalarında görüntülenir (ör. işlemler arasında veya oyun seviyeleri arasındaki duraklatmalar sırasında). Bir uygulama geçiş reklamı gösterdiğinde kullanıcı, reklama dokunup hedefe devam etme veya reklamı kapatıp uygulamaya dönme seçeneğiyle karşı karşıya kalır. Kasus çalışması.

Bu kılavuzda, geçiş reklamlarının Android ve iOS uygulamalarına nasıl entegre edileceği gösterilmektedir Google Mobile Ads C++ SDK'sı kullanılıyor.

Ön koşullar

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 reklamları döndürecek şekilde özel olarak yapılandırılmıştır. Kodlama, test etme ve hata ayıklama sırasında kendi uygulamalarınızda bu reklamları 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:

  1. Reklam yükleyin.
  2. Geri çağırma işlevleri için kaydolun.
  3. Reklamı gösterin ve yaşam döngüsü etkinliklerini 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ı.

  1. Uygulamanızın C++ koduna aşağıdaki üstbilgeyi ekleyin: 

     #include "firebase/gma/interstial_ad.h"

  2. Bir InterstitialAd nesnesi tanımlayıp örneklendirin: 

     firebase::gma::InterstitialAd* interstitial_ad;
 interstitial_ad = new firebase::gma::InterstitialAd();

  3. Üst görünümünüzü kullanarak InterstitialAd örneğini başlatın AdParent türü. Üst görünüm, Android Activity için bir JNI jobject referansı veya iOS UIView için bir işaretçidir.

    // 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);

  4. Geleceği değişken olarak tutmak yerine, belirli aralıklarla şunu çağırarak başlatma işleminin durumunu kontrol edin: InterstitialAd nesnesinde InitializeLastResult(). 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ükleme

Reklamın yüklenmesi, LoadAd() InterstitialAd nesne algılandı. Yükleme yöntemi, InterstitialAd nesnesi bulunmalıdır ve reklam birimi kimliğiniz ile bir AdRequest nesnesini tanımlayın. 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, InterstitialAd::SetFullScreenContentListener() yöntemini içeren bir e-posta alırsınız ve reklam başarılı veya başarısız bir şekilde sunulduğunda ve aynı zamanda kapatıldı.

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 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ı, uygulamanın akışındaki doğal duraklamalar sırasında gösterilmelidir. Örneğin, bir oyunun seviyeleri arasında veya kullanıcı bir görevi tamamladıktan sonra gösterilebilir. 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. Kullanıcı, aksiyonda bir ara verme bekler. Bu nedenle, deneyimini kesintiye uğratmadan geçiş reklamı göstermek kolaydır. Geçiş reklamlarını uygulamanızın iş akışında hangi noktalarda göstereceğinizi ve kullanıcının nasıl yanıt verebileceğini göz önünde bulundurun.
Geçiş reklamı gösterirken işlemi duraklatmayı unutmayın.
Birkaç farklı geçiş reklamı türü vardır: metin, resim, video ve daha fazlası. Uygulamanız bir geçiş reklamı gösterdiğinde, reklamın bu kaynaklardan yararlanabilmesi için bazı kaynakların kullanımını da askıya alması önemlidir. Örneğin, geçiş reklamı gösterme çağrısı yaptığınızda uygulamanız tarafından üretilen tüm ses çıkışlarını duraklattığınızdan emin olun. Kullanıcı reklamla etkileşimi bitirdiğinde çağrılacak olan yüklü FullScreenContentListener'ınızın OnAdDismissedFullScreenContent yönteminde ses oynatmaya devam edebilirsiniz. Ayrıca, reklam gösterilirken yoğun hesaplama görevlerini (ör. oyun döngüsü) geçici olarak duraklatabilirsiniz. Bu, kullanıcının yavaş veya kötü uygulama deneyimi yaşamamasını yanıt vermeyen grafikler veya titreyen videolar.
Yeterli yükleme süresi tanıyın.
Geçiş reklamlarını uygun bir zamanda göstermenizin önemli olduğu kadar, kullanıcının reklamların yüklenmesini beklemek zorunda kalmaması da önemlidir. Reklamı göstermeden önce önceden yüklemek, uygulamanızda reklamı gösterme zamanı geldiğinde tamamen yüklenmiş bir geçiş reklamının hazır olmasını sağlayabilir.
Kullanıcıyı reklamlarla 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ı deneyimini olumsuz etkileyebilir ve tıklama oranlarını düşürebilir. Kullanıcıların uygulamanızı kullanmanın keyfini çıkaramayacak kadar sık kesintiye uğramamasını sağlayın.
Geçiş reklamını göstermek için yükleme tamamlanma gelecek işlevini kullanmayın.
Bu durum, kullanıcı deneyimini olumsuz yönde etkileyebilir. Bunun yerine, reklamı göstermeniz gerekmeden önce önceden yükleyin.

Ek kaynaklar

GitHub'daki örnek

Mobile Ads Garage eğitim videoları

Başarı öyküleri

Sonraki adımlar