Başlarken

Bu kılavuz, Firebase kullanmadan AdMob ile bir C++ uygulamasından para kazanmak isteyen yayıncılar içindir. Uygulamanıza Firebase'i dahil etmeyi planlıyorsanız veya bunu düşünüyorsanız bu kılavuzun Firebase ile AdMob sürümüne bakın.

Google Mobile Ads C++ SDK'sını bir 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 bu biçimi uygulamak için gereken adımları takip edebilirsiniz.

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ı kullanır. Bu nedenle, firebase::gma ad alanında bulunur.

Bu kılavuzu ilk kez kullanıyorsanız Google Mobile Ads C++ test uygulamasını indirip takip etmenizi öneririz.

Ön koşullar

AdMob hesabınızda uygulamanızı ayarlama

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

1. AdMob hesabınızda oturum açın veya AdMob hesabı için kaydolun.

2. Uygulamanızı AdMob'a kaydedin. Bu adımda, bu kılavuzun ilerleyen bölümlerinde ihtiyaç duyacağınız benzersiz bir 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 bir dizine açın.

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

Her şey hazır C++ uygulamanız, başka Firebase hizmetleri olmadan Google Mobile Ads C++ SDK'sını 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 firebase::gma::Initialize() yöntemini çağırarak Google Mobile Ads C++ SDK'sını başlatmasını sağlayın. Bu yöntem SDK'yı başlatır ve başlatma işlemi tamamlandıktan sonra (veya 30 saniyelik zaman aşımının ardından) bir firebase::Future tamamlar. Bu işlemin yalnızca bir kez, ideal olarak uygulama başlatılırken yapılması gerekir.

Initialize() çağrıldığında reklamlar 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, isteğe özel işaretler (ör. tag_for_child_directed_treatment veya tag_for_under_age_of_consent) ayarlamanız ya da reklamları yüklemeden önce başka bir işlem yapmanız gerekiyorsa Google Mobile Ads C++ SDK'sını başlatmadan önce firebase::gma::SetRequestConfiguration() yöntemini çağırarak bunu yapın. Daha fazla bilgi için Hedefleme kılavuzumuzu inceleyin.

Initialize() yöntemini çağırmayla ilgili bir örneği aşağıda bulabilirsiniz:

// 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.
}

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 belirlemenize olanak tanır.

Örneğin, uygulamanız firebase::gma::Initialize() yöntemini çağırdığında yeni bir firebase::Future oluşturulur ve döndürülür. Uygulamanız, başlatma işleminin ne zaman tamamlandığını belirlemek için Future öğesinin status() değerini sorgulayabilir. İşlem tamamlandığında uygulamanız, sonuçta elde edilen AdapterInitializationStatus değerini almak için result() yöntemini çağırabilir.

Future döndüren yöntemlerin, 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öntemi vardır. Örneğin, firebase::gma::Initialize() yönteminin firebase::gma::InitializeLastResult() adında karşılık gelen bir yöntemi vardır. Bu yöntem, uygulamanızın firebase::gma::Initialize() yöntemine yapılan son çağrının durumunu kontrol etmek için kullanabileceği bir Future döndürür.

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

Future tamamlandığında çağrılacak geri çağırmaları da kaydedebilirsiniz. Bazı durumlarda geri çağırma 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 ç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.
  }
}

Bir reklam biçimi seçin

Google Mobile Ads C++ SDK'sı içe aktarıldı ve 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ıkta yeniyseniz bu reklamlar başlamak için idealdir.

Banner reklamları uygulama

Geçiş reklamı

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

Geçiş reklamlarını uygulama

Ödüllü

Kısa videoları izleyen, ayrıca oynanabilir reklam ve anketlerle etkileşimde bulunan kullanıcıları ödüllendiren reklamlardır. Ücretsiz oynanabilen uygulamalardan para kazanmak için kullanılır.

Ödüllü reklamları uygulama