C++ projenizde AdMob'u kullanmaya başlama

AdMob'un iOS ve Android SDK'larını kullanmayı düşünebilirsiniz.

Bu hızlı başlangıç kılavuzu, Firebase ile oluşturulmuş bir uygulamadan para kazanmak için AdMob kullanmak isteyen yayıncılar ve geliştiriciler için hazırlanmıştır. Uygulamanıza Firebase'i dahil etmeyi planlamıyorsanız bağımsız AdMob kılavuzunu inceleyin.

Henüz yapmadıysanız AdMob, Firebase ve Google Analytics'yi birlikte kullanmanın tüm avantajları hakkında bilgi edinin.

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

Başlamadan önce

• Firebase projeniz ve Firebase uygulamanız yoksa Firebase başlangıç kılavuzundaki adımları izleyin: Firebase'i C++ projenize ekleme.

• Firebase projenizde Google Analytics özelliğinin etkinleştirildiğinden emin olun:

  • Yeni bir Firebase projesi oluşturuyorsanız proje oluşturma iş akışı sırasında Google Analytics hizmetini etkinleştirin.

  • Google Analytics etkinleştirilmemiş mevcut bir Firebase projeniz varsa Google Analytics'i settings > Proje ayarları bölümündeki Entegrasyonlar sekmesinden etkinleştirebilirsiniz.

1. adım: Uygulamanızı AdMob hesabınızda ayarlayın.

1. Uygulamanızın her platform varyantını AdMob uygulaması olarak kaydedin.

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

   2. Uygulamanızın her platform varyantını AdMob ile kaydedin. Bu adımda, benzersiz bir AdMob Uygulama Kimliği'ne sahip bir AdMob uygulaması oluşturulur. Bu kimliğe kılavuzun ilerleyen bölümlerinde ihtiyacınız olacaktır.

   Mobile Ads SDK'sını uygulamanıza eklemeniz istenir. Bu görevle ilgili ayrıntılı talimatları bu kılavuzun ilerleyen bölümlerinde bulabilirsiniz.

2. AdMob uygulamalarınızın her birini ilgili Firebase uygulamasına bağlayın.

   Bu adım isteğe bağlıdır ancak kesinlikle önerilir. Kullanıcı metriklerini etkinleştirmenin ve AdMob uygulamalarınızı Firebase'e bağlamanın avantajları hakkında daha fazla bilgi edinin.

   Her platform varyantı için AdMob hesabınızın Uygulamalar kontrol panelinde aşağıdaki iki adımı tamamlayın:

   1. AdMob uygulamasının, AdMob hesabınızda seçilmiş analiz verilerini işlemesine ve göstermesine izin vermek için Kullanıcı Metrikleri'ni etkinleştirin. Ayrıca, AdMob uygulamanızı Firebase'e bağlamak için de bu ayarı etkinleştirmeniz gerekir.

   2. AdMob uygulamanızı mevcut Firebase projenize ve ilgili Firebase uygulamasına bağlayın.

      Firebase uygulamanız için girdiğiniz paket adını (Android) veya paket kimliğini (iOS) girdiğinizden emin olun. Firebase uygulamanızın paket adını veya paket kimliğini settings > Proje ayarları bölümündeki Uygulamalarınız kartında bulabilirsiniz.

2. adım: AdMob uygulama kimliğinizi uygulamanıza ekleyin

Android

AdMob uygulama kimliğinizi, <meta-data> etiketini aşağıda gösterildiği gibi ekleyerek uygulamanızın AndroidManifest.xml dosyasına ekleyin.

<manifest>
    <application>
        <!-- Sample AdMob App ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ADMOB_APP_ID"/>
    </application>
</manifest>

iOS

Uygulamanızın Info.plist dosyasında, dize değeri AdMob uygulama kimliğiniz olan bir GADApplicationIdentifier anahtarı ekleyin.

Bu değişikliği programatik olarak yapabilirsiniz:

<!-- Sample AdMob App ID: ca-app-pub-3940256099942544~1458002511 -->
<key>GADApplicationIdentifier</key>
<string>ADMOB_APP_ID</string>

