Başla

Bu kılavuz, Firebase kullanmadan bir C uygulamasından AdMob ile para kazanmak isteyen yayıncılar için hazırlanmıştır. Uygulamanıza Firebase'i dahil etmeyi planlıyorsanız veya kullanmayı düşünüyorsanız bu kılavuzun Firebase ile AdMob sürümünü inceleyin.

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

Google Mobile Ads C SDK'sı, Google Mobile Ads iOS ve Android SDK'larını sarmalar 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ı kullandığından firebase::gma ad alanında yer alır.

Bu kılavuzu ilk kez kullanıyorsanız Google Mobile Ads C test uygulamasını indirip ilgili adımları uygulamanızı öneririz.

Ö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. AdMob hesabına oturum açın veya kaydolun.

2. Uygulamanızı AdMob'a kaydedin. Bu adımda, bu kılavuzun ilerleyen bölümlerinde ihtiyaç duyulan benzersiz AdMob uygulama kimliğine sahip bir AdMob uygulaması oluşturulur.

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 istediğiniz dizine çıkartarak açın.

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

Artık hazırsınız! C uygulamanız, Google Mobile Ads C SDK'sını diğer Firebase hizmetleri olmadan kullanacak şekilde yapılandırılmıştır.

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, SDK'yı başlatan ve başlatma tamamlandığında (veya 30 saniyelik zaman aşımının ardından) firebase::Future işlemini tamamlayan firebase::gma::Initialize() çağrısı yaparak Google Mobile Ads C SDK'sını başlatmasını sağlayın. Bunun yalnızca bir kez yapılması gerekir. İdeal olarak uygulama lansmanında bu yapılır.

Reklamlar, Initialize() çağrısının ardından Google Mobile Ads C SDK'sı veya uyumlulaştırma iş ortağı SDK'ları tarafından önceden yüklenebilir. Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcılardan izin almanız gerekiyorsa isteğe özel herhangi bir işareti (tag_for_child_directed_treatment veya tag_for_under_age_of_consent gibi) ayarlayın veya reklamları yüklemeden önce gerekli işlemleri yapın. Google Mobile Ads C SDK'sını başlatmadan önce firebase::gma::SetRequestConfiguration() komutunu çağırarak bunu yaptığınızdan emin olun. Daha fazla bilgi için Hedefleme kılavuzumuza bakın.

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, eşzamansız yöntem çağrılarınızın tamamlanma durumunu belirlemeniz için bir yöntem sunar.

Örneğin, uygulamanız firebase::gma::Initialize() yöntemini çağırdığında yeni bir firebase::Future oluşturulur ve döndürülür. Daha sonra uygulamanız, başlatmanın ne zaman tamamlandığını belirlemek için Future öğesinin status() öğesini yoklayabilir. İşlem tamamlandığında, uygulamanız result() yöntemini çağırarak AdapterInitializationStatus sonucunu elde edebilir.

Future değeri döndüren yöntemler, uygulamaların belirli bir işlem için en son Future değerini almak üzere kullanabileceği karşılık gelen bir "son sonuç" yöntemine sahiptir. Örneğin, firebase::gma::Initialize(), firebase::gma::InitializeLastResult() adında karşılık gelen bir yönteme sahip. Bu yöntem, uygulamanız tarafından firebase::gma::Initialize() öğesine yapılan son çağrının durumunu kontrol etmek için kullanabileceğiniz bir Future değeri döndürüyor.

Future işleminin durumu tamamlandıysa ve hata kodu firebase::gma::kAdErrorCodeNone ise işlem başarıyla tamamlanmış demektir.

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

// 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ı ve reklam uygulamaya hazırsınız. AdMob bir dizi farklı reklam biçimi sunar. Böylece uygulamanızın kullanıcı deneyimine en uygun olanı seçebilirsiniz.

Banner

Cihaz ekranının üst veya alt kısmında görünen dikdörtgen reklamlar. Banner 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 tür bir başlangıç noktası olarak çok iyi bir noktadır.

Banner reklam uygulama

Geçişli

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

Geçiş reklamlarını uygulama

Ödül olarak verildi

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

Ödüllü reklamları uygulama