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, 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ınAdParent
türü. Ü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 değişken olarak tutmak yerine, belirli aralıklarla şunu çağırarak başlatma işleminin durumunu kontrol edin:
InterstitialAd
nesnesindeInitializeLastResult()
. 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
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ı hakkında bildirimler alın. Ö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
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ı sahip olacaksınız. 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ü uygulama deneyimi yaşamamasını 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ı
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.