Menambahkan Google Analytics for Firebase ke aplikasi instan

Melacak keberhasilan aplikasi, instan atau yang diinstal, merupakan hal penting bagi setiap developer. Beberapa library analisis kompatibel dengan Google Play Instan, termasuk Fabric Answers, Localytics, dan Mixpanel.

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

Menambahkan Google Analytics for Firebase ke project aplikasi instan

  1. Tambahkan Firebase SDK ke aplikasi dengan mengikuti petunjuk yang dijelaskan di Panduan memulai untuk 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 Anda lakukan di project aplikasi yang dapat diinstal.

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

Membedakan antara data aplikasi yang diinstal dan instan

Karena aplikasi yang diinstal dan aplikasi instan Anda memiliki nama paket yang sama, Anda mungkin ingin membedakan peristiwa dan data yang dikumpulkan dari setiap paket. Untuk membedakan aplikasi instan dan terinstal di Analytics, tetapkan properti pengguna app_type, dengan nilai "instan" untuk aplikasi instan dan "terinstal" untuk aplikasi terinstal.

Cuplikan kode berikut menunjukkan aktivitas yang mendapatkan instance Analytics, lalu menetapkan properti pengguna. Perhatikan bahwa kode tersebut menggunakan PackageManagerCompat.isInstantApp() dalam metode 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 pada konsol Analytics, lalu memfilter peristiwa menurut nilai app_type. Proyeksi data yang dihasilkan memberi Anda jumlah untuk peristiwa yang ditentukan pada aplikasi instan atau aplikasi terinstal.

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

Menafsirkan peristiwa Analytics

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

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 dalam konteks instan atau terinstal. Anda harus melacak peristiwa ini secara eksplisit dalam kode Anda. Lihat Membedakan antara data aplikasi yang diinstal dan 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 yang diinstal dan instan di atas.

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