Geri bildiriminizi paylaşın ve Google Mobile Ads SDK'sı yol haritasının şekillendirilmesine yardımcı olun. 5 Mayıs 2023'te sona ermeden önce 2023 Google Mobile Ads SDK'sı Yıllık Anketi'ne katılın.

Banner Reklamlar

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Banner reklamlar, cihaz ekranının üst veya alt kısmında, uygulama düzeninin bir parçasını kullanır. Kullanıcılar uygulamayla etkileşimde bulunurken ekranda kalırlar ve belirli bir süre sonra otomatik olarak yenilenebilirler. Mobil reklamcılığa yeni başladıysanız başlangıç için mükemmel bir seçenektir. Başarılı örnek.

Ön koşullar

Her zaman test reklamlarıyla test edin

Uygulamalarınızı oluştururken ve test ederken yayında olan ü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 değişiklik gösterir:

  • Android: ca-app-pub-3940256099942544/6300978111
  • iOS: ca-app-pub-3940256099942544/2934735716

Bu reklam birimi kimlikleri özel olarak her istek için test reklamları döndürecek şekilde yapılandırılmıştır. Kodlama, test etme ve hata ayıklama işlemleri sırasında bu kimliği kendi uygulamalarınızda kullanabilirsiniz. Uygulamanızı yayınlamadan önce kendi reklam birimi kimliğinizle değiştirmeniz yeterlidir.

Mobile Ads SDK'sının test reklamlarının işleyiş şekli hakkında daha fazla bilgi edinmek için Test Reklamları bölümüne bakın.

Uygulama

AdView yapılandırın

Banner reklamlar AdView nesnede görüntülenir. Dolayısıyla, 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 nesnesi bildirin ve örnek oluşturun:

      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 kullanılan bir JNI jobject referansı veya AdParent UIView özelliğine sahip 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(my_ad_parent);
 firebase::Future result =
   ad_view->Initialize(ad_parent, kBannerAdUnit, firebase::gma::AdSize::kBanner);

  4. Değişken olarak geleceği saklamaya alternatif olarak, AdView nesnesine InitializeLastResult() işlevi başlatarak başlatma işleminin durumunu düzenli olarak kontrol edebilirsiniz. Bu, global 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 İşlemler'i kullanma konusuna bakın.

Reklamın konumunu ayarlayın

Başlatıldıktan sonra AdView konumunu istediğiniz zaman ayarlayabilirsiniz:

firebase::Future<void> result = ad_view->SetPosition(firebase::gma::AdView::kPositionTop);

Reklam yükleme

AdView başlatıldıktan sonra bir 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üle

Son olarak, Show() numaralı telefonu arayarak reklamı ekranda gösterin. Bu yöntem, reklam başlatıldıktan sonra herhangi bir zamanda başlatı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 genişletebileceğiniz ve AdView::SetListener() özelliğine iletebileceğiniz bir AdListener sınıfı sağlar.

AdListener içinde yöntemlerin genişletilmesi isteğe bağlıdır. Bu yüzden, yalnızca istediğiniz yöntemleri uygulamanız gerekir. Aşağıda, AdListener yöntem sınıfının tamamını genişleten bir sınıf uygulaması örneği verilmiştir:

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.

Nokta cinsinden boyut (GxY) Açıklama Kullanılabilirlik firebase::gma::AdSize sabit
320x50 Banner Telefonlar ve Tabletler kBanner
320x100 Büyük Banner Telefonlar ve Tabletler kLargeBanner
300x250 IAB Orta 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, firebase::gma::AdSize oluşturucuyu genişlik ve yükseklik parametreleriyle aşağıda gösterildiği gibi oluşturun:

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

Ek kaynaklar

GitHub'da örnek

Başarı öyküleri