Ghi nhật ký sự kiện

Hướng dẫn này chỉ cho bạn cách ghi lại các 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ư hành động của người dùng, sự kiện hệ thống hoặc lỗi.

Analytics tự động ghi lại một số sự kiện cho bạn; bạn không cần thêm bất kỳ mã nào để nhận chúng. Nếu ứng dụng của bạn cần thu thập thêm dữ liệu, bạn có thể ghi lại tối đa 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 tên sự kiện phân biệt chữ hoa chữ thường và việc ghi hai sự kiện có tên khác nhau chỉ phân biệt chữ hoa chữ thường sẽ 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 của mình và có thể truy cập Analytics như được mô tả trong Bắt đầu với Analytics .

Ghi lại sự kiện

Sau khi định cấu hình phiên bản FirebaseApp , bạn có thể bắt đầu ghi nhật ký sự kiện bằng phương thức logEvent() .

Để giúp bạn bắt đầu, Analytics SDK xác định một số sự kiện được đề xuất phổ biến giữa các loại ứng dụng khác nhau, bao gồm cả ứng dụng 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 chúng, hãy xem Sự kiện được đề xuất .

Bạn có thể tìm thấy chi tiết triển khai trong tài liệu tham khảo hằng số cho Swift và Objective-C .

Ví dụ sau đây minh họa cách ghi nhật ký sự kiện kFIRSelectContent được đề xuất:

Nhanh

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

Mục tiêu-C

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

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

Thông số tùy chỉnh: Thông số tùy chỉnh có thể được sử dụng làm thứ nguyên hoặc số liệu trong báo cáo Analytics . Bạn có thể sử dụng thứ nguyên tùy chỉnh cho dữ liệu thông số sự kiện không phải dạng số và chỉ số tùy chỉnh cho bất kỳ dữ liệu thông số nào được thể hiện bằng số tốt hơn. Khi bạn đã ghi lại thông số tùy chỉnh bằng SDK, hãy đăng ký thứ nguyên hoặc chỉ số để đảm bảo các thông số tùy chỉnh đó xuất hiện trong báo cáo Analytics. Thực hiện việc này thông qua: Analytics > Sự kiện > Quản lý định nghĩa tùy chỉnh > Tạo thứ nguyên tùy chỉnh
Bạn có thể sử dụng thông số tùy chỉnh trong định nghĩa đối tượng để áp dụng cho mọi báo cáo. Thông số tùy chỉnh cũng được đưa vào dữ liệu đượ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 các truy vấn mẫu và nhiều thông tin khác tại Google Analytics 4 BigQuery Xuất .
Tham số kFIRParameterValue : kFIRParameterValue là tham số có mục đích chung, hữu ích để tích lũy số liệu chính liên quan đến một sự kiện. Ví dụ bao gồm doanh thu, khoảng cách, thời gian và điểm.

Nếu ứng dụng của bạn có các nhu cầu cụ thể không được loại sự kiện đề xuất đáp ứng, bạn có thể ghi nhật ký các sự kiện tùy chỉnh của riêng mình như trong ví dụ này:

Nhanh

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

Mục tiêu-C

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

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

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

Giống như các thông số tùy chỉnh, hãy đăng ký các thông số sự kiện mặc định để đảm bảo các thông số tùy chỉnh đó xuất hiện trong báo cáo Analytics.

Nhanh

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

Mục tiêu-C

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

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

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

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

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

Bạn có thể kích hoạt tính năng ghi nhật ký chi tiết như sau:

Trong Xcode, chọn Sản phẩm > Lược đồ > Chỉnh sửa lược đồ...
Chọn Chạy từ menu bên trái.
Chọn tab Đối số .
Trong phần Đối số được truyền khi khởi chạy , hãy thêm -FIRAnalyticsVerboseLoggingEnabled .

Lần tới khi bạn chạy ứng dụng, các sự kiện của bạn sẽ hiển thị trong bảng điều khiển gỡ lỗi Xcode, giúp bạn xác minh ngay lập tức rằng các sự kiện đang được gửi.

Xem sự kiện trong bảng điều khiển

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 trang tổng quan của bảng điều khiển Firebase. Các bảng thông tin này cập nhật định kỳ trong ngày. Để kiểm tra ngay lập tức, hãy sử dụng đầu ra logcat như được mô tả trong phần trước.

Bạn có thể truy cập dữ liệu này từ trang tổng quan Sự kiện trong bảng điều khiển 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 từng loại sự kiện riêng biệt được ứng dụng của bạn ghi lại.