xStore.analytics
Ghi nhận lượt xem của bất kỳ loại nội dung nào — nguồn dữ liệu cho báo cáo storefront trong trang quản trị.
Phương thức
| Phương thức | Cú pháp | Mô tả | Từ phiên bản |
|---|---|---|---|
recordEntityView |
xStore.analytics.recordEntityView({ entityType, entityId, sessionToken }): Promise<void> |
Ghi nhận một lượt xem (product, article, category…). Gọi rồi quên; không await trong lúc dựng trang phía máy chủ. | 2.1 |
Ví dụ đầy đủ
<script>
// Gọi rồi quên: đừng chặn giao diện chờ nó.
// TUYỆT ĐỐI không await bên trong quá trình dựng trang phía máy chủ —
// nó cộng thêm một vòng mạng vào thời gian trả byte đầu tiên, và một
// lỗi 429 sẽ làm hỏng cả trang vì một thao tác ghi không ai chờ.
xStore.analytics.recordEntityView({
entityType: 'product',
entityId: document.body.dataset.productId,
}).catch(() => { /* số liệu thống kê không được phép làm vỡ trang */ });
</script>
Thư viện gọi tới /api/... trên chính tên miền cửa hàng, nên không cần khai báo địa chỉ máy chủ ở bất kỳ đâu.
Xem thêm Sự kiện để giao diện tự cập nhật sau mỗi thao tác.