Banner reklamlar, uygulama düzeninin üst veya alt kısmında cihaz ekranına gidin. Kullanıcılar uygulamayla etkileşim kurarken banner reklam ekranda kalmaya devam eder ve belirli bir süre sonra otomatik olarak yenilenebilir. Bu konuda yeniyseniz mükemmel bir başlangıç noktasıdır. Örnek olay.
Ö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 banner'lar:
- Android:
ca-app-pub-3940256099942544/6300978111
- iOS:
ca-app-pub-3940256099942544/2934735716
Bu reklam birimi kimlikleri, 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 kimlikleri kullanabilirsiniz. Yalnızca bunu yapmadan önce kendi reklam birimi kimliğinizle değiştirdiğinizden emin olun. en iyi uygulamaları paylaşacağız.
Mobile Ads SDK'sının test reklamlarının işleyiş şekli hakkında daha fazla bilgi için Test Reklamları.
Uygulama
AdView
yapılandırın
Banner reklamlar AdView
nesne halinde görüntülenir. Dolayısıyla banner'a doğru ilk adım
banner reklam entegrasyonu, AdView
oluşturup konumlandırmaktır.
Aşağıdaki başlığı uygulamanızın C++ koduna ekleyin:
#include "firebase/gma/ad_view.h"
Bir
AdView
nesnesini tanımlama ve örneklendirme:firebase::gma::AdView* ad_view; ad_view = new firebase::gma::AdView();
Bir
AdSize
oluşturun veAdParent
üst görünümünü kullanarak reklam görünümünü başlatın. Üst görünüm, AndroidActivity
için bir JNIjobject
referansıdır. veya bir iOSUIView
işaretçisiAdParent
türünü yayınlar:// 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
result = ad_view->Initialize(ad_parent, kBannerAdUnit, firebase::gma::AdSize::kBanner); future değişkenini tutmak yerine,
AdView
nesnesindeInitializeLastResult()
çağrısını yaparak başlatma işleminin durumunu düzenli olarak kontrol edebilirsiniz. Bu, genel oyun döngüsünüzdeki başlatma sürecini takip etmek için yararlı olabilir.// Monitor the status of the future in your game loop: firebase::Future<void> result = ad_view->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ın konumunu ayarlayın
Başlatıldıktan sonra AdView
öğesinin konumunu istediğiniz zaman ayarlayabilirsiniz:
firebase::Future<void> result = ad_view->SetPosition(firebase::gma::AdView::kPositionTop);
Reklam yükle
AdView
başlatıldıktan sonra reklamı yükleyebilirsiniz:
firebase::gma::AdRequest ad_request;
firebase::Future<firebase::gma::AdResult> load_ad_result = ad_view->LoadAd(my_ad_request);
AdRequest
nesneleri, tek bir reklam isteğini temsil eder ve
hedefleme gibi bilgiler vardır.
Reklamı gösterme
Son olarak, Show()
işlevini çağırarak reklamı ekranda gösterin. Bu yöntem
çağrılır:
firebase::Future<void> result = ad_view->Show();
Reklam etkinlikleri
Google Mobile Ads C++ SDK'sı, genişletebileceğiniz bir AdListener
sınıfı sağlar.
ve reklamda yapılan değişikliklerle ilgili bildirim almak için AdView::SetListener()
adresine iletir
görünümünün durumu.
AdListener
işlevindeki yöntemlerin genişletilmesi isteğe bağlıdır. Bu nedenle, yalnızca
yöntemleri ekleyin. Aşağıda,
AdListener
yöntemler sınıfının:
class ExampleAdListener : public firebase::gma::AdListener { public: ExampleAdListener() {} void OnAdClicked() override { // This method is invoked when the user clicks the ad. } void OnAdClosed() override { // This method is invoked when the user closes the ad. } void OnAdImpression() override { // This method is invoked when an impression is recorded for an ad. } void OnAdOpened() override { // This method is invoked when an ad opens an overlay that covers the screen. } }; ExampleAdListener* ad_listener = new ExampleAdListener(); ad_view->SetAdListener(ad_listener);
Banner boyutları
Aşağıdaki tabloda standart banner boyutları listelenmiştir.
Nokta cinsinden boyut (GxY) | Açıklama | Kullanılabilirlik | firebase::gma::AdSize sabiti |
---|---|---|---|
320x50 | Banner | Telefonlar ve Tabletler | kBanner |
320x100 | Büyük Banner | Telefonlar ve Tabletler | kLargeBanner |
300x250 | IAB Orta Boy Dikdörtgen | Telefonlar ve Tabletler | kMediumRectangle |
468x60 | IAB Tam Boyutlu Banner | Tabletler | kFullBanner |
728x90 | IAB Liderler Tablosu | Tabletler | kLeaderboard |
Sağlanan genişlik x Uyarlanabilir yükseklik | Uyarlanabilir banner | Telefonlar ve Tabletler | Yok |
Özel reklam boyutları
Özel bir banner boyutu tanımlamak için istediğiniz boyutları
firebase::gma::AdSize
oluşturucuyu (burada gösterildiği gibi) genişlik ve yükseklik parametrelerini kullanır:
firebase::gma::AdSize ad_size(/*width=*/320, /*height=*/50);
Ek kaynaklar
GitHub'da örnek
- Şu belgenin kaynak kodunu görüntüleyin: örnek hızlı başlangıç uygulaması bölümüne gidin.