Ghi nhật ký sự kiện


Hướng dẫn này chỉ cho bạn cách ghi lại sự kiện trong ứng dụng của mình.

Sự kiện cung cấp thông tin chi tiết về những gì đang xảy ra trong ứng dụng của bạn, chẳng hạn như thông tin về người dùng hành động, sự kiện hệ thống hoặc lỗi.

Analytics tự động ghi lại một số nhật ký sự kiện cho bạn; không bạn cần bổ sung mã bất kỳ để nhận chúng. Nếu ứng dụng của bạn cần thu thập thêm bạn có thể ghi nhật ký lên đến 500 loại Sự kiện Analytics khác nhau trong ứng dụng của mình. Không có giới hạn về tổng số lượng sự kiện mà ứng dụng của bạn ghi lại. Lưu ý rằng sự kiện tên có phân biệt chữ hoa chữ thường và ghi lại hai sự kiện có tên chỉ khác nhau về chữ hoa chữ thường dẫn đến hai sự kiện riêng biệt.

Trước khi bắt đầu

Đảm bảo rằng bạn đã thiết lập dự án và có thể truy cập vào Analytics dưới dạng được mô tả trong Bắt đầu sử dụng Analytics.

Ghi nhật ký sự kiện

Sau khi định cấu hình cho thực thể FirebaseApp, bạn có thể bắt đầu ghi nhật ký sự kiện với logEvent().

Để giúp bạn bắt đầu, SDK Analytics sẽ xác định một số các sự kiện được đề xuất thường thấy của nhiều loại ứng dụng, bao gồm bán lẻ và thương mại điện tử, du lịch và trò chơi. Để tìm hiểu thêm về những sự kiện này và thời điểm sử dụng, hãy xem bài viết Sự kiện được đề xuất.

Bạn có thể tìm thấy thông tin triển khai trong tham chiếu hằng số cho SwiftĐối tượng-C.

Ví dụ sau minh hoạ cách ghi nhật ký Sự kiện kFIRSelectContent:

Swift

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

Objective-C

[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];

Ngoài các thông số quy định, bạn có thể thêm các thông số sau cho bất kỳ sự kiện nào:

  • Thông số tùy chỉnh: Bạn có thể sử dụng thông số tùy chỉnh làm phương diện hoặc chỉ số trong Analytics báo cáo. Bạn có thể sử dụng phương diện tuỳ chỉnh cho dữ liệu thông số sự kiện không phải là số và cho bất kỳ dữ liệu thông số nào được trình bày bằng số tốt hơn. Một lần bạn đã ghi lại một thông số tuỳ chỉnh bằng SDK, hãy đăng ký phương diện hoặc để đảm bảo các thông số tùy chỉnh đó xuất hiện trong Analytics . Thực hiện việc này qua: Analytics > Sự kiện > Quản lý định nghĩa tuỳ chỉnh > Tạo phương diện tuỳ chỉnh

    Có thể sử dụng thông số tùy chỉnh trong đối tượng định nghĩa có thể áp dụng cho mọi báo cáo. Dữ liệu cũng bao gồm các thông số tùy chỉnh được xuất sang BigQuery nếu ứng dụng của bạn được liên kết với dự án BigQuery. Tìm truy vấn mẫu và nhiều tính năng khác tại BigQuery Export của Google Analytics 4.

  • Tham số kFIRParameterValue: kFIRParameterValue là một thông số mục đích chung hữu ích cho việc tích lũy một chỉ số chính liên quan đến một sự kiện. Ví dụ: doanh thu, khoảng cách, thời gian và .

Nếu ứng dụng của bạn có các nhu cầu cụ thể không thuộc phạm vi loại sự kiện, bạn có thể ghi lại sự kiện tuỳ chỉnh của riêng mình như trong ví dụ sau:

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject,
])

Objective-C

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];

Đặt thông số sự kiện mặc định

Bạn có thể ghi nhật ký thông số trên các sự kiện bằng cách sử dụng setDefaultEventParameters. Các thông số mặc định được liên kết với tất cả sự kiện trong tương lai được ghi lại.

Tương tự như với thông số tuỳ chỉnh, hãy đăng ký các thông số sự kiện mặc định để đảm bảo thông số tuỳ chỉnh xuất hiện trong báo cáo Analytics.

Swift

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

Objective-C

[FIRAnalytics setDefaultEventParameters:
  @{
  @"level_name": "Caverns01",
  @"level_difficulty": @(4)
}];

Nếu một thông số được chỉ định trong logEvent() thì giá trị đó sẽ được sử dụng thay cho giá trị mặc định.

Để xoá một tham số mặc định, hãy gọi phương thức setDefaultEventParameters có tham số được đặt thành nil.

Xem các sự kiện trong bảng điều khiển gỡ lỗi của Xcode

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 như sau:

  1. Trong Xcode, hãy chọn Sản phẩm > Lược đồ > Chỉnh sửa lược đồ...
  2. Chọn Run (Chạy) trên trình đơn bên trái.
  3. Chọn thẻ Arguments (Đối số).
  4. Trong phần Đối số đã thông qua khi khởi chạy, hãy thêm -FIRAnalyticsVerboseLoggingEnabled.

Vào lần tiếp theo bạn chạy ứng dụng, các sự kiện của bạn sẽ hiển thị trong bản gỡ lỗi Xcode Play Console, giúp bạn xác minh ngay lập tức rằng các sự kiện đang được gửi đi.

Xem các sự kiện trong trang tổng quan

Bạn có thể xem số liệu thống kê tổng hợp về các sự kiện của mình trong Các trang tổng quan của bảng điều khiển Firebase. Các trang tổng quan này cập nhật định kỳ suốt cả ngày. Để kiểm thử ngay lập tức, hãy sử dụng đầu ra logcat như mô tả trong phần trước.

Bạn có thể truy cập vào dữ liệu này từ Sự kiện trong bảng điều khiển của Firebase. Trang tổng quan này hiển thị các báo cáo sự kiện được tạo tự động cho mỗi loại sự kiện riêng biệt được ghi lại bởi ứng dụng của bạn.