Banner Reklamlar

Banner reklamlar, uygulama düzeninde cihaz ekranının üst veya alt kısmında belirli bir alanı kaplar. Bu reklamlar, kullanıcılar uygulamayla etkileşimde bulunurken ekranda kalır ve belirli bir süre sonra otomatik olarak yenilenebilir. Mobil reklamcılıkta yeniyseniz bu reklamlar iyi bir başlangıç noktası olabilir. Örnek olay.

Ön koşullar

Her zaman test reklamlarıyla test etme

Uygulamalarınızı oluşturup test ederken canlı üretim reklamları yerine test reklamlarını kullandığınızdan emin olun. Aksi takdirde hesabınız askıya alınabilir.

Test reklamlarını yüklemenin en kolay yolu, banner'lar için özel test reklam birimi kimliğimizi kullanmaktır. Bu kimlik, cihaz platformuna göre farklılık gösterir:

  • 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 bu kimlikleri kendi uygulamalarınızda kullanabilirsiniz. Ancak, uygulamanızı yayınlamadan önce bunu kendi reklam birimi kimliğinizle değiştirdiğinizden emin olun.

Mobile Ads SDK'sının test reklamlarının işleyiş şekli hakkında daha fazla bilgi için Test Reklamları konusuna bakın.

Uygulama

AdView yapılandırın

Banner reklamlar AdView nesneleri halinde görüntülenir. Bu nedenle, banner reklamları entegre etmenin ilk adımı bir AdView oluşturmak ve 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 görünümünü kullanarak reklam görünümünü başlatın. Üst görünüm, Android Activity için bir JNI jobject referansı veya AdParent türüne yayınlanan bir iOS UIView işaretçisidir:

     // 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. Geleceği değişken olarak tutmaya alternatif olarak, AdView nesnesinde InitializeLastResult() çağrısı yaparak başlatma işleminin durumunu düzenli olarak kontrol edebilirsiniz. Bu, genel oyun döngünüzdeki ilk kullanıma hazırlama sürecini takip etmek açısından faydalı 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.
  }

  5. firebase::Future ile çalışma hakkında daha fazla bilgi için Yöntem çağrılarının tamamlanma durumunu izlemek için Vadeli İşlemleri Kullanma bölümüne bakın.

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 için özellikler içerir.

Reklamı görüntüleme

Son olarak, Show() yöntemini çağırarak reklamı ekranda görüntüleyin. Bu yöntem, reklam başlatıldıktan sonra herhangi bir zamanda çağrılabilir:

firebase::Future<void> result = ad_view->Show();

Reklam etkinlikleri

Google Mobile Ads C SDK'sı, reklam görünümünün durumundaki değişikliklerle ilgili bildirim almak için AdView::SetListener() uygulamasına genişletebileceğiniz ve iletebileceğiniz bir AdListener sınıfı sağlar.

AdListener ürününde yöntemlerin genişletilmesi isteğe bağlıdır. Bu nedenle, yalnızca istediğiniz yöntemleri uygulamanız gerekir. Aşağıda, tüm AdListener yöntemler sınıfını genişleten bir sınıfın örnek uygulaması yer almaktadır:

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 banner boyutu tanımlamak için, aşağıda gösterildiği gibi genişlik ve yükseklik parametreleriyle firebase::gma::AdSize oluşturucuyu kullanarak istediğiniz boyutları ayarlayın:

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

Ek kaynaklar

GitHub'da örnek

Başarı öyküleri