Ghi nhật ký sự kiện

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, các sự kiện của hệ thống hoặc lỗi.

Analytics sẽ tự động ghi lại một số sự kiện cho bạn; bạn không cần thêm mã nào để nhận các sự kiện đó. 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 Analytics Sự kiện loại 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. Xin lưu ý rằng tên sự kiện có phân biệt chữ hoa chữ thường và việc ghi lại hai sự kiện có tên chỉ khác nhau về cách viết hoa chữ thường sẽ dẫn đến hai sự kiện riêng biệt.

Trước khi bắt đầu

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

Nếu bạn muốn thu thập dữ liệu phân bổ cho chiến dịch, hãy nhớ thêm khung AdSupport vào dự án của mình.

Ghi nhật ký sự kiện

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

Để giúp bạn bắt đầu, SDK Analytics xác định một số sự kiện được đề xuất thường gặp trong nhiều loại ứng dụng, 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, hãy xem bài viết Sự kiện được đề xuất.

Bạn có thể xem thông tin chi tiết về cách triển khai trong tài liệu tham khảo về hằng số cho Swift và Objective-C.

Ví dụ sau đây minh hoạ cách ghi lại sự kiện kFIRSelectContent được đề xuất:

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

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

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

• Thông số tuỳ chỉnh: Bạn có thể sử dụng thông số tuỳ 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 dạng số và chỉ số tuỳ chỉnh cho mọi dữ liệu thông số được biểu diễn bằng dạng số. Sau khi ghi lại một thông số tuỳ chỉnh bằng SDK, hãy đăng ký phương diện hoặc chỉ số để đảm bảo các thông số tuỳ chỉnh đó xuất hiện trong báo cáo Analytics. Để thực hiện việc này, trong bảng điều khiển Firebase, hãy chuyển đến phần Analytics > Định nghĩa tuỳ chỉnh.

  Bạn có thể sử dụng thông số tuỳ chỉnh trong định nghĩa đối tượng có thể áp dụng cho mọi báo cáo. Thông số tuỳ 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 một 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 Export.

• Thông số kFIRParameterValue: kFIRParameterValue là một thông số đa năng hữu ích cho việc tích luỹ 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à điểm.

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

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

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

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

Bạn có thể ghi lại các 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ả các sự kiện trong tương lai được ghi lại.

Tương tự như thông số tuỳ 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ố tuỳ chỉnh đó xuất hiện trong báo cáo Analytics.

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

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

Nếu một thông 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.

Để xoá một thông số mặc định, hãy gọi phương thức setDefaultEventParameters với thông 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 để theo dõi việc ghi nhật ký sự kiện của 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 nhật ký tự động và 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, chọn Product > Scheme > Edit scheme... (Sản phẩm > Lược đồ > Chỉnh sửa lược đồ)
2. Chọn Run (Chạy) trong trình đơn bên trái.
3. Chọn thẻ Arguments (Đối số).
4. Trong phần Arguments Passed On Launch (Đối số được truyền 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 sẽ xuất hiện trong bảng điều khiển gỡ lỗi của Xcode, giúp bạn xác minh ngay rằng các sự kiện đang được gửi.

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

Trong bảng điều khiển Firebase, bạn có thể xem số liệu thống kê tổng hợp về các sự kiện trong trang tổng quan Analytics > Events.

Xin lưu ý những điều sau về trang tổng quan này:

• Trang tổng quan này cho thấy 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 mà ứng dụng của bạn ghi lại.

• Trang tổng quan này được cập nhật định kỳ trong suốt cả ngày. Để kiểm thử ngay, hãy sử dụng đầu ra của bảng điều khiển gỡ lỗi Xcode như mô tả trong phần trước của hướng dẫn này.