Yeni Google Mobile Ads C++ SDK'sına geçin

Firebase C++ SDK'sının 9.1.0 sürümünün yayınlanmasıyla yeni bir Google Mobile Ads C++ SDK'sı kullanıma sunuluyor.

Google Mobile Ads C++ SDK, 2021 ve 2022'de iOS ve Android için Firebase AdMob C++ SDK'larında yapılan ve desteği sonlandırılan API'lerin kaldırılması ile tam ekran reklam türleriyle çalışırken yeni bir akış gibi önemli değişiklikleri içeren yeni bir API yüzeyidir.

Eski Firebase AdMob C++ SDK'sı (firebase::admob) kullanımdan kaldırıldı ve artık güncelleme veya hata düzeltmesi almayacak.

Hem yeni Google Mobil Reklamlar C++ SDK'sı (firebase::gma) hem de eski Firebase AdMob C++ SDK'sı (firebase::admob), Firebase AdMob C++ SDK desteğinin sonlandırılacağı dönemde Firebase C++ SDK'sının derleme arşivlerinde yer almaya devam edecek.

Eski API'lerin kaldırılması

Aşağıdaki API'ler, Google Mobile Ads C++ SDK'sından tamamen kaldırıldı.

RewardedVideoAd

AdMob'un RewardedVideoAd ad alanı, RewardedAd sınıfıyla değiştirildi. RewardedAd, InterstitialAd ile benzer şekilde çalışır ancak öğe ödülleriyle ilgili bildirim almak için ek bir RewardedAdListener içerir.

NativeExpressAds

AdMob'un NativeExpressAd, her Firebase AdMob C++ SDK'sında kullanımdan kaldırılmış olarak işaretlenmişti. Bu nedenle NativeExpressAd, yeni Google Mobile Ads C++ SDK'sına dahil edilmemiştir.

SDK ad alanı değişikliği

SDK yeni bir ad alanına taşındı ve yeni bir dizin yapısına sahip:

Ad alanı firebase::gma

Yeni Google Mobile Ads C++ SDK'sının kaynakları firebase::gma ad alanındadır. Eski firebase::admob ad alanı, Firebase AdMob C++ SDK'sı ile birlikte kullanımdan kaldırıldı.

Dizin yapısı

Başlık dosyaları, derleme arşivinin içindeki yeni bir dizine taşındı:

Kitaplık

Firebase AdMob C++ SDK'sı, Firebase C++ SDK derleme arşivinde statik kitaplık olarak sağlanır:

Sınıf, enum ve yapı taşıma işlemleri

Aşağıdaki tabloda, değiştirilen veya kaldırılan belirli sınıflar, numaralandırmalar ve yapılar listelenmektedir. Özet:

• BannerView, AdView olarak yeniden adlandırıldı.
• NativeAdExpressView kaldırılır.
• RewardedVideo ad alanı, RewardedAd sınıfıyla değiştirilir.
• PresentationState numaralandırması ve işleyicileri kaldırılıp AdListener ve FullScreenContent işleyicileriyle değiştirildi.

• Aşağıdaki parametreler, AdRequests'daki reklam başına yapılandırma parametreleri olarak kaldırılır:

  • Test cihazı kimliklerinin yapılandırılması
  • reklamların yaşa göre hedeflenmesi

  Bunun yerine, bu parametreler artık RequestConfiguration bölümünde yapılandırılabilir. Bu bölüm, sonraki tüm reklam yüklemelerini etkileyecek genel bir ayardır.

SDK başlatma

Her Google Mobile Ads C++ SDK'sı başlatma işlevi hemen iki durum göstergesi döndürür:

• İsteğe bağlı bir out parametresi, başlatma işlemi başlamadan önce bir bağımlılık hatası oluşup oluşmadığını belirtir.

• Dönüş parametresi, firebase::Future öğesine yapılan bir referanstır. Future, cihazdaki arabuluculuk bağdaştırıcılarının eşzamansız başlatılmasının sonuçlarını içerir.

Google Mobile Ads C++ SDK'sı, ilk kullanıma hazırlama işlevi döndürülür döndürülmez AdMob tarafından sunulan reklamları yüklemek için çağrılabilirken diğer reklam ağları, ilgili uyumlulaştırma bağdaştırıcısı tamamen ilk kullanıma hazırlanana kadar reklam yayınlamaz. Bu işlem eşzamansız olarak gerçekleşir. Bu nedenle, uygulamanızda reklam aracılığı kullanıyorsanız herhangi bir reklam yüklemeyi denemeden önce Future sorununun çözülmesini beklemenizi öneririz.

Önce

firebase::App* app = ::firebase::App::Create();
firebase::InitResult result = firebase::admob::Initialize(*app, kAdMobAppID);

if (result != kInitResultSuccess) {
  // Initialization immediately failed, most likely due to a missing dependency.
  // Check the device logs for more information.
  return;
}

Sonra

using firebase::App;
using firebase::Future;
using firebase::gma::AdapterInitializationStatus;

App* app = ::firebase::App::Create();
firebase::InitResult result;
Future<AdapterInitializationStatus> future =
  firebase::gma::Initialize(*app, &result);

