Bắt đầu sử dụng Google Analytics


Hướng dẫn bắt đầu nhanh này sẽ hướng dẫn bạn cách thêm Google Analytics vào ứng dụng và bắt đầu ghi nhật ký sự kiện.

Google Analytics thu thập dữ liệu về mức sử dụng và hành vi cho ứng dụng của bạn. SDK ghi nhật ký hai loại thông tin chính:

  • Sự kiện: Những gì đang xảy ra trong ứng dụng của bạn, chẳng hạn như hành động của người dùng, hệ thống hoặc lỗi.
  • Thuộc tính người dùng: Những thuộc tính mà bạn xác định để mô tả các phân khúc trong người dùng cơ sở người dùng, chẳng hạn như ngôn ngữ ưu tiên hoặc vị trí địa lý.

Analytics tự động ghi lại một số nhật ký sự kiện và thuộc tính người dùng; bạn không cần thêm bất kỳ mã nào để bật chúng.

Trước khi bắt đầu

Nếu bạn chưa thêm Firebase, hãy thêm Firebase vào thiết bị Android của bạn dự án và đảm bảo rằng Google Analytics bật trong dự án Firebase của bạn:

  • Nếu bạn đang tạo một dự án Firebase mới, hãy bật Google Analytics trong quy trình tạo dự án.

  • Nếu bạn đang sử dụng một dự án Firebase hiện không có Đã bật Google Analytics, hãy chuyển đến Các công cụ tích hợp trong số > Cài đặt dự án để bật tính năng này.

Khi bạn bật Google Analytics trong dự án, các ứng dụng Firebase của bạn sẽ được liên kết với Google Analytics luồng dữ liệu.

Thêm SDK Analytics vào ứng dụng

  1. Trong tệp Gradle mô-đun (cấp ứng dụng) (thường là <project>/<app-module>/build.gradle.kts hoặc <project>/<app-module>/build.gradle), thêm phần phụ thuộc cho thư viện Analytics cho Android. Bạn nên sử dụng Firebase Android BoM để kiểm soát việc tạo phiên bản thư viện. 

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.2.0"))

    // Add the dependency for the Analytics library
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-analytics")
}

    Khi sử dụng Firebase Android BoM, ứng dụng của bạn sẽ luôn sử dụng các phiên bản tương thích của thư viện Android trên Firebase.

    (Phương án thay thế) Thêm các phần phụ thuộc của thư viện Firebase mà không sử dụng BoM

    Nếu chọn không sử dụng Firebase BoM, bạn phải chỉ định từng phiên bản thư viện Firebase trong dòng phụ thuộc.

    Lưu ý rằng nếu bạn sử dụng nhiều thư viện Firebase trong ứng dụng của mình, chúng tôi thực sự bạn nên sử dụng BoM để quản lý các phiên bản thư viện. Việc này đảm bảo rằng tất cả các phiên bản đều tương thích. 

    dependencies {
    // Add the dependency for the Analytics library
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-analytics:22.1.0")
}
    Bạn đang tìm một mô-đun thư viện dành riêng cho Kotlin? Bắt đầu sau Tháng 10 năm 2023 (Firebase BoM 32.5.0), cả nhà phát triển Kotlin và Java đều có thể phụ thuộc vào mô-đun thư viện chính (để biết thông tin chi tiết, hãy xem Câu hỏi thường gặp về sáng kiến này).

  2. Khai báo đối tượng com.google.firebase.analytics.FirebaseAnalytics ở đầu hoạt động của bạn:

    Kotlin+KTX 

    private lateinit var firebaseAnalytics: FirebaseAnalytics
    MainActivity.kt

    Java 

    private FirebaseAnalytics mFirebaseAnalytics;
    MainActivity.java

  3. Khởi động biến đó trong phương thức onCreate():

    Kotlin+KTX 

    // Obtain the FirebaseAnalytics instance.
firebaseAnalytics = Firebase.analytics
    MainActivity.kt

    Java 

    // Obtain the FirebaseAnalytics instance.
mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
    MainActivity.java

Bắt đầu ghi nhật ký sự kiện

Sau khi tạo một thực thể FirebaseAnalytics, bạn có thể bắt đầu ghi nhật ký các sự kiện bằng phương thức logEvent().

Một số sự kiện nên dùng cho tất cả các ứng dụng; các phương pháp khác được đề xuất cho các loại hình kinh doanh hoặc ngành dọc cụ thể. Bạn nên gửi các sự kiện được đề xuất cùng với các thông số quy định của sự kiện đó, để đảm bảo tối đa thông tin chi tiết có sẵn trong báo cáo của bạn, cũng như để hưởng lợi từ các tính năng và khi có thể sử dụng. Phần này minh hoạ việc ghi nhật ký một sự kiện được xác định trước, để biết thêm thông tin về các sự kiện ghi nhật ký, hãy xem Ghi nhật ký sự kiện.

Đoạn mã sau đây ghi lại một sự kiện SELECT_CONTENT khi người dùng nhấp vào một thành phần cụ thể trong ứng dụng của bạn.

Kotlin+KTX 

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}
MainActivity.kt

Java 

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);
MainActivity.java

Bạn có thể bật tính năng ghi nhật ký chi tiết để giám sát hoạt động ghi nhật ký các sự kiện của SDK nhằm giúp xác minh rằng các sự kiện đang được ghi lại đúng cách. Điều này tự động bao gồm cả và sự kiện được ghi lại theo cách thủ công.

Bạn có thể bật tính năng ghi nhật ký chi tiết bằng một loạt lệnh adb:

adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

Lệnh này hiển thị các sự kiện của bạn trong logcat của Android Studio, giúp bạn ngay lập tức xác minh rằng sự kiện đang được gửi.

Các bước tiếp theo