Ikuti semua informasi yang diumumkan di Firebase Summit, dan pelajari bagaimana Firebase dapat membantu Anda mempercepat pengembangan aplikasi dan menjalankan aplikasi dengan percaya diri. Pelajari Lebih Lanjut

Memulai AdMob di proyek C++ Anda

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Panduan memulai cepat ini ditujukan untuk penayang dan pengembang yang ingin menggunakan AdMob untuk memonetisasi aplikasi yang dibuat dengan Firebase.

Jika Anda belum melakukannya, pelajari semua manfaat menggunakan AdMob, Firebase, dan Google Analytics bersama-sama.

Jika ini pertama kalinya Anda membaca panduan ini, sebaiknya unduh dan ikuti menggunakan aplikasi pengujian Google Mobile Ads C++ SDK .

Sebelum kamu memulai

  • Jika Anda belum memiliki proyek Firebase dan aplikasi Firebase, ikuti panduan memulai Firebase: Tambahkan Firebase ke proyek C++ Anda .

  • Pastikan Google Analytics diaktifkan di proyek Firebase Anda:

    • Jika Anda membuat proyek Firebase baru, aktifkan Google Analytics selama alur kerja pembuatan proyek.

    • Jika Anda sudah memiliki proyek Firebase yang tidak mengaktifkan Google Analytics, Anda dapat mengaktifkan Google Analytics dari tab Integrasi di > Setelan proyek .

Langkah 1: Siapkan aplikasi Anda di akun AdMob Anda

  1. Daftarkan setiap varian platform aplikasi Anda sebagai aplikasi AdMob.

    1. Masuk atau daftar akun AdMob.

    2. Daftarkan setiap varian platform aplikasi Anda dengan AdMob . Langkah ini membuat aplikasi AdMob dengan ID Aplikasi AdMob unik yang akan Anda perlukan nanti dalam panduan ini.

    Anda akan diminta untuk menambahkan Mobile Ads SDK ke aplikasi Anda. Temukan instruksi terperinci untuk tugas ini nanti dalam panduan ini.

  2. Tautkan setiap aplikasi AdMob Anda ke aplikasi Firebase yang sesuai.

    Langkah ini opsional tetapi sangat disarankan. Pelajari lebih lanjut tentang manfaat mengaktifkan metrik pengguna dan menautkan aplikasi AdMob Anda ke Firebase.

    Untuk setiap varian platform, selesaikan dua langkah berikut di dasbor Aplikasi akun AdMob Anda:

    1. Aktifkan Metrik Pengguna untuk mengizinkan AdMob memproses dan menampilkan data analitik pilihan di akun AdMob Anda. Ini juga merupakan setelan wajib bagi Anda untuk menautkan aplikasi AdMob ke Firebase.

    2. Tautkan aplikasi AdMob Anda ke proyek Firebase yang ada dan aplikasi Firebase yang sesuai.

      Pastikan Anda memasukkan nama paket (Android) atau ID bundel (iOS) yang sama dengan yang Anda masukkan untuk aplikasi Firebase. Temukan nama paket atau ID bundel aplikasi Firebase Anda di kartu Aplikasi Anda di Anda > Setelan proyek .

Langkah 2: Tambahkan ID Aplikasi AdMob Anda ke aplikasi Anda

Android

Tambahkan ID Aplikasi AdMob Anda ke file AndroidManifest.xml aplikasi Anda dengan menambahkan <meta-data> seperti yang ditunjukkan di bawah ini.

<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

Di file Info.plist aplikasi Anda, tambahkan kunci GADApplicationIdentifier dengan nilai string ID Aplikasi AdMob Anda.

Anda dapat membuat perubahan ini secara terprogram:

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

Atau, edit di editor daftar properti:

Editor Daftar Properti

Langkah 3: Tambahkan SDK Iklan Seluler Google

Karena Google Mobile Ads C++ SDK berada di firebase::gma namespace, unduh Firebase C++ SDK , lalu unzip ke direktori pilihan Anda.

Firebase C++ SDK tidak spesifik platform, tetapi memerlukan konfigurasi library khusus platform.

Android

  1. Di file gradle.properties proyek Anda, tentukan lokasi SDK yang tidak di-zip:

    systemProp.firebase_cpp_sdk.dir=FULL/PATH/TO/SDK
  2. Ke file settings.gradle proyek Anda, tambahkan konten berikut:

    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. Ke file Gradle modul (tingkat aplikasi) Anda (biasanya app/build.gradle ), tambahkan konten berikut, yang menyertakan dependensi pustaka untuk Google Mobile Ads C++ SDK.

    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. Ke file CMakeLists.txt proyek Anda, tambahkan konten berikut.

    # 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. Sinkronkan aplikasi Anda untuk memastikan bahwa semua dependensi memiliki versi yang diperlukan.

Anda sudah siap! Aplikasi C++ Anda dikonfigurasi untuk menggunakan SDK C++ Iklan Seluler Google.

iOS

Langkah-langkah di bagian ini adalah contoh cara menambahkan SDK C++ Iklan Seluler Google ke proyek iOS Anda.

  1. Dapatkan CocoaPods versi 1 atau lebih baru dengan menjalankan:

    sudo gem install cocoapods --pre
  2. Tambahkan pod Iklan Seluler Google dari SDK yang dibuka ritsletingnya.

    1. Buat Podfile jika Anda belum memilikinya:

      cd YOUR_APP_DIRECTORY
      pod init
    2. Ke Podfile Anda, tambahkan pod untuk Google Mobile Ads C++ SDK:

      pod 'Google-Mobile-Ads-SDK'
    3. Instal pod, lalu buka file .xcworkspace di Xcode.

      pod install
      open YOUR_APP.xcworkspace
    4. Tambahkan kerangka kerja berikut dari Firebase C++ SDK ke proyek:

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

