C++ projenizde AdMob'u kullanmaya başlayın

Bu hızlı başlangıç ​​kılavuzu, Firebase ile oluşturulmuş bir uygulamadan para kazanmak için AdMob'u kullanmak isteyen yayıncılar ve geliştiriciler içindir.

Henüz yapmadıysanız AdMob, Firebase ve Google Analytics'i birlikte kullanmanın tüm avantajlarını öğrenin.

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

Sen başlamadan önce

  • Halihazırda bir Firebase projeniz ve bir Firebase uygulamanız yoksa Firebase başlangıç ​​kılavuzunu takip edin: Firebase'i C++ projenize ekleyin .

  • Firebase projenizde Google Analytics'in etkinleştirildiğinden emin olun:

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

    • Google Analytics'in etkinleştirilmediği mevcut bir Firebase projeniz varsa, Google Analytics'i, > Proje ayarları'nın Entegrasyonlar sekmesinden etkinleştirebilirsiniz.

1. Adım: Uygulamanızı AdMob hesabınızda kurun

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

    1. Bir AdMob hesabında oturum açın veya kaydolun.

    2. Uygulamanızın her bir platform varyantını AdMob'a kaydedin . Bu adım, bu kılavuzun ilerleyen bölümlerinde ihtiyaç duyacağınız benzersiz bir AdMob Uygulama Kimliğine sahip bir AdMob uygulaması oluşturur.

    Mobil Reklamlar SDK'sını uygulamanıza eklemeniz istenecektir. Bu kılavuzda daha sonra bu görev için ayrıntılı yönergeler bulun.

  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 şiddetle tavsiye edilir. 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'un seçilmiş analiz verilerini AdMob hesabınızda işlemesine ve görüntülemesine izin vermek için Kullanıcı Metriklerini etkinleştirin . Ayrıca, AdMob uygulamanızı Firebase'e bağlamanız için gerekli bir ayardır.

    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, > Proje ayarlarınızdaki Uygulamalarınız kartında bulun.

2. Adım: AdMob Uygulama Kimliğinizi uygulamanıza ekleyin

Android

Aşağıda gösterildiği gibi <meta-data> etiketini ekleyerek AdMob Uygulama Kimliğinizi 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ına, AdMob Uygulama Kimliğinizin dize değerine sahip bir GADApplicationIdentifier anahtarı ekleyin.

Bu değişikliği programlı olarak yapabilirsiniz:

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

Veya özellik listesi düzenleyicisinde düzenleyin:

Mülk Listesi Düzenleyicisi

3. Adım: Google Mobil Reklamlar SDK'sını ekleyin

Google Mobile Ads C++ SDK'sı firebase::gma ad alanında bulunduğundan, Firebase C++ SDK'sını indirin ve ardından sıkıştırmasını istediğiniz bir dizine açın.

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

Android

  1. Projenizin gradle.properties dosyasında, sıkıştırılmamış 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üze (app-level) Gradle dosyanıza (genellikle app/build.gradle ), Google Mobile Ads C++ SDK için 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.

Hazırsınız! 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, iOS projenize Google Mobile Ads C++ SDK'sını nasıl ekleyeceğinize bir örnektir.

  1. Aşağıdakileri çalıştırarak CocoaPods sürüm 1 veya sonraki sürümünü edinin:

    sudo gem install cocoapods --pre
  2. Sıkıştırılmamış SDK'dan Google Mobil Reklamlar bölmesini ekleyin.

    1. Henüz yoksa bir Pod dosyası oluşturun:

      cd YOUR_APP_DIRECTORY
      pod init
    2. Pod dosyanıza Google Mobile Ads C++ SDK için bölmeyi ekleyin:

      pod 'Google-Mobile-Ads-SDK'
    3. Bölmeyi kurun, ardından .xcworkspace dosyasını Xcode'da açın.

      pod install
      open YOUR_APP.xcworkspace
    4. Firebase C++ SDK'dan projeye aşağıdaki çerçeveleri ekleyin:

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

Hazırsınız! 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şlatın

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

Bu çağrı, başlatma tamamlandığında (veya 30 saniyelik bir zaman aşımından sonra) 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 arayın.

Initialize() nasıl çağrılacağına dair bir örnek:

Android

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

iOS

// 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 bir Future kullanın

Bir Future , zaman uyumsuz yöntem çağrılarınızın tamamlanma durumunu belirlemeniz için bir yol sağlar.

