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 mengarahkan pengguna ke aplikasi atau game reguler mereka, menggunakan deeplink untuk mengalihkan mereka ke perjalanan atau fitur tertentu jika relevan.

Melacak keberhasilan aplikasi, baik instan maupun terinstal, penting bagi setiap developer. Ada beberapa library analisis yang kompatibel dengan Google Play Instan, termasuk Fabric Answers, Localytics, dan Mixpanel.

Jika solusi analisis Anda saat ini tidak tercantum atau ternyata tidak berfngsi dengan Google Play Instan, pertimbangkan 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 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 kemudian 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 dan kemudian 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 konteks. Anda harus secara eksplisit melacak peristiwa ini dalam kode. Lihat Membedakan data aplikasi terinstal dan instan di atas.
Pengunjung 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 terinstal dan instan di atas.

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