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ế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 phân tích 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. Khi bạn ghi nhật ký 2 sự kiện có tên giống nhau và chỉ khác ở 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 bạn đã thiết lập dự án và có thể truy cập vào Analytics như mô tả trong 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ể sử dụng thực thể đó để ghi nhật ký 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ý sự kiện select_content:

await FirebaseAnalytics.instance.logSelectContent(
    contentType: "image",
    itemId: itemId,
);

Ngoài ra, bạn có thể ghi nhật ký 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 khác ngoài các tham số được quy định (bắt buộc). Bạn có thể thêm các tham 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 tham số sự kiện không phải dạng số và chỉ số tuỳ chỉnh cho mọi dữ liệu tham số được biểu diễn bằng dạng số tốt hơn. Sau khi ghi nhật ký 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. Hãy thực hiện 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 tham số tuỳ chỉnh trong định nghĩa đối tượng có thể được áp dụng cho mọi báo cáo. Tham 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.

  • 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ố, 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ự. Các 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ể mà một loại sự kiện được đề xuất không đáp ứng được, 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ụ sau:

await FirebaseAnalytics.instance.logEvent(
    name: "share_image",
    parameters: {
        "image_name": name,
        "full_text": text,
    },
);

Đặt tham số sự kiện mặc định

Bạn có thể ghi nhật ký các tham số trên 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 trong tương lai được ghi nhật ký.

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

Các giá trị tham số hợp lệ là Chuỗi và số. Việc đặt giá trị của 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 tham số được chỉ định trong logEvent() hoặc phương thức log- thì giá trị đó sẽ được sử dụng thay vì 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.