Chuẩn bị chạy thử
Dùng một ứng dụng Node.js 18 trở lên và một dự án LogBrew mà bạn có quyền đọc. Nếu bạn chưa từng gửi telemetry, làm theo hướng dẫn Bắt đầu nhanh trước. Tách lần chạy thử này khỏi hoạt động của khách hàng. Cài các gói trong thư mục ứng dụng:LOGBREW_SERVER_API_KEY, không đưa vào hệ thống quản lý mã nguồn. Không bao
giờ đặt khóa phía máy chủ vào bundle trình duyệt. Access token của tài khoản
dùng để đọc kết quả. Token này không dùng để cấu hình SDK.
Xác định ý nghĩa của một sự kiện
Bắt đầu từ một câu hỏi về sản phẩm. Ví dụ: người dùng có gửi đơn thanh toán sau khi mở trang thanh toán không? Đặt cho mỗi sự kiện một tên cố định, một điều kiện kích hoạt chính xác và một vị trí duy nhất trong ứng dụng ghi lại nó.
Giữ tên sự kiện ổn định qua các bản phát hành và các ngôn ngữ. Không tạo tên
từ địa chỉ email, số đơn hàng, URL hoặc văn bản do người dùng nhập.
Dùng thuộc tính tùy chỉnh với một tập nhỏ giá trị đã duyệt. Ví dụ,
checkout_mode có thể là guest hoặc signed_in. Không thêm tên sự kiện mới
cho mỗi giá trị. Không gửi nội dung biểu mẫu.
Chỉ ghi lại mỗi hành động nghiệp vụ ở một nơi. Nếu cả trình duyệt và máy chủ
cùng ghi lại một hành động, tổng số sẽ tăng gấp đôi.
Dùng đúng loại hoạt động
createProductActionAttributes đặt analyticsSchemaVersion: 1 và
analyticsKind: "interaction" trong metadata của sự kiện. Mẫu route (route
template) hoặc tên màn hình mà bạn truyền vào sẽ đặt analyticsSurface. Dùng
mẫu route, như /orders/:id, không dùng URL cụ thể.
Tên sự kiện không quyết định loại. Một tương tác có tên page_view vẫn là
tương tác. Log, vấn đề và span không phải là sự kiện sản phẩm. Với các runtime
khác, xem Tích hợp SDK.
Đặt người dùng và phiên cho từng sự kiện
- Với người dùng đã đăng nhập, đặt
context.subjectthành một ID ổn định vớikind: "user". - Với khách truy cập ẩn danh, dùng một ID riêng với
kind: "anonymous". - Đặt ID phiên của ứng dụng vào
context.session.id. Dùng lại ID này trong suốt phiên.
Chạy ví dụ trên máy cục bộ
Lưu ví dụ này thànhproduct-events.mjs. Ví dụ ghi lại 5 hành động thử nghiệm
qua các lượt truy cập ẩn danh, các lần đăng nhập và 2 người dùng. Client chỉ
giữ ngữ cảnh dịch vụ và triển khai dùng chung. Lần chạy thử này tắt việc tự
động gửi.
--send. Lệnh này không gửi yêu cầu nào:
previewJson() trong ứng dụng có ngữ cảnh khách hàng
thật.
Xử lý đăng nhập và đăng xuất
- Trước khi đăng nhập, gửi chủ thể ẩn danh hiện tại kèm mỗi sự kiện.
- Sau khi đăng nhập, gửi ID ổn định của người dùng với loại
user. - Khi đăng xuất, ngừng dùng ngữ cảnh của người dùng đó. Tạo chủ thể ẩn danh mới theo chính sách quyền riêng tư của bạn.
- Khi chuyển tài khoản, dùng ID của người dùng mới.
Gửi một lần và đọc kết quả
Đặt khóa phía máy chủ của dự án thử nghiệm vào biến môi trường của tiến trình. Chạy lệnh này một lần:- Mở Phân tích.
- Trong Dự án, chọn dự án thử nghiệm.
- Trong Khoảng thời gian, chọn 24 giờ.
- Tìm 3 tên sự kiện trong Sự kiện hàng đầu và
/checkouttrong Trang và màn hình hàng đầu.
- 5 tương tác, tất cả đều có ngữ cảnh phiên, tại trang
/checkout. - 3 sự kiện từ người dùng và 2 sự kiện từ chủ thể ẩn danh.
- 2 người dùng, 2 chủ thể ẩn danh và 4 phiên.
Kiểm tra sự kiện trong ứng dụng của bạn
Chuyển các lệnh gọi ghi nhận vào các handler của ứng dụng. Giữ nguyên ý nghĩa, loại và quy tắc danh tính của từng sự kiện. Kiểm tra bằng tài khoản giả lập trước.
Bản xem trước cục bộ kiểm tra việc ghi nhận. Batch được chấp nhận kiểm tra việc
gửi. Cả hai đều không cho thấy lệnh gọi ghi nhận chạy đúng chỗ trong ứng
dụng của bạn.
