Başlarken

Bu kılavuz, C++ uygulamasından AdMob ile para kazanmak isteyen yayıncılar için Firebase'i kullanabilirsiniz. Uygulamanıza Firebase'i dahil etmeyi planlıyorsanız daha iyi olabilir. Daha fazla bilgi için AdMob Firebase sürümü rehberini incelemenizi öneririz.

Google Mobile Ads C++ SDK'sını uygulamaya entegre etmek, reklam göstermenin ve gelir elde etmenin ilk adımıdır. SDK'yı entegre ettikten sonra geçiş reklamı veya ödüllü reklam gibi bir reklam biçimi seçebilir ve ilgili biçimi uygulama adımlarını uygulayabilirsiniz.

Google Mobile Ads C++ SDK'sı, Google Mobile Ads iOS ve Android SDK'larını sarmalayan ve yalnızca bu platformlarda kullanılabilen bir SDK'dır. Google Mobile Ads C++ SDK'sı eşzamansız işlemleri desteklemek için Firebase C++ yapılarının kullanılması, firebase::gma ad alanında yer alır.

Bu kılavuzu ilk kez okuyorsanız Google Mobil Reklamlar C++ test uygulamasını indirip talimatları uygulamanızı öneririz.

Ön koşullar

AdMob hesabınızda uygulamanızı ayarlama

Aşağıdaki adımları tamamlayarak uygulamanızı bir AdMob uygulaması olarak kaydedin:

1. Oturum açın veya kaydolun kullandığınızdan emin olun.

2. Uygulamanızı AdMob'a kaydedin. Bu adım, bir AdMob benzersiz bir AdMob uygulama kimliğine sahip uygulama ele alacağız.

Google Mobile Ads C++ SDK'sını yükleme

Google Mobile Ads C++ SDK'sı firebase::gma ad alanında bulunduğundan Firebase C++ SDK'sını indirin ve ardından seçtiğiniz bir dizine açın.

Firebase C++ SDK'sı platforma özel değildir ancak platforma özgü kitaplık yapılandırmalarıdır.

Artık hazırsınız! C++ uygulamanız, başka Firebase hizmeti olmadan Google Mobil Reklamlar C++ SDK'sını kullanacak şekilde yapılandırılmış.

Uygulamanızın AdMob uygulama kimliğini yapılandırma

Google Mobile Ads SDK'sını ilk kullanıma hazırlayın

Reklamları yüklemeden önce uygulamanızın firebase::gma::Initialize() işlevini çağırarak Google Mobile Ads C++ SDK'sını ilk kullanıma hazırlamasını sağlayın. Bu işlev, SDK'yı ilk kullanıma hazırlar ve ilk kullanıma hazırlama işlemi tamamlandıktan sonra (veya 30 saniyelik zaman aşımının ardından) firebase::Future işlevini tamamlar. Bunun yalnızca bir kez yapılması gerekir. İdeal olarak uygulama lansmanında bu yapılır.

Reklamlar, Google Mobile Ads C++ SDK'sı veya uyumlulaştırma iş ortağı SDK'ları tarafından önceden yüklenebilir Initialize() arandığında. Google Ads'deki kullanıcılardan Avrupa Ekonomik Alanı (AEA) için farklı ayarları kabul ederek isteğe özel işaretleri (ör. tag_for_child_directed_treatment veya tag_for_under_age_of_consent) veya Aksi takdirde, reklamları yüklemeden önce Google Mobil'i başlatmadan önce firebase::gma::SetRequestConfiguration() Ads C++ SDK'sı. Daha fazla bilgi için Hedefleme kılavuzumuzu inceleyin.

Initialize() işlevinin nasıl çağrılacağıyla ilgili bir örnek aşağıda verilmiştir:

// Initialize the Google Mobile Ads library
firebase::InitResult result;
Future<AdapterInitializationStatus> future =
  firebase::gma::Initialize(jni_env, j_activity, &result);

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

// Monitor the status of the future.
// See "Use a Future to monitor the completion status of a method call" below.
if (future.status() == firebase::kFutureStatusComplete &&
    future.error() == firebase::gma::kAdErrorCodeNone) {
  // Initialization completed.
} else {
  // Initialization on-going, or an error has occurred.
}

