Nhảy đến nội dung

Giới thiệu

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

Thêm thông tin 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 truy cập 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á.

Hãy coi đây là tín hiệu phân tích đứng sau việc cá nhân hóa - 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 như gợi ý cá nhân, đã xem gần đây, mua lại và xu hướng.

📖 Giải thích đơn giản​

Mỗi khi một khách truy cập thực hiện điều gì đó có ý nghĩa, bạn ghi lại một sự kiện:

  • 👀 Lượt xem sản phẩm - khách truy cập đã mở một trang sản phẩm
  • 📄 Lượt xem trang / danh mục - khách truy cập đã duyệt một trang hoặc danh mục
  • 🔎 Tìm kiếm - khách truy cập đã tìm kiếm một cái gì đó
  • 🛒 Hành động trong giỏ hàng / danh sách mong muốn - các mục đã được thêm hoặc xóa
  • 💰 Mua hàng - khách truy cập đã mua một sản phẩm
  • ⭐ Đánh giá - khách truy cập đã đánh giá một sản phẩm

OneEntry sử dụng dòng sự kiện này để hiểu mỗi khách truy cập và cá nhân hóa những gì họ thấy.

✨ 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 đã được ủy quyền (thông qua mô-đun AuthProvider) hoặc một khách truy cập. Đối với khách, SDK gửi một tiêu đề x-guest-id để các sự kiện được gán cho khách truy cập ẩn danh đúng. 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 sự kiện 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à phương thức không chặn và không nên làm chậm giao diện người dùng.

📊 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 truy cập

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

Tôi có cần ủy quyền 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 đã được ủy quyền hoặc một khách truy cập. 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 truy cập.

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.

Định nghĩa mô-đun UserActivity​


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

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