Başlarken

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

Google Mobile Ads C++ SDK'sını bir uygulamaya entegre etmek reklam gösterip gelir elde edebilirsiniz. SDK'yı entegre ettikten sonra şunları yapabilirsiniz: Geçiş reklamı veya ödüllü gibi bir reklam biçimi seçin ve aşağıdaki adımları uygulayın: uygulayacaksınız.

Google Mobile Ads C++ SDK'sı Google Mobile Ads iOS ve Android SDK'larını ve yalnızca bu platformlarda kullanılabilir. 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ılavuzdan ilk kez yararlanıyorsanız Google Mobil Reklamlar C++ testini kullanarak uygulamayı indirin ve uygulamasında gösterilir.

Ön koşullar

AdMob hesabınızda uygulamanızı ayarlayın

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ı Google Haritalar'daki AdMob. 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ğu için Firebase C++ SDK'sını indirin, ve istediğiniz bir dizine açılır.

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 Google Mobile Ads C++ SDK'sını kullanacak şekilde yapılandırıldı .

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

Google Mobile Ads SDK'sını başlatma

Reklamları yüklemeden önce uygulamanızın Google Mobile Ads C++ SDK'sını şu şekilde başlatmasını sağlayın: firebase::gma::Initialize() çağrısı, SDK'yı başlatır ve Başlatma tamamlandığında (veya 30 saniye sonra) firebase::Future zaman aşımı) ekleyebilirsiniz. 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ılavuzu.

Aşağıda, Initialize() yönteminin nasıl çağrılacağına ilişkin bir örnek 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, projenizin tamamlanma durumunu, eşzamansız yöntem çağrıları.

Örneğin, uygulamanız firebase::gma::Initialize() çağırdığında, yeni bir firebase::Future oluşturuldu ve döndürüldü. Uygulamanız o zaman Başlatma işleminin ne zaman tamamlandığını belirlemek için Future/status(). İşlem tamamlandığında, uygulamanız aşağıdaki sonuçları almak için result() yöntemini çağırabilir: AdapterInitializationStatus.

Future değeri döndüren yöntemlere karşılık gelen bir "son sonuç" bulunur. yöntemlerin 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. İçinde bazı durumlarda, geri çağırma farklı bir iş parçacığında çalışacak. Bu yüzden, kodunuzun iş parçacığı açısından güvenli olduğunu unutmayın. 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 bir reklam. AdMob çok sayıda farklı reklam biçimi sunar. Dolayısıyla, aralarından birini seçebilirsiniz. en uygun reklam biçimini seçin.

Banner

Cihaz ekranının üst veya alt kısmında görünen dikdörtgen reklamlar. Banner reklamlar, kullanıcılar uygulamayla etkileşim kurarken ekranda kalır ve bir süre sonra otomatik olarak yenilenir. Mobilde yeniyseniz bu aşamalar mükemmel bir başlangıç.

Banner reklam uygulama

Geçiş reklamı

Kullanıcı tarafından kapatılana kadar uygulamanın arayüzünü kaplayan tam ekran reklamlar. En iyi kullanım alanı, uygulama akışındaki doğal duraklamalarda (ör. seviyeler arasında veya bir görev tamamlandıktan hemen sonra

Geçiş reklamlarını 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