// Initialize the Google Mobile Ads library.
firebase::InitResult result;
Future<AdapterInitializationStatus> future =
  firebase::gma::Initialize(&result);

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

// Monitor the status of the future.
// See "Use a Future to monitor the completion status of a method call" below.
if (future.status() == firebase::kFutureStatusComplete &&
    future.error() == firebase::gma::kAdErrorCodeNone) {
  // Initialization completed.
} else {
  // Initialization on-going, or an error has occurred.
}

Bir yöntem çağrısının tamamlanma durumunu izlemek için Future kullanın

Future, asenkron yöntem çağrılarınızın tamamlanma durumunu belirlemenize olanak tanır.

Örneğin, uygulamanız firebase::gma::Initialize() çağırdığında, yeni bir firebase::Future oluşturuldu ve döndürüldü. Ardından uygulamanız, ilklendirmenin ne zaman tamamlandığını belirlemek için Future'ın status() özelliğini sorgulayabilir. İşlem tamamlandığında uygulamanız, result() çağrısı yaparak AdapterInitializationStatus sonucunu alabilir.

Future değeri döndüren yöntemlere karşılık gelen bir "son sonuç" bulunur. bir yöntem olan uygulamaların, belirli bir işlem için en son Future bilgisini almak için kullanabileceği anlamına gelir. Örneğin, Örneğin, firebase::gma::Initialize(), firebase::gma::InitializeLastResult(), uygulamanızın sunduğu Future değerini döndürür işlevini kullanarak firebase::gma::Initialize() için yapılan son çağrının durumunu kontrol edebilirsiniz.

Future durumu tamamlandıysa ve hata kodu firebase::gma::kAdErrorCodeNone, işlem tamamlandı bahsettik.

Ayrıca, bir Future tamamlandığında çağrılacak geri çağırmaları da kaydedebilirsiniz. Bazı durumlarda geri çağırma işlevi farklı bir iş parçacığında çalışır. Bu nedenle, kodunuzun iş parçacığı açısından güvenli olduğundan emin olun. Bu kod snippet'i, geri arama:

// Registers the OnCompletion callback. user_data is a pointer that is passed verbatim
// to the callback as a void*. This allows you to pass any custom data to the callback
// handler. In this case, the app has no data, so you must pass nullptr.
firebase::gma::InitializeLastResult().OnCompletion(OnCompletionCallback,
  /*user_data=*/nullptr);

// The OnCompletion callback function.
static void OnCompletionCallback(
  const firebase::Future<AdapterInitializationStatus>& future, void* user_data) {
  // Called when the Future is completed for the last call to firebase::gma::Initialize().
  // If the error code is firebase::gma::kAdErrorCodeNone,
  // then the SDK has been successfully initialized.
  if (future.error() == firebase::gma::kAdErrorCodeNone) {
    // success!
  } else {
    // failure.
  }
}

Reklam biçimi seçin

Google Mobile Ads C++ SDK'sı içe aktarıldı. Artık reklam uygulamaya hazırsınız. AdMob, uygulamanızın kullanıcı deneyimine en uygun olanı seçebilmeniz için çeşitli reklam biçimleri sunar.

Banner

Cihaz ekranının üst veya alt kısmında görünen dikdörtgen reklamlardır. Banner reklamlar, kullanıcılar uygulamayla etkileşim kurarken ekranda kalmaya devam eder ve belirli bir süre sonra otomatik olarak yenilenebilir. Mobil reklamcılık konusunda yeniyseniz bu kaynaklardan yararlanabilirsiniz.

Banner reklam uygulama

Geçiş reklamı

Kullanıcı tarafından kapatılana kadar bir uygulamanın arayüzünü kaplayan tam ekran reklamlar. Bu reklamlar en iyi şekilde, uygulamanın akışındaki doğal duraklamalar sırasında (ör. bir oyunun seviyeleri arasında veya bir görev tamamlandıktan hemen sonra) kullanılır.

Geçiş reklamları uygulama

Ödüllü

Kullanıcıları kısa videolar izledikleri ve oynatılabilir reklamlarla etkileşimde bulundukları için ödüllendiren reklamlar reklamlar ve anketler. Ücretsiz uygulamalardan para kazanmak için kullanılır.

Ödüllü reklamları uygulama