Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

Bắt đầu với Google Analytics

Phần khởi động nhanh này chỉ cho bạn cách thêm Google Analytics vào ứng dụng của bạn và bắt đầu ghi nhật ký các sự kiện.

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

  • Sự kiện: Điều 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, các sự kiện hệ thống, hoặc sai sót.
  • User Properties: Các thuộc tính bạn xác định để mô tả các phân đoạn của cơ sở người dùng của bạn, chẳng hạn như ngôn ngữ ưu tiên hoặc vị trí địa lý.

Analytics tự động đăng nhập một số sự kiệntính chất sử dụng ; bạn không cần thêm bất kỳ mã nào để kích hoạt chúng.

Trước khi bắt đầu

Nếu bạn chưa sẵn sàng, thêm căn cứ hỏa lực cho dự án Android của bạn và chắc chắn rằng Google Analytics được kích hoạt trong dự án căn cứ hỏa lực 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 quá trình tạo dự án.

  • Nếu bạn đang sử dụng một dự án căn cứ hỏa lực hiện có mà không có kích hoạt Google Analytics, đi đến Tích hợp tab của bạn > Cài đặt Project để kích hoạt nó.

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

Thêm SDK Analytics vào ứng dụng của bạn

  1. Sử dụng các căn cứ hỏa lực Android HĐQT , kê khai phụ thuộc cho các thư viện Android Analytics trong module của bạn (ứng dụng cấp) tập tin Gradle (thường là app/build.gradle ).

    Java

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:28.4.1')
    
        // Declare 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'
    }
    

    Bằng việc sử dụng căn cứ hỏa lực Android HĐQT , ứng dụng của bạn sẽ luôn luôn sử dụng các phiên bản tương thích của các thư viện căn cứ hỏa lực Android.

    (Alternative) Khai báo căn cứ hỏa lực phụ thuộc thư viện mà không sử dụng HĐQT

    Nếu bạn 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 của nó.

    Lưu ý rằng nếu bạn sử dụng nhiều thư viện căn cứ hỏa lực trong ứng dụng của bạn, chúng tôi khuyên bạn nên sử dụng HĐQT để quản lý các phiên bản thư viện, đảm bảo rằng tất cả các phiên bản tương thích.

    dependencies {
        // Declare 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:19.0.1'
    }
    

    Kotlin + KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:28.4.1')
    
        // Declare 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-ktx'
    }
    

    Bằng việc sử dụng căn cứ hỏa lực Android HĐQT , ứng dụng của bạn sẽ luôn luôn sử dụng các phiên bản tương thích của các thư viện căn cứ hỏa lực Android.

    (Alternative) Khai báo căn cứ hỏa lực phụ thuộc thư viện mà không sử dụng HĐQT

    Nếu bạn 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 của nó.

    Lưu ý rằng nếu bạn sử dụng nhiều thư viện căn cứ hỏa lực trong ứng dụng của bạn, chúng tôi khuyên bạn nên sử dụng HĐQT để quản lý các phiên bản thư viện, đảm bảo rằng tất cả các phiên bản tương thích.

    dependencies {
        // Declare 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-ktx:19.0.1'
    }
    

  2. Khai báo com.google.firebase.analytics.FirebaseAnalytics đối tượng ở phía trên cùng của hoạt động của bạn:

    Java

    private FirebaseAnalytics mFirebaseAnalytics;

    Kotlin + KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics
  3. Khởi tạo nó trong onCreate() phương pháp:

    Java

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

    Kotlin + KTX

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

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

Sau khi bạn đã tạo ra một FirebaseAnalytics Ví dụ, bạn có thể bắt đầu đăng nhập sự kiện với logEvent() phương pháp.

Một số sự kiện được đề nghị cho tất cả các ứng dụng ; những người 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ố được chỉ định của chúng, để đảm bảo thông tin chi tiết có sẵn tối đa trong báo cáo của bạn và để hưởng lợi từ các tính năng và tích hợp trong tương lai khi chúng có sẵn. Phần này chứng tỏ một sự kiện đăng nhập được xác định trước, để biết thêm thông tin về các sự kiện đăng nhập, xem Log sự kiện .

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

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

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

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

Bạn có thể bật verbose đăng nhập với một loạt các adb lệnh:

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 Android Studio, giúp bạn xác minh ngay rằng các sự kiện đang được gửi.

Bước tiếp theo