Alternatif olarak, özellik listesi düzenleyicisinde düzenleyebilirsiniz:

3. adım: Google Mobile Ads SDK'sını ekleyin

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.

Android

1. Projenizin gradle.properties dosyasında, sıkıştırılmış dosyası açılan SDK'nın konumunu belirtin:

   systemProp.firebase_cpp_sdk.dir=FULL/PATH/TO/SDK

2. Projenizin settings.gradle dosyasına aşağıdaki içeriği ekleyin:

   def firebase_cpp_sdk_dir = System.getProperty('firebase_cpp_sdk.dir')
   
   gradle.ext.firebase_cpp_sdk_dir = "$firebase_cpp_sdk_dir"
   includeBuild "$firebase_cpp_sdk_dir"

3. Modülünüzün (uygulama düzeyinde) Gradle dosyasına (genellikle app/build.gradle), Google Mobile Ads C++ SDK'sının kitaplık bağımlılığını içeren aşağıdaki içeriği ekleyin.

   android.defaultConfig.externalNativeBuild.cmake {
     arguments "-DFIREBASE_CPP_SDK_DIR=$gradle.firebase_cpp_sdk_dir"
   }
   
   # Add the dependency for the Google Mobile Ads C++ SDK
   apply from: "$gradle.firebase_cpp_sdk_dir/Android/firebase_dependencies.gradle"
   firebaseCpp.dependencies {
     gma
   }

4. Projenizin CMakeLists.txt dosyasına aşağıdaki içeriği ekleyin.

   # Add Firebase libraries to the target using the function from the SDK.
   add_subdirectory(${FIREBASE_CPP_SDK_DIR} bin/ EXCLUDE_FROM_ALL)
   
   # Add the Google Mobile Ads C++ SDK.
   
   # The Firebase C++ library `firebase_app` is required,
   # and it must always be listed last.
   
   set(firebase_libs
     firebase_gma
     firebase_app
   )
   
   target_link_libraries(${target_name} "${firebase_libs}")

5. Tüm bağımlılıkların gerekli sürümlere sahip olduğundan emin olmak için uygulamanızı senkronize edin.

Her şey hazır C++ uygulamanız, Google Mobile Ads C++ SDK'sını kullanacak şekilde yapılandırılmıştır.

iOS

Bu bölümdeki adımlar, Google Mobile Ads C++ SDK'sını iOS projenize nasıl ekleyeceğinizi gösteren bir örnektir.

1. Aşağıdaki komutu çalıştırarak CocoaPods'un 1 veya sonraki bir sürümünü edinin:

   sudo gem install cocoapods --pre

2. Sıkıştırılmış SDK'dan Google Mobile Ads pod'unu ekleyin.

   1. Henüz bir Podfile dosyanız yoksa oluşturun:

      cd YOUR_APP_DIRECTORY
      pod init

   2. Podfile dosyanıza Google Mobile Ads C++ SDK'sı için kapsülü ekleyin:

      pod 'Google-Mobile-Ads-SDK'

   3. Pod'u yükleyin, ardından Xcode'da .xcworkspace dosyasını açın.

      pod install
      open YOUR_APP.xcworkspace

   4. Firebase C++ SDK'sından aşağıdaki çerçeveleri projeye ekleyin:

      • xcframeworks/firebase.xcframework
      • xcframeworks/firebase_gma.xcframework

Her şey hazır C++ uygulamanız, Google Mobile Ads C++ SDK'sını kullanacak şekilde yapılandırılmıştır.

4. adım: Google Mobile Ads SDK'sını başlatma

Reklamları yüklemeden önce firebase::gma::Initialize() yöntemini çağırarak Mobile Ads SDK'sını başlatın.

Bu çağrı, ilk kullanıma hazırlama işlemi tamamlandıktan sonra (veya 30 saniyelik zaman aşımının ardından) tamamlanan bir firebase::Future döndürür. Bu yöntemi yalnızca bir kez ve mümkün olduğunca erken, ideal olarak uygulama başlatılırken çağırın.

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

5. adım: Uygulamanızda kullanacağınız reklam biçimini seçin

