Menambahkan Google Analytics for Firebase ke aplikasi instan

Melacak keberhasilan suatu aplikasi, instan atau yang diinstal, adalah penting bagi developer. Beberapa pustaka analitik kompatibel dengan Google Play Instan, termasuk Fabric Answers, Lokalitas, dan Mixpanel.

Jika solusi analisis Anda saat ini tidak tercantum atau jika ternyata Anda tidak bekerja dengan Google Play Instan, pertimbangkan untuk menggunakan Google Analytics for Firebase solusi telemetri. Halaman ini menjelaskan cara menyiapkan Google Analytics for Firebase dalam project aplikasi instan.

Menambahkan Google Analytics for Firebase ke project aplikasi instan

  1. Tambahkan Firebase SDK ke aplikasi Anda dengan mengikuti petunjuk yang dijelaskan dalam Panduan memulai Google Analytics for Firebase.
  2. Gunakan versi terbaru plugin google-services.
  3. Tempatkan file google-services.json dalam setiap modul.

  4. Tambahkan baris berikut ke setiap file build.gradle modul:

    Groovy

    // android { ... }
// dependencies { ... }
plugins {
    id 'com.google.gms.google-services'
}

    Kotlin

    // android { ... }
// dependencies { ... }
plugins {
    id("com.google.gms.google-services")
}

Setelah menambahkan Google Analytics for Firebase ke project aplikasi instan, Anda dapat menggunakan Google Analytics for Firebase API seperti yang mungkin Anda lakukan di project aplikasi yang dapat diinstal.

Untuk informasi selengkapnya tentang cara menggunakan Google Analytics for Firebase API, lihat tindakan dokumentasi memulai untuk Google Analytics for Firebase.

Membedakan antara data aplikasi yang diinstal dan instan

Karena aplikasi yang diinstal dan aplikasi instan sama-sama memiliki nama paket, Anda mungkin ingin membedakan peristiwa dan data yang dikumpulkan dari masing-masing peristiwa. Kepada membedakan aplikasi instan dan aplikasi yang diinstal di Analytics, menetapkan properti pengguna app_type, dengan nilai "instan" untuk aplikasi instan dan "diinstal" untuk aplikasi yang diinstal.

Cuplikan kode berikut menunjukkan aktivitas yang mendapatkan Instance Analytics, lalu menetapkan properti pengguna. Perhatikan bahwa penggunaan kode PackageManagerCompat.isInstantApp() dalam onCreate(android.os.Bundle) untuk menentukan konteks aplikasi.

Kotlin

val STATUS_INSTALLED = "installed"
val STATUS_INSTANT = "instant"
val ANALYTICS_USER_PROP = "app_type"

private lateinit var firebaseAnalytics: FirebaseAnalytics

protected fun onCreate(savedInstanceState: Bundle?) {
    ...

    firebaseAnalytics = FirebaseAnalytics.getInstance(this)

    // Determine the current app context, either installed or instant, then
    // set the corresponding user property for Google Analytics.
    if (InstantApps.getPackageManagerCompat(this).isInstantApp()) {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTANT)
    } else {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTALLED)
    }
}

Java

final String STATUS_INSTALLED = "installed";
final String STATUS_INSTANT = "instant";
final String ANALYTICS_USER_PROP = "app_type";

private FirebaseAnalytics firebaseAnalytics;

@Override
protected void onCreate(Bundle savedInstanceState) {
    ...

    firebaseAnalytics = FirebaseAnalytics.getInstance(this);

    // Determine the current app context, either installed or instant, then
    // set the corresponding user property for Google Analytics.
    if (InstantApps.getPackageManagerCompat(this).isInstantApp()) {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTANT);
    } else {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTALLED);
    }

}

Setelah menetapkan properti pengguna app_type, Anda dapat memilih peristiwa di tab Events konsol Analytics, lalu filter peristiwa menurut Nilai app_type. Proyeksi data yang dihasilkan memberi Anda hitungan untuk peristiwa yang ditentukan di aplikasi instan atau aplikasi terinstal.

Untuk informasi selengkapnya tentang cara mencatat log dan melihat peristiwa di Google Analytics for Firebase, lihat artikel Mencatat Peristiwa ke Dalam Log.

Menafsirkan peristiwa Analytics

Analytics memungkinkan Anda melacak berbagai metrik yang berharga ke aplikasi instan. Tabel berikut menjelaskan metrik yang relevan untuk aplikasi instan, termasuk nama peristiwa atau properti yang sesuai di Analisis.

Nama Nilai Analytics Definisi
Kunjungan session_start Sesi dimulai. Peristiwa ini dilacak secara otomatis.
Pembelian fisik Firebase.Event.ECOMMERCE_PURCHASE Pembelian fisik. Anda harus melacak peristiwa ini secara eksplisit dalam kode Anda.
Pembelian digital in_app_purchase Pembelian dalam aplikasi digital. Peristiwa ini dilacak secara otomatis.
Waktu dalam aplikasi user_engagement Durasi waktu yang dihabiskan aplikasi di latar depan. Peristiwa ini dilacak secara otomatis.
Konteks aplikasi instan app_type Peristiwa yang muncul dari aplikasi yang berjalan secara instan atau diinstal konteks tambahan. Anda harus melacak peristiwa ini secara eksplisit dalam kode Anda. Lihat Membedakan antara aplikasi terinstal dan aplikasi instan di atas.
Pengunjung yang kembali session_start.count dan app_type Audiens pengguna yang berkunjung dua kali atau lebih. Anda harus secara eksplisit melacak peristiwa app_type; session_start dilacak untuk Anda. Lihat Membedakan antara data aplikasi terinstal dan aplikasi instan di atas.

Untuk informasi selengkapnya tentang konstanta untuk peristiwa yang bisa Anda kumpulkan Analytics, lihat FirebaseAnalytics.Event.