Hướng dẫn này cho bạn biết cách ghi lại sự kiện trong ứng dụng.
Analytics sẽ tự động ghi lại nhật ký của 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 loại Sự kiện Analytics khác nhau trong ứng dụng. 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. Khi bạn ghi lại hai sự kiện có tên chỉ khác nhau về cách viết hoa viết thường, hệ thống sẽ ghi nhận đó là 2 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 như mô tả trong bài viết Bắt đầu sử dụng Analytics.
Ghi nhật ký sự kiện
Sau khi tạo một thực thể FirebaseAnalytics, bạn có thể sử dụng thực thể đó để ghi lại các sự kiện bằng các phương thức log của thư viện.
Sự kiện được xác định trước
Để giúp bạn bắt đầu, SDK Analytics xác định một số sự kiện được đề xuất phổ biến 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ề các 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 các phương thức nhật ký cho các loại sự kiện được đề xuất trong tài liệu tham khảo API.
Ví dụ sau đây minh hoạ cách ghi nhật ký sự kiện select_content:
await FirebaseAnalytics.instance.logSelectContent(
contentType: "image",
itemId: itemId,
);
Ngoài ra, bạn có thể ghi lại cùng một sự kiện bằng logEvent():
await FirebaseAnalytics.instance.logEvent(
name: "select_content",
parameters: {
"content_type": "image",
"item_id": itemId,
},
);
Điều này có thể hữu ích nếu bạn muốn chỉ định các tham số bổ sung ngoài các tham số được chỉ định (bắt buộc). Bạn có thể thêm các thông số sau vào bất kỳ sự kiện nào:
Tham số tuỳ chỉnh: Bạn có thể sử dụng tham số tuỳ chỉnh làm phương diện hoặc chỉ số trong báo cáo Analytics. 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 số và chỉ số tuỳ chỉnh cho mọi dữ liệu thông số được thể hiện tốt hơn bằng số. Sau khi 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 chỉ số để đảm bảo các thông số tuỳ chỉnh đó xuất hiện trong báo cáo Analytics. Bạn có thể làm việc này bằng cách sử dụng đường dẫn Analytics > Sự kiện > Quản lý định nghĩa tuỳ chỉnh > Tạo phương diện tuỳ chỉnh.
Bạn có thể sử dụng các 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. Các 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. Hãy xem các truy vấn mẫu và nhiều thông tin khác tại bài viết BigQuery Export của Google Analytics 4.
Tham số
value: một tham số dùng cho nhiều mục đích, rất hữu ích để 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.Tên tham số có thể dài tối đa 40 ký tự và phải bắt đầu bằng một ký tự chữ cái, đồng thời chỉ được chứa ký tự chữ và số, dấu gạch dưới. Hỗ trợ các loại chuỗi và số. Giá trị thông số chuỗi có thể dài tối đa 100 ký tự. Tiền tố "firebase", "google" và "ga_" là tiền tố dành riêng và không được dùng cho tên tham số.
Sự kiện tùy chỉnh
Nếu ứng dụng của bạn có nhu cầu cụ thể không được đề cập trong loại sự kiện được đề xuất, bạn có thể ghi nhật ký các sự kiện tuỳ chỉnh của riêng mình như trong ví dụ sau:
await FirebaseAnalytics.instance.logEvent(
name: "share_image",
parameters: {
"image_name": name,
"full_text": text,
},
);
Đặ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 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.
Cũng 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 các thông số đó xuất hiện trong báo cáo Analytics.
Các giá trị tham số hợp lệ là String và num. Việc đặt giá trị của khoá thành null sẽ xoá tham số đó. Việc truyền một giá trị rỗng sẽ xoá tất cả các tham số.
// Not supported on web
await FirebaseAnalytics.instance
.setDefaultEventParameters({
version: '1.2.3'
});
Nếu một tham số được chỉ định trong phương thức logEvent() hoặc log, 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() với tham số được đặt thành null.
Xem 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 bảng 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ỳ trong 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ừ trang tổng quan Sự kiện trong bảng điều khiển Firebase. 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.