Menambahkan Google Analytics for Firebase ke instant app Anda

Peringatan: Google Play Instan tidak akan tersedia lagi. Mulai Desember 2025, Aplikasi Instan tidak dapat dipublikasikan melalui Google Play, dan semua API Instan layanan Google Play tidak akan berfungsi lagi. Pengguna tidak akan lagi disajikan Aplikasi Instan oleh Play menggunakan mekanisme apa pun.

Kami melakukan perubahan ini berdasarkan masukan developer dan investasi berkelanjutan kami untuk meningkatkan kualitas ekosistem sejak diperkenalkannya Google Play Instan.

Untuk terus mengoptimalkan pertumbuhan pengguna, sebaiknya developer merujuk pengguna ke aplikasi atau game reguler mereka, menggunakan deep link untuk mengalihkan mereka ke perjalanan atau fitur tertentu jika relevan.

Melacak keberhasilan aplikasi, instan atau yang diinstal, merupakan hal penting bagi tiap 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 menggunakan Google Analytics for Firebase sebagai solusi telemetri Anda. 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 Anda 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 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 instan memiliki nama paket yang sama, Anda dapat membedakan peristiwa dan data yang dikumpulkan dari masing-masing aplikasi. Untuk membedakan aplikasi instan dan aplikasi terinstal di Analytics, setel 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 menyetel properti pengguna. Perhatikan bahwa kode 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 menyetel properti pengguna app_type, Anda dapat memilih peristiwa di tab Peristiwa konsol Analytics, lalu memfilter peristiwa menurut nilai app_type. Proyeksi data yang dihasilkan memberi Anda jumlah 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 Mencatat Log Peristiwa.

Menafsirkan peristiwa Analytics

Analytics memungkinkan Anda melacak berbagai metrik yang bermanfaat bagi aplikasi instan. Tabel berikut menjelaskan metrik yang relevan bagi aplikasi instan Anda, termasuk nama peristiwa atau properti yang sesuai dalam 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 secara eksplisit melacak peristiwa ini dalam kode.
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 secara eksplisit melacak peristiwa ini dalam kode. 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 data aplikasi yang diinstal dan instan di atas.

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