if (result != kInitResultSuccess) {
  // Initialization immediately failed, most likely due to a missing dependency.
  // Check the device logs for more information.
  return;
}

// Poll the future to wait for its completion either in this
// thread, or as part of your game loop by calling
// firebase::gma::InitializeLastResult();
while (future.status() == firebase::kFutureStatusPending) {
  // Initialization on-going, continue to wait.
}

// future.status() is either kFutureStatusComplete or there’s an error

if (future.status() == firebase::kFutureStatusComplete &&
     future.error() == firebase::gma::AdErrorCodeNone) {
  AdapterInitializationStatus* status = future.result();
  // Check status for any mediation adapters you wish to use.
  // ..
} else {
  // Handle initialization error.
}

AdView içinde AdSize ile ilgili değişiklikler

AdSize artık yaygın banner reklam boyutlarının statik üyelerini içeriyor ve AnchorAdaptive ile InlineAdaptive reklam boyutlarını destekliyor. Bu reklam boyutları, verilen genişliğe ve ekranın mevcut yönüne göre dinamik bir yüksekliğe sahip.

Önce

firebase::admob::BannerView* banner_view = new firebase::admob::BannerView();

firebase::admob::AdSize ad_size;
ad_size.ad_size_type = firebase::admob::kAdSizeStandard;
ad_size.width = 320;
ad_size.height = 50;

// ad_parent is a reference to an iOS UIView or an Android Activity.
// banner_ad_unit is your ad unit id for banner ads.
banner_view->Initialize(ad_parent, banner_ad_unit, ad_size);

Sonra

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

// ad_parent is a reference to an iOS UIView or an Android Activity.
// banner_ad_unit is your ad unit id for banner ads.
banner_view->Initialize(ad_parent, banner_ad_unit, firebase::gma::AdSize.kBanner);

AdRequest ve genel yapılandırma

Test cihazı kimlikleri, TagForChildDirectedTreatment ve TagForUnderAgeOfConsent (daha önce doğum tarihiyle işleniyordu) AdRequest'den kaldırıldı ve artık genel bir RequestConfiguration'nin parçası. Uygulamalar, bu değerleri yapılandırmak için uygulamanın yaşam döngüsünün başlarında firebase::gma::SetRequestConfiguration() çağırabilir. Bu ayarlar yapılandırıldıktan sonra, sonraki tüm reklam yükleme işlemlerinde geçerli olur.

firebase::gma::AdRequest, anahtar kelimeler ve isteğe bağlı bir içerik URL'si de dahil olmak üzere reklamların yüklenmesi için bağlamsal bilgiler sağladığından hâlâ mevcuttur.

AdMob'un AdRequest C tarzı yapısı, çeşitli bilgi listelerini tanımlarken ve bunlara ekleme yaparken daha iyi bir kullanıcı deneyimi sağlayan yöntemlere sahip bir sınıfla değiştirildi.

Önemli AdRequest değişiklikler:

• Ekstralar artık bir arabuluculuk bağdaştırıcısı sınıfı adıyla ilişkilendiriliyor. AdMob hizmetine gönderilen ekstralar, aşağıda tanımlandığı gibi varsayılan sınıf adını kullanmalıdır.
• Uygulamalar, reklam isteğinde bulunurken sundukları içeriğin URL'sini iletebilir. Bu, anahtar kelime hedeflemenin reklamı gösterilen diğer içeriklerle eşleştirmesini sağlar.

Önce

firebase::admob::AdRequest request;

// Keywords to be used in targeting.
const char* keywords[] = {"GMA", "C++", "Fun"};
request.keyword_count = sizeof(keywords) / sizeof(keywords[0]);
request.keywords = keywords;

// "Extra" key value pairs.
static const firebase::admob::KeyValuePair extras[] = {
      {"extra_name", "extra_value"}};
request.extras_count = sizeof(extras) / sizeof(extras[0]);
request.extras = kRequestExtras;

// Devices that should be served test ads.
const char* test_device_ids[] ={ "123", "4567", "890" };
request.test_device_id_count =
      sizeof(test_device_ids) / sizeof(test_device_ids[0]);
request.test_device_ids = test_device_ids;

// Sample birthday to help determine the age of the user.
request.birthday_day = 10;
request.birthday_month = 11;
request.birthday_year = 1975;

// Load Ad with the AdRequest.

Sonra

// Do once after Google Mobile Ads C++ SDK initialization.
// These settings will affect all Ad Load operations.
firebase::gma::RequestConfiguration configuration;
configuration.max_ad_content_rating =
      firebase::gma::RequestConfiguration::kMaxAdContentRatingPG;
configuration.tag_for_child_directed_treatment =
      firebase::gma::RequestConfiguration::kChildDirectedTreatmentTrue;
configuration.tag_for_under_age_of_consent =
      firebase::gma::RequestConfiguration::kUnderAgeOfConsentFalse;
configuration.test_device_ids.push_back("1234");
configuration.test_device_ids.push_back("4567");
configuration.test_device_ids.push_back("890");
firebase::gma::SetRequestConfiguration(configuration);

