Chuyển đến nội dung chính

Giới thiệu

Ghi lại những gì người dùng và khách của bạn làm, và biến nó thành những trải nghiệm cá nhân hóa.

Thông tin thêm về giao diện người dùng của mô-đun https://doc.oneentry.cloud/docs/category/useractivity

🎯 Mô-đun này làm gì?​

Mô-đun UserActivity cho phép bạn theo dõi các sự kiện hoạt động của người dùng hoặc khách hiện tại - lượt xem sản phẩm, lượt xem trang, tìm kiếm, hành động trong giỏ hàng và danh sách mong muốn, mua hàng và đánh giá.

Các sự kiện bạn gửi sẽ cung cấp dữ liệu cho công cụ gợi ý của OneEntry, điều này hỗ trợ các khối cá nhân hóa như gợi ý cá nhân, đã xem gần đây, mua lại và xu hướng.

🚀 Bắt đầu nhanh​

Khởi tạo mô-đun từ defineOneEntry:


const { UserActivity } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

Ghi lại một sự kiện lượt xem sản phẩm (hoạt động cho người dùng đã xác thực hoặc khách):

// Track that the visitor opened a product page.
const ok = await UserActivity.trackUserActivity({
  type: "product_view",
  productId: 12345,
  meta: { sourceBlock: "catalog" },
});

console.log(ok); // true on success

trackUserActivity() nhận một đối tượng body duy nhất và trả về true khi thành công. Nó là fire-and-forget — không chặn việc hiển thị trên nó.

✨ Khái niệm chính​

Hoạt động cho người dùng và khách​

Hoạt động được gắn với ngữ cảnh hiện tại: một người dùng đã xác thực (thông qua mô-đun AuthProvider) hoặc một khách. Đối với khách, SDK gửi một tiêu đề x-guest-id để các sự kiện được gán cho đúng khách ẩn danh. Xem Chế độ khách để biết thêm chi tiết.

Các loại sự kiện​

Loại sự kiện type là một trong những giá trị cố định: product_view, page_view, category_view, search, product_add_to_cart, product_remove_from_cart, product_add_to_wishlist, product_remove_from_wishlist, product_purchase, product_rating.

📋 Những điều bạn cần biết​

  • Gửi trường phù hợp với hành động: bao gồm productId cho các sự kiện sản phẩm, pageId cho lượt xem trang/danh mục, và query cho các tìm kiếm.
  • Trường meta chấp nhận dữ liệu tùy ý (khối nguồn, biến A/B, độ sâu cuộn) cho phân tích của riêng bạn.
  • trackUserActivity() trả về true khi thành công - nó là fire-and-forget và không nên chặn UI.

📊 Bảng tham khảo nhanh​

Phương thứcMô tả
trackUserActivity()Ghi lại một sự kiện hoạt động của người dùng hoặc khách

❓ Câu hỏi thường gặp (FAQ)​

Tôi có cần xác thực người dùng để theo dõi hoạt động không?​

Không. Hoạt động được ghi lại cho ngữ cảnh hiện tại - một người dùng đã xác thực hoặc một khách. Trong trình duyệt, SDK tự động tạo và duy trì một id khách; trên máy chủ, hãy truyền một guestId cho từng khách.

Trường meta dùng để làm gì?​

meta là một đối tượng tự do cho bất kỳ thông tin bổ sung nào bạn muốn đính kèm vào một sự kiện, chẳng hạn như khối nguồn, một biến thử nghiệm A/B, hoặc độ sâu cuộn.

🎓 Thực hành tốt nhất​

  • Theo dõi các sự kiện khi chúng xảy ra, nhưng đừng chặn việc hiển thị trên cuộc gọi mạng.
  • Gửi productId / pageId / query phù hợp với loại sự kiện type.
  • Giữ cho các id khách ổn định để hoạt động của khách nhất quán qua các yêu cầu.

🔗 Tài liệu liên quan​