trackUserActivity

Ghi lại một sự kiện hoạt động của người dùng hoặc khách.

Mô tả

Phương thức này ghi lại một sự kiện hoạt động đơn lẻ cho người dùng hoặc khách hiện tại (ví dụ: xem sản phẩm, tìm kiếm hoặc hành động trong giỏ hàng). Nó trả về một Promise mà sẽ giải quyết thành true nếu sự kiện được ghi lại, hoặc một đối tượng IError nếu có vấn đề xảy ra.

UserActivity.trackUserActivity(

body*, body.type*, body.productId, body.pageId, body.categoryId, body.query, body.meta

);

Sơ đồ tham số

Sơ đồ

body(bắt buộc): ITrackActivity
Nội dung sự kiện hoạt động. Ví dụ: { type: "product_view", productId: 12345 }

body.type(bắt buộc): TUserActivityType
Loại sự kiện hoạt động. Một trong các loại: "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".
ví dụ: "product_view"

body.productId: number
Định danh sản phẩm.
ví dụ: 12345

body.pageId: number
Định danh trang (đối với page_view, category_view).
ví dụ: 7

body.categoryId: number
Định danh danh mục cũ.
ví dụ: 67

body.query: string
Truy vấn tìm kiếm (đối với type=search).
ví dụ: "iphone case"

body.meta: Record<string, unknown>
Thông tin meta tùy ý (khối nguồn, biến A/B, độ sâu cuộn).

Ví dụ

Ví dụ tối thiểu

const response = await UserActivity.trackUserActivity({
  type: 'product_view',
  productId: 12345,
});

Ví dụ với các thuộc tính

const response = await UserActivity.trackUserActivity({
  type: 'search',
  query: 'iphone case',
  meta: { sourceBlock: 'header_search', variant: 'b' },
});

Phản hồi ví dụ

true

Sơ đồ phản hồi

Sơ đồ: boolean

boolean: boolean
Trả về true nếu sự kiện được ghi lại.
ví dụ: true

---