// Then, more information must be provided via an AdRequest when
// loading individual ads.
firebase::gma::AdRequest ad_request;

// "Extra" key value pairs.
ad_request.add_keyword("GMA");
ad_request.add_keyword("C++");
ad_request.add_keyword("Fun");

// Content URL.
ad_request.set_content_url("www.example.com");

// Mediation Adapter Extras.
#if defined(Android)
const char* ad_network_extras_class_name =
    "com/google/ads/mediation/admob/AdMobAdapter";
#else  // iOS
const char* ad_network_extras_class_name = "GADExtras";
#endif

ad_request.add_extra(ad_network_extras_class_name, "extra_name", "extra_value");

// Load Ad with the AdRequest. See next section.

AdResults

LoadAd artık tüm AdView, InterstitialAd ve RewardedAd reklam türleri için AdResult nesnesi içeren bir Future döndürüyor. AdResult::is_successful yöntemi, reklam isteği başarıyla karşılandıysa true, karşılanmadıysa false değerini döndürür.

Başarısızlık durumunda AdResult, hata kodu, hata mesajı ve alan dizeleri de dahil olmak üzere sorunla ilgili hizmet düzeyinde bilgileri içeren bir AdError nesnesi içerir.

Önce

firebase::Future<AdResult> future;

void load_ad() {
  // Assume an already created AdRequest object.
  future = ad_view->LoadAd(ad_request);
}

void your_game_loop() {
  if (future.status() == firebase::kFutureStatusComplete) {
    if(future.error() != firebase::admob::kAdMobErrorNone) {
      // There was either an internal SDK issue that caused the Future to
      // fail its completion, or AdMob failed to fulfill the ad request.
      // Details are unknown other than the Future’s error code returned
      // from future.error().
    } else {
      // The ad loaded successfully.
    }
  }
}

Sonra

firebase::Future<AdResult> future;

void load_ad() {
  // Assumes a previously created AdRequest object.
  // See "AdRequest and Global Configuration" above.
  future = ad_view->LoadAd(ad_request);
}

void your_game_loop() {
  // Check the future status in your game loop:
  if (future.status() == firebase::kFutureStatusComplete) {
    if(future.error() != firebase::admob::kAdErrorCodeNone) {
      // There was an internal SDK issue that caused the Future to fail.
    } else {
      // Future completed successfully.  Check the GMA result.
      const AdResult* ad_result = future.result();
      if ( ad_result->is_successful() != true ) {
        // GMA failed to serve an ad. Gather information about the error.
        const AdError& ad_error = ad_result->ad_error();
        AdErrorCode error_code = ad_error.code();
        const std::string error_domain = ad_error.domain();
        const std::string error_message = ad_error.message();
      } else {
        // The ad loaded successfully.
      }
    }
  }
}

AdView içindeki AdListener etkinlikleri

AdMob'un BannerView::Listener sınıfı, Google Mobile Ads C++ SDK'sında iki ayrı dinleyici sınıfıyla değiştirildi:

• AdListener, reklam yaşam döngüsü ve kullanıcı etkileşimi etkinliklerini izler.
• AdViewBoundingBoxListener, AdView yeniden boyutlandırıldığında veya taşındığında çağrılır.

AdMob OnPresentationStateChanged geri çağırma Google Mobile Ads eşlemeleri

firebase::admob::BannerView::PresentationState numaralandırılmış türü ve OnPresentationStateChanged dinleyici yöntemi, yeni Google Mobile Ads C++ SDK'sında yer almaz.

Aşağıda, AdView yaşam döngüsünde sunum durumu değişikliklerini algılamanın alternatif yolları verilmiştir:

RewardedAd artık bir sınıf

Desteği sonlandırılan Firebase AdMob C++ SDK'sı, firebase::admob::rewarded_ad ad alanındaki bir işlev koleksiyonu aracılığıyla ödüllü reklamları kolaylaştırıyordu. Bu işlevler, InterstitialAd ile benzer bir API yüzeyine sahip reklamlar yayınlayan yeni bir RewardedAd sınıfında birleştirildi (sonraki bölüme bakın).

InterstitialAd ve RewardedAd dinleyicileri

Hem geçiş reklamları hem de ödüllü reklamlar tam ekran reklam olarak kabul edilir. Bu reklam türleri için reklam yaşam döngüsü etkinliklerini dinlemek üzere yeni bir FullScreenContentListener yüklenebilir ve AdMob hizmeti, ücretli bir etkinliğin gerçekleştiğini düşündüğünde bunu izlemek için ayrı bir PaidEventListener yüklenebilir.

RewardedAd, kullanıcı tarafından kazanılan ödül etkinliklerini izlemek için ek bir dinleyiciye sahiptir.

Yeni tam ekran reklam geri çağırma yöntemleri

Yöntemler değiştirildi/kaldırıldı/değiştirildi

Aşağıdaki tabloda, yeni Google Mobile Ads C++ SDK'sında değiştirilen belirli yöntemler listelenmiştir. Parametreleri listelenen yöntemler kalır ancak imzaları değişir.