Banner Reklamlar

Banner reklamlar, uygulama düzeninin üst veya alt kısmında cihaz ekranına gidin. Kullanıcılar uygulamayla etkileşimde bulunurken ekranda kalırlar. 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

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 biri için test reklamları döndürecek şekilde özel olarak ve isterseniz kod yazma, test etme ve tamamlama aşamalarında bunu kendi uygulamalarınızda hata ayıklama. 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.

  1. Aşağıdaki başlığı uygulamanızın C++ koduna ekleyin:

     #include "firebase/gma/ad_view.h"

  2. Bir AdView nesnesini tanımlama ve örneklendirme:

      firebase::gma::AdView* ad_view;
  ad_view = new firebase::gma::AdView();

  3. Bir AdSize oluşturun ve AdParent üst öğesini kullanarak reklam görünümünü başlatın görünüm. Üst görünüm, Android Activity için bir JNI jobject referansıdır. veya bir iOS UIView işaretçisi AdParent 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(my_ad_parent);
 firebase::Future result =
   ad_view->Initialize(ad_parent, kBannerAdUnit, firebase::gma::AdSize::kBanner);

  4. Değişken olarak geleceği korumaya alternatif olarak, öğesini çağırarak başlatma işleminin durumunu düzenli olarak kontrol edin. AdView nesnesinde InitializeLastResult(). Bu işlem aşağıdakiler için faydalı olabilir: ilk kullanıma hazırlama sürecini takip etmelisiniz.

      // 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.
  }

  5. 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örüntüleme

Son olarak, Show() yöntemini çağırarak reklamı ekranda görüntüleyin. 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);

Aşağıdaki tabloda standart banner boyutları listelenmiştir.

Puan 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 Skor 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şturucusu (burada gösterildiği gibi genişlik ve yükseklik parametrelerine sahiptir):

firebase::gma::AdSize ad_size(/*width=*/320, /*height=*/50);

Ek kaynaklar

GitHub'da örnek

Başarı öyküleri