Örneğin, uygulamanız firebase::gma::Initialize() öğesini çağırdığında, yeni bir firebase::Future oluşturulur ve döndürülür. Uygulamanız daha sonra başlatmanın ne zaman tamamlandığını belirlemek için Future status() yoklayabilir. Uygulamanız tamamlandıktan sonra, elde edilen AdapterInitializationStatus elde etmek için result() işlevini çağırabilir.

Bir Future döndüren yöntemler, uygulamaların belirli bir eylem için en son Future almak için kullanabileceği karşılık gelen bir "son sonuç" yöntemine sahiptir. Örneğin, firebase::gma::Initialize() firebase::gma::InitializeLastResult() karşılık gelen bir yönteme sahiptir ve bu, uygulamanızın firebase::gma'ya yapılan son çağrının durumunu kontrol etmek için kullanabileceği bir Future döndürür firebase::gma::Initialize() .

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

Bir Future tamamlandığında çağrılacak geri aramaları da kaydedebilirsiniz. Bazı durumlarda, geri arama farklı bir iş parçacığında çalışır, bu nedenle kodunuzun iş parçacığı için güvenli olduğundan emin olun. Bu kod parçacığı, geri arama 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ıza uygulamak için bir reklam biçimi seçin

AdMob, uygulamanızın kullanıcı deneyimine en uygun biçimi seçebilmeniz için bir dizi farklı reklam biçimi sunar. AdMob belgelerinde ayrıntılı uygulama talimatlarını görüntülemek için bir reklam biçimine ilişkin düğmeyi tıklayın.

Cihaz ekranının üstünde veya altında görünen dikdörtgen reklamlar

Banner reklamlar, kullanıcılar uygulamayla etkileşime girerken ekranda kalır ve belirli bir süre sonra otomatik olarak yenilenebilir. Mobil reklamcılıkta yeniyseniz, başlamak için harika bir yerdir.

Banner reklamları uygulayın

geçiş reklamı

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

Geçiş reklamları en iyi şekilde, bir oyunun seviyeleri arasında veya bir görev tamamlandıktan hemen sonra olduğu gibi, bir uygulamanın yürütme akışındaki doğal duraklamalarda kullanılır.

Geçiş reklamları uygulayın

Ödüllü

Kullanıcıları kısa videolar izledikleri ve oynatılabilir reklamlar ve anketlerle etkileşim kurdukları için ödüllendiren reklamlar

Ödüllü (veya "ödül tabanlı") reklamlar, oynaması ücretsiz kullanıcılardan para kazanmaya yardımcı olabilir.

Ödüllü reklamları uygulayın

Diğer ilgi konuları

Kullanıcı ölçümlerini ve analitik verilerini görüntüleyin

Başlatıldıktan sonra Mobile Ads SDK, uygulamanızdan analiz olaylarını ve kullanıcı özelliklerini otomatik olarak günlüğe kaydetmeye başlar. Bu verileri, uygulamanıza herhangi bir ek kod eklemeden veya herhangi bir reklam uygulamadan görüntüleyebilirsiniz. Bu analiz verilerini burada görebilirsiniz:

ARPU ve ARPPU metriklerini daha iyi temsil etmek için, bu metriklerin gelir hesaplamasına ecommerce_purchase adlı bir özel analiz etkinliğinden gelen verileri dahil etmek isteyebilirsiniz ( nasıl yapılacağını öğrenin ).

(İsteğe bağlı) Google Analytics ve Firebase'in daha fazla özelliğini kullanın

Uygulamadan para kazanmayı ve kullanıcı etkileşimini iyileştirmek için daha fazla fırsat ve özellikten yararlanın:

  • Google Analytics için Firebase SDK'sını ekleyin ve kullanın

  • Uygulamanızda diğer Firebase ürünlerini kullanın

    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 , sınırsız günlük etkin kullanıcı için ücretsiz olarak bir uygulama güncellemesi yayınlamadan uygulamanızın davranışını ve görünümünü değiştirmenize olanak tanır.

    • A/B Testi size, uygulamanızın kullanıcı arayüzünde, özelliklerinde veya etkileşim kampanyalarında yapılan değişiklikleri test etme ve değişiklikleri geniş çapta kullanıma sunmadan önce temel metrikleriniz (gelir ve elde tutma gibi) üzerinde bir etkisi olup olmadığını öğrenme gücü verir.

Başlamak için Google Analytics ve Firebase'i AdMob uygulamalarıyla kullanma kılavuzunu ziyaret edin.