Bu sayfa, Cloud Translation API ile çevrilmiştir.

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ı. Genellikle doğal geçiş noktalarında gösterilir. Örneğin, etkinlikler arasında veya aradaki duraklama sırasında ne kadar önemli olduğu. 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, 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

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

Aşağıdaki başlığı uygulamanızın C++ koduna 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ü kullanarak InterstitialAd örneğini başlatın AdParent türü. Üst görünüm, bir Android için JNI jobject referansıdır Activity veya bir iOS UIView 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 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ükle

Bir reklamın yüklenmesi işlemi,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

Almak için FullScreenContentListener sınıfını uzatmanız gerekir geçiş reklamı sunumu ve yaşam döngüsü olaylarıyla ilgili bildirimler sağlar. Ö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 bir defada reklam gösterilirse tekrar gösterilemez. En iyi uygulama olarak başka bir web sitesi geçiş reklamı ekleyebilirsiniz.OnAdDismissedFullScreenContent() 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 alamaması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ı

Geçiş reklamı en iyi uygulamaları

Başarı öyküleri

Örnek kullanım alanı

Sonraki adımlar

Henüz yapmadıysanız AdMob kullanıcı arayüzü.
Reklam hedefleme ve geçiş reklamı yönergelerine uyun.