Anda sudah siap! Aplikasi C++ Anda dikonfigurasi untuk menggunakan SDK C++ Iklan Seluler Google.

Langkah 4: Inisialisasi SDK Iklan Seluler Google

Sebelum memuat iklan, inisialisasi Mobile Ads SDK dengan memanggil firebase::gma::Initialize() .

Panggilan ini mengembalikan firebase::Future yang selesai setelah inisialisasi selesai (atau setelah batas waktu 30 detik). Panggil metode ini hanya sekali dan sedini mungkin, idealnya saat peluncuran aplikasi.

Berikut ini contoh cara memanggil Initialize() :

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

Gunakan Future untuk memantau status penyelesaian panggilan metode

A Future memberi Anda cara untuk menentukan status penyelesaian panggilan metode asinkron Anda.

Misalnya, saat aplikasi Anda memanggil firebase::gma::Initialize() , firebase::Future baru akan dibuat dan dikembalikan. Aplikasi Anda kemudian dapat melakukan polling status() dari Future untuk menentukan kapan inisialisasi telah selesai. Setelah selesai, aplikasi Anda dapat memanggil result() untuk mendapatkan AdapterInitializationStatus yang dihasilkan.

Metode yang mengembalikan Future memiliki metode "hasil terakhir" yang sesuai yang dapat digunakan aplikasi untuk mengambil Future terbaru untuk tindakan tertentu. Misalnya, firebase::gma::Initialize() memiliki metode terkait yang disebut firebase::gma::InitializeLastResult() , yang mengembalikan Future yang dapat digunakan aplikasi Anda untuk memeriksa status panggilan terakhir ke firebase::gma::Initialize() .

Jika status Future selesai dan kode kesalahannya adalah firebase::gma::kAdErrorCodeNone , maka operasi telah berhasil diselesaikan.

Anda juga dapat mendaftarkan panggilan balik untuk dipanggil saat Future selesai. Dalam beberapa kasus, panggilan balik akan berjalan di utas yang berbeda, jadi pastikan kode Anda aman untuk utas. Cuplikan kode ini menggunakan penunjuk fungsi untuk panggilan balik:

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

Langkah 5: Pilih format iklan untuk diterapkan di aplikasi Anda

AdMob menawarkan sejumlah format iklan yang berbeda, sehingga Anda dapat memilih format yang paling sesuai dengan pengalaman pengguna aplikasi Anda. Klik tombol format iklan untuk melihat petunjuk penerapan terperinci di dokumentasi AdMob.

Iklan persegi panjang yang muncul di bagian atas atau bawah layar perangkat

Iklan spanduk tetap ditampilkan di layar saat pengguna berinteraksi dengan aplikasi, dan dapat disegarkan secara otomatis setelah jangka waktu tertentu. Jika Anda baru mengenal periklanan seluler, itu adalah tempat yang bagus untuk memulai.

Terapkan iklan spanduk

pengantara

Iklan layar penuh yang menutupi antarmuka aplikasi hingga ditutup oleh pengguna

Iklan pengantara paling baik digunakan pada jeda alami dalam alur eksekusi aplikasi, seperti di antara level game atau tepat setelah tugas selesai.

Terapkan iklan pengantara

Dihadiahi

Iklan yang memberi penghargaan kepada pengguna karena menonton video pendek dan berinteraksi dengan iklan dan survei yang dapat diputar

Iklan berhadiah (atau "berbasis hadiah") dapat membantu memonetisasi pengguna yang dapat dimainkan secara gratis.

Terapkan iklan berhadiah

Topik menarik lainnya

Lihat metrik pengguna dan data analitik

Setelah inisialisasi, Mobile Ads SDK secara otomatis mulai mencatat peristiwa analitik dan properti pengguna dari aplikasi Anda. Anda dapat melihat data ini tanpa menambahkan kode tambahan apa pun ke aplikasi Anda atau menerapkan iklan apa pun. Di sinilah Anda dapat melihat data analitik ini:

Perhatikan bahwa untuk merepresentasikan metrik ARPU dan ARPPU dengan lebih baik, Anda mungkin ingin menyertakan data dari peristiwa kustom analitik yang disebut ecommerce_purchase dalam penghitungan pendapatan untuk metrik ini ( pelajari caranya ).

(Opsional) Gunakan lebih banyak fitur Google Analytics dan Firebase

Manfaatkan lebih banyak peluang dan fitur untuk meningkatkan monetisasi aplikasi dan interaksi pengguna:

  • Tambahkan dan gunakan SDK Firebase untuk Google Analytics

  • Gunakan produk Firebase lain di aplikasi Anda

    Setelah Anda menambahkan SDK Firebase untuk Google Analytics, gunakan produk Firebase lainnya untuk mengoptimalkan iklan di aplikasi Anda.

    • Remote Config memungkinkan Anda mengubah perilaku dan tampilan aplikasi tanpa memublikasikan pembaruan aplikasi, tanpa biaya, untuk pengguna aktif harian tanpa batas.

    • Pengujian A/B memberi Anda kemampuan untuk menguji perubahan pada UI aplikasi, fitur, atau kampanye keterlibatan untuk mempelajari apakah perubahan tersebut berdampak pada metrik utama Anda (seperti pendapatan dan retensi) sebelum meluncurkan perubahan secara luas.

Untuk memulai, kunjungi panduan untuk menggunakan Google Analytics dan Firebase dengan aplikasi AdMob .