Ghi nhật ký sự kiện

Chọn nền tảng: iOS+ Android Web Flutter Unity C++

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ày. Nếu ứng dụng của bạn cần thu thập thêm dữ liệu, bạn có thể ghi nhật ký 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 nhật ký. Xin lưu ý rằng tên sự kiện có phân biệt chữ hoa chữ thường và việc ghi nhật ký 2 sự kiện có tên chỉ khác nhau về cách viết hoa sẽ dẫn đến 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 phần Bắt đầu sử dụng Analytics.

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

Ghi nhật ký sự kiện

Sau khi tạo một thực thể FirebaseAnalytics, bạn có thể 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, Analytics SDK xác định một số sự kiện được đề xuất thường gặp ở 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ể tìm thấy các phương thức ghi 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ý một 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 cách sử dụ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 quy đị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ể 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 là số và chỉ số tuỳ chỉnh cho mọi dữ liệu thông số được biểu thị bằng số một cách hiệu quả hơn. Sau khi bạn ghi lại một tham số tuỳ chỉnh bằng SDK, hãy đăng ký phương diện hoặc chỉ số để đảm bảo các tham 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 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 thông số tuỳ chỉnh trong các định nghĩa đối tượng có thể được áp dụng cho mọi báo cáo. Các thông số tuỳ chỉnh cũng có trong 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 BigQuery Export của Google Analytics 4.

  • Tham số value: một tham 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.

  • Tên tham số có thể dài tối đa 40 ký tự, phải bắt đầu bằng một ký tự chữ cái và chỉ chứa các ký tự chữ và số cũng như dấu gạch dưới. Hỗ trợ các loại chuỗi và số. Giá trị tham số chuỗi có thể dài tối đa 100 ký tự. Tiền tố "firebase", "google" và "ga_" được 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ó những nhu cầu cụ thể không thuộc loại sự kiện được đề xuất, thì 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ụ này:

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 nhiều 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ư thông số tuỳ chỉnh, hãy đăng ký 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 một khoá thành null sẽ xoá tham số đó. Việc truyền 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 thông số được chỉ định trong phương thức logEvent() hoặc log, thì giá trị đó sẽ được 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.