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

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*

);

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.
ví dụ: "product_view"

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

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

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

body.query: chuỗi
Câu 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

Details

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