Giới thiệu
Đăng ký nhận thông báo và cập nhật liên quan đến sản phẩm.
🔐 Phương pháp này yêu cầu ủy quyền.
Mô-đun này làm gì?
Mô-đun Events cho phép bạn đăng ký người dùng nhận thông báo về sản phẩm - như nhận email khi sản phẩm có hàng trở lại, hoặc thông báo khi giá giảm.
Hãy nghĩ về nó như một hệ thống đăng ký sản phẩm - người dùng có thể đăng ký các sản phẩm cụ thể và nhận thông báo khi có sự thay đổi.
Giải thích đơn giản
Hãy tưởng tượng bạn đang điều hành một cửa hàng trực tuyến và muốn giữ cho người dùng được thông báo về các sản phẩm:
- Sản phẩm có hàng trở lại - Thông báo cho người dùng đang chờ đợi mặt hàng này
- Giá giảm - Cảnh báo người dùng đang theo dõi sản phẩm này
- Sản phẩm mới được thêm vào - Thông báo cho những người đăng ký trong một danh mục cụ thể
- Cảnh báo hàng tồn kho hạn chế - Thông báo cho người dùng quan tâm trước khi sản phẩm hết hàng
Thay vì theo dõi thủ công ai muốn gì:
- Cấu hình sự kiện sản phẩm trong bảng điều khiển quản trị OneEntry
- Người dùng đăng ký các sản phẩm mà họ quan tâm
- Thông báo tự động khi có sự thay đổi
- Quản lý tất cả các đăng ký ở một nơi
Ví dụ thực tế:
Không có Mô-đun Events (thủ công):
- Người dùng muốn nhận thông báo khi có hàng → Mã theo dõi tùy chỉnh
- Giá sản phẩm giảm → Logic thông báo thủ công
- Mỗi sản phẩm cần xử lý riêng biệt
Với Mô-đun Events (tự động):
- Người dùng đăng ký sản phẩm → Tự động lưu trữ
- Sản phẩm có hàng trở lại → Tất cả người đăng ký được thông báo
- Tất cả các đăng ký được quản lý tập trung
Khái niệm chính
Sự kiện sản phẩm là gì?
Một sự kiện sản phẩm là một thông báo được kích hoạt bởi sự thay đổi của một sản phẩm:
- Kích hoạt - Điều gì xảy ra với sản phẩm (ví dụ: "có hàng trở lại")
- Thông báo - Những gì người đăng ký nhận được (email, thông báo đẩy, tin nhắn socket)
- Người đăng ký - Người dùng đã chọn nhận cập nhật cho sản phẩm này
- Mẫu - Nội dung thông điệp thông báo
Kênh thông báo
Ba cách để thông báo cho người đăng ký:
| Kênh | Mô tả | Tốt nhất cho |
|---|---|---|
| Gửi tin nhắn email | Thông báo có hàng trở lại, giá giảm, bản tin | |
| Thông báo đẩy | Thông báo trên di động/trình duyệt | Thông báo khẩn cấp, giảm giá flash |
| Socket.IO | Tin nhắn websocket thời gian thực | Cập nhật hàng tồn kho trực tiếp, đồng bộ giá ngay lập tức |
| Tích hợp | Tin nhắn tích hợp | Quy trình thông báo tùy chỉnh |
Đọc thêm về Tích hợp
Ví dụ về luồng sự kiện
1. Người dùng đăng ký một sản phẩm
↓
2. Trạng thái sản phẩm thay đổi (có hàng trở lại, thay đổi giá, v.v.)
↓
3. Sự kiện phát hiện sự thay đổi
↓
4. Sự kiện gửi thông báo đến tất cả người đăng ký
↓
5. Người đăng ký nhận được thông điệp
Những điều bạn cần biết
Các kích hoạt sự kiện sản phẩm phổ biến
Các sự kiện sản phẩm điển hình mà bạn có thể thiết lập:
- Sản phẩm có hàng trở lại
- Cảnh báo giá giảm
- Cảnh báo hàng tồn kho thấp
- Sản phẩm ngừng cung cấp
- Biến thể mới có sẵn
- Ưu đãi đặc biệt cho sản phẩm
Đọc thêm về Kích hoạt sự kiện.
Biến mẫu
Sử dụng các biến giữ chỗ trong các mẫu thông báo để bao gồm chi tiết sản phẩm như tên, giá và tình trạng sẵn có.
Bảng tham khảo nhanh - Các phương pháp phổ biến
| Phương pháp | Chức năng |
|---|---|
| getAllSubscriptions() | Lấy tất cả các đăng ký sản phẩm |
| subscribeByMarker() | Đăng ký một sự kiện sản phẩm theo dấu hiệu |
| unsubscribeByMarker() | Hủy đăng ký một sự kiện sản phẩm theo dấu hiệu |
Lưu ý: Các sự kiện được cấu hình trong bảng điều khiển quản trị OneEntry. SDK quản lý các đăng ký - sử dụng nó để đăng ký/hủy đăng ký người dùng từ các sự kiện sản phẩm.
Câu hỏi thường gặp (FAQ)
Làm thế nào để tôi tạo hoặc chỉnh sửa các sự kiện sản phẩm?
Các sự kiện được quản lý trong bảng điều khiển quản trị của OneEntry:
- Đăng nhập vào quản trị OneEntry
- Đi đến phần Sự kiện
- Tạo hoặc chỉnh sửa các sự kiện sản phẩm
- Cấu hình các kích hoạt, kênh và mẫu
- Kích hoạt sự kiện
Sự khác biệt giữa Thông báo đẩy và Socket.IO là gì?
Thông báo đẩy - Gửi đến thiết bị (hoạt động ngay cả khi ứng dụng đã đóng)
- Xuất hiện trong trung tâm thông báo
- Người dùng có thể chạm để mở ứng dụng
- Tốt nhất cho: Thông báo có hàng trở lại, giá giảm
Socket.IO - Tin nhắn websocket thời gian thực (chỉ khi ứng dụng đang mở)
- Giao hàng ngay lập tức đến các khách hàng kết nối
- Cập nhật trực tiếp mà không cần làm mới
- Tốt nhất cho: Hiển thị hàng tồn kho trực tiếp, cập nhật giá thời gian thực
Tôi có thể kích hoạt thủ công một sự kiện sản phẩm từ mã của mình không?
SDK không hỗ trợ các kích hoạt thủ công. Các sự kiện tự động được kích hoạt dựa trên các kích hoạt đã cấu hình trong OneEntry khi dữ liệu sản phẩm thay đổi.
Tôi có thể tùy chỉnh các mẫu thông báo không?
Có! Trong bảng điều khiển quản trị OneEntry:
- Mẫu email HTML
- Tùy chỉnh kiểu dáng
- Hỗ trợ đa ngôn ngữ
- Các biến cụ thể cho sản phẩm
Lưu ý quan trọng
Quy ước đặt tên sự kiện
Sử dụng các dấu hiệu rõ ràng, mô tả cho các sự kiện sản phẩm:
Dấu hiệu tốt:
- product_back_in_stock
- product_price_drop
- product_low_stock
- product_new_variant
- product_discontinued
Dấu hiệu xấu:
- event1
- notification
- product_event
- test
Thực hành tốt nhất
- Sử dụng các dấu hiệu sự kiện mô tả bao gồm "sản phẩm"
- Bao gồm các chi tiết sản phẩm liên quan trong các mẫu thông báo
- Địa phương hóa các thông điệp sự kiện cho các thị trường khác nhau
- Xử lý lỗi đăng ký một cách nhẹ nhàng
- Cho phép người dùng dễ dàng hủy đăng ký
Thêm thông tin về giao diện người dùng của mô-đun https://doc.oneentry.cloud/docs/events/introduction
Định nghĩa của mô-đun Events
const { Events } = defineOneEntry( "your-project-url", { "token": "your-app-token" });
Tài liệu liên quan
- Mô-đun Sản phẩm - Quản lý các sản phẩm kích hoạt sự kiện
- Mô-đun Người dùng - Quản lý người dùng đăng ký nhận thông báo