Thêm Google Analytics cho Firebase vào ứng dụng tức thì

Việc theo dõi mức độ thành công của một ứng dụng (dù là ứng dụng tức thì hay ứng dụng đã cài đặt) là điều quan trọng đối với mỗi nhà phát triển. Một số thư viện phân tích tương thích với Google Play tức thì, bao gồm Fabric Answers, Localytics và Mixpanel.

Nếu giải pháp phân tích hiện tại của bạn không có trong danh sách hoặc nếu bạn nhận thấy giải pháp đó không hoạt động với Google Play Instant, hãy cân nhắc sử dụng Google Analytics cho Firebase làm giải pháp đo từ xa. Trang này mô tả cách thiết lập Google Analytics cho Firebase trong một dự án ứng dụng tức thì.

Thêm Google Analytics cho Firebase vào một dự án ứng dụng tức thì

1. Thêm Firebase SDK vào ứng dụng của bạn bằng cách làm theo hướng dẫn được mô tả trong Hướng dẫn bắt đầu sử dụng Google Analytics cho Firebase.
2. Sử dụng phiên bản mới nhất của trình bổ trợ google-services.
3. Đặt tệp google-services.json trong mỗi mô-đun.

4. Thêm dòng sau vào tệp build.gradle của từng mô-đun:

   Groovy

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

   Kotlin

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

Sau khi thêm Google Analytics cho Firebase vào dự án ứng dụng tức thì, bạn có thể sử dụng các API Google Analytics cho Firebase như trong dự án ứng dụng có thể cài đặt.

Để biết thêm thông tin về cách sử dụng các API Google Analytics cho Firebase, hãy xem tài liệu bắt đầu sử dụng Google Analytics cho Firebase.

Phân biệt giữa dữ liệu của ứng dụng đã cài đặt và ứng dụng tức thì

Vì cả ứng dụng đã cài đặt và ứng dụng tức thì đều dùng chung một tên gói, nên bạn có thể muốn phân biệt các sự kiện và dữ liệu được thu thập từ mỗi ứng dụng. Để phân biệt ứng dụng tức thì và ứng dụng đã cài đặt trong Analytics, hãy đặt một thuộc tính người dùng app_type, với giá trị "tức thì" cho ứng dụng tức thì và "đã cài đặt" cho ứng dụng đã cài đặt.

Đoạn mã sau đây cho thấy một hoạt động nhận được một thực thể Analytics rồi đặt một thuộc tính người dùng. Xin lưu ý rằng mã này sử dụng PackageManagerCompat.isInstantApp() trong phương thức onCreate(android.os.Bundle) để xác định ngữ cảnh của ứng dụng.

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)
    }
}

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);
    }

}

Sau khi đặt thuộc tính người dùng app_type, bạn có thể chọn một sự kiện trong thẻ Sự kiện của bảng điều khiển Analytics, sau đó lọc sự kiện theo giá trị app_type. Dự đoán dữ liệu thu được sẽ cho bạn biết số lượng của sự kiện được chỉ định trong ứng dụng tức thì hoặc ứng dụng đã cài đặt.

Để biết thêm thông tin về cách ghi lại và xem sự kiện trong Google Analytics cho Firebase, hãy xem bài viết Ghi lại sự kiện.

Diễn giải sự kiện Analytics

Analytics cho phép bạn theo dõi nhiều chỉ số có giá trị đối với một ứng dụng tức thì. Bảng sau đây mô tả các chỉ số có liên quan cho ứng dụng tức thì của bạn, bao gồm cả tên sự kiện hoặc thuộc tính tương ứng trong Analytics.

Để biết thêm thông tin về các hằng số cho những sự kiện mà bạn có thể thu thập trong Analytics, hãy xem FirebaseAnalytics.Event.