Başlarken

Bu kılavuz, Firebase'i kullanmadan AdMob ile C++ uygulamasından para kazanmak isteyen yayıncılar içindir. Uygulamanıza Firebase'i dahil etmeyi planlıyorsanız veya 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österme ve gelir elde etme yolunda atılacak ilk adımdı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 adımları takip edebilirsiniz.

Google Mobile Ads C++ SDK'sı, Google Mobile Ads iOS ve Android SDK'larını kapsar ve yalnızca bu platformlarda kullanılabilir. Google Mobile Ads C++ SDK'sı, asenkron işlemleri desteklemek için Firebase C++ yapılarını kullandığından firebase::gma ad alanında bulunur.

Bu kılavuzu ilk kez inceliyorsanız Google Mobil Reklamlar C++ test uygulamasını indirip bu uygulamayı kullanarak kılavuzu takip etmenizi öneririz.

Ön koşullar

AdMob hesabınızda uygulamanızı ayarlama

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

1. AdMob hesabında oturum açın veya hesap oluşturun.

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

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

Google Mobile Ads C++ SDK'sı firebase::gma ad alanında bulunduğundan, Firebase C++ SDK'sını indirin, ardından istediğiniz bir dizine çıkarı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, diğer Firebase hizmetleri olmadan Google Mobile Ads C++ SDK'sını kullanacak şekilde yapılandırılmış olmalıdır.

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

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

Uygulamanız, reklamları yüklemeden önce firebase::gma::Initialize() çağırarak Google Mobile Ads C++ SDK'sını ilk kullanıma hazırlamalıdır. Bu işlem 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) bir firebase::Future tamamlar. Bu işlem yalnızca bir kez yapılmalıdır (ideal olarak uygulama başlatılırken).

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() işlevini çağırarak bu işlemleri yaptığınızdan emin olun. Daha fazla bilgi için Hedefleme rehberimizi inceleyin.

Initialize()'yı çağırma örneğini aşağıda görebilirsiniz:

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

Örneğin, uygulamanız firebase::gma::Initialize() işlevini çağırdığında yeni bir firebase::Future oluşturulup döndürülür. Uygulamanız daha sonra başlatma işleminin ne zaman tamamlandığını belirlemek için status() Future değerini yoklayabilir. İşlem tamamlandıktan sonra uygulamanız, sonuçtaki result() değerini almak için AdapterInitializationStatus işlevini ç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 "sonuç" yöntemi vardır. Örneğin, firebase::gma::Initialize() için firebase::gma::InitializeLastResult() adlı bir yöntem vardır. Bu yöntem, uygulamanızın firebase::gma::Initialize() için yapılan son çağrının durumunu kontrol etmek üzere kullanabileceği bir Future döndürür.

Future durumunun tamamlanmış olması ve hata kodunun firebase::gma::kAdErrorCodeNone olması durumunda işlem başarıyla tamamlanmıştır.

Ayrıca, bir Future tamamlandığında çağrılacak geri çağırmalar da kaydedebilirsiniz. Geri çağırma işlevi bazı durumlarda 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'inde geri çağırma için bir işlev işaretçisi kullanılı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ı artık içe aktarıldı ve 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şimde bulunurken ekranda kalır ve belirli bir süre sonra otomatik olarak yenilenebilir. Mobil reklamcılığa yeni başladıysanız bu kılavuzlar, başlangıç için harika bir kaynak olabilir.

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, uygulamanın yürütülme akışındaki doğal duraklamalarda (ör. bir oyunun seviyeleri arasında veya bir görev tamamlandıktan hemen sonra) en iyi şekilde kullanılır.

Geçiş reklamlarını uygulama

Ödüllü

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

Ödüllü reklamları uygulama