AdMob, uygulamanızın kullanıcı deneyimine en uygun biçimi seçebilmeniz için çeşitli reklam biçimleri sunar. AdMob belgelerindeki ayrıntılı uygulama talimatlarını görüntülemek için bir reklam biçiminin düğmesini tıklayın.

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 kalmaya devam eder ve belirli bir süre sonra otomatik olarak yenilenebilir. Mobil reklamcılıkta yeniyseniz bu reklamlar başlamak için idealdir.

Geçişli

Kullanıcı tarafından kapatılana kadar bir uygulamanın arayüzünü kaplayan tam ekran reklamlar

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

Ödüllü

Kısa videoları izleyen, ayrıca oynanabilir reklam ve anketlerle etkileşimde bulunan kullanıcıları ödüllendiren reklamlardır.

Ödüllü (veya "ödül tabanlı") reklamlar, ücretsiz oynanabilen oyun kullanıcılarından para kazanmanıza yardımcı olabilir.

Ödüllü reklamları uygulama

Diğer ilgi alanı konuları

AdMob ile metrikleri ölçmenin ve Firebase özelliklerini entegre etmenin diğer yollarını keşfedin.

Kullanıcı metriklerini ve analiz verilerini görüntüleme

Başlatıldıktan sonra Mobile Ads SDK'sı, uygulamanızdan analiz etkinliklerini ve kullanıcı özelliklerini otomatik olarak günlüğe kaydetmeye başlar. Uygulamanıza ek kod eklemeden veya reklam uygulamadan bu verileri görüntüleyebilirsiniz. Bu analiz verilerini görebileceğiniz yerler:

• AdMob hesabınızın Kullanıcı metrikleri kartında (Ana sayfa veya Uygulamalar kontrol paneli), toplanan analiz verilerinden elde edilen seçilmiş kullanıcı metriklerini (ör. ortalama oturum süresi, ARPU ve elde tutma) görüntüleyebilirsiniz.

• Firebase Console'un Analytics kontrol panelinde, toplu istatistikleri ve temel metriklerin özetlerini görüntüleyebilirsiniz. Google Analytics için Firebase SDK'sını eklerseniz Firebase konsolunda reklam kampanyaları için dönüşümleri işaretleyebilir ve özel kitleler oluşturabilirsiniz.

ARPU ve ARPPU metriklerini daha iyi temsil etmek için bu metriklerin gelir hesaplamasına ecommerce_purchase adlı analiz özel etkinliğinden elde edilen verileri dahil etmek isteyebileceğinizi unutmayın (nasıl yapacağınızı öğrenin).

(İsteğe bağlı) Google Analytics ve Firebase'in diğer özelliklerini kullanma

Uygulamadan para kazanma ve kullanıcı etkileşimini artırmak için daha fazla fırsat ve özellikten yararlanın:

• Google Analytics için Firebase SDK'sını ekleme ve kullanma

  • Uygulamanızda özel etkinlik günlüğe kaydetme özelliğini uygulayın.

  • Özel reklam kampanyaları için dönüşümleri işaretleyin.

  • ARPU ve ARPPU metrikleri için gelir hesaplamasına ecommerce_purchase etkinlik verilerini dahil edin.

  Daha fazla bilgi edinmek için AdMob uygulamalarında Google Analytics ve Firebase'i kullanma kılavuzunu inceleyin.

• Uygulamanızda diğer Firebase ürünlerini kullanma

  Google Analytics için Firebase SDK'sını ekledikten sonra uygulamanızdaki reklamları optimize etmek için diğer Firebase ürünlerini kullanın.

  • Remote Config, uygulama güncellemesi yayınlamadan uygulamanızın davranışını ve görünümünü değiştirmenize olanak tanır.

  • A/B Testing, uygulamanızın kullanıcı arayüzünde, özelliklerinde veya etkileşim kampanyalarında yaptığınız değişiklikleri test etmenize olanak tanır. Böylece, değişiklikleri geniş çapta kullanıma sunmadan önce önemli metrikleriniz (ör. gelir ve elde tutma) üzerinde bir etki yaratıp yaratmadıklarını öğrenebilirsiniz.