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

Việc theo dõi sự thành công của một ứng dụng, tức thì hay đã 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 Instant, 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 thấy rằng 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 lường 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 trong bài viết Hướng dẫn bắt đầu sử dụng Google Analytics cho Firebase.
2. Sử dụng phiên bản trình bổ trợ google-services mới nhất.
3. Đặt tệp google-services.json vào 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 giống như trong một 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 hướng dẫn bắt đầu sử dụng Google Analytics cho Firebase.

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

Do cả ứng dụng đã cài đặt và ứng dụng tức thì của bạn đều có 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 qua mỗi ứng dụng. Để phân biệt ứng dụng tức thì và ứng dụng cần cài đặt trong Analytics, hãy đặt thuộc tính người dùng app_type, có giá trị "tức thì" cho ứng dụng tức thì và "đã cài đặt" cho ứng dụng cần 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 Analytics Console rồi lọc sự kiện đó theo giá trị app_type. Phép chiếu dữ liệu kết quả cung cấp cho bạn số lượng 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 nhật ký và xem các 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 ứ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ề hằng số cho những sự kiện mà bạn có thể thu thập trong Analytics, hãy xem bài viết FirebaseAnalytics.Event.