Menambahkan Google Analytics for Firebase ke aplikasi instan

Melacak keberhasilan aplikasi, instan atau yang diinstal, merupakan hal penting bagi tiap 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

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

Tambahkan baris berikut ke setiap file build.gradle modul:

    // android { ... }
    // dependencies { ... }
    apply plugin: '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 kemudian menyetel properti pengguna. Perlu diperhatikan 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 Anda menyetel properti pengguna app_type, Anda dapat memilih peristiwa dalam tab Peristiwa konsol Analytics, kemudian memfilter peristiwa berdasarkan 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 terinstal dan instan di atas.

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