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 (ngay lập tức hay được cài đặt) có vai trò 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 Câu trả lời của vải, 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 giải pháp đó không có để làm việc 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 dự án ứng dụng tức thì.

Thêm Google Analytics cho Firebase vào 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 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 API Google Analytics cho Firebase như cách bạn có thể dùng 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 bài viết thời gian 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ì

Vì cả ứng dụng cần 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 thu thập được từ mỗi sự kiện. Người nhận phân biệt ứng dụng tức thì và ứng dụng được cài đặt trong Analytics, hãy đặt một thuộc tính người dùng app_type, có giá trị " cửa hàng 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 phiên bản Analytics rồi đặt một thuộc tính người dùng. Lưu ý rằng mã sử dụng PackageManagerCompat.isInstantApp() trong 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 trong bảng điều khiển Analytics 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 tổng số sự kiện được chỉ định trong ứng dụng tức thì hoặc ứng dụng đã cài đặt của bạn.

Để biết thêm thông tin về cách ghi nhật ký và xem sự kiện trong Google Analytics cho Firebase, xem Ghi nhật ký 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ị cho ứ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ì, bao gồm tên sự kiện hoặc thuộc tính tương ứng trong Số liệu phân tích.

Để 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 FirebaseAnalytics.Event.