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ế:

Without Events Module (manual):
- User wants restock alert → Custom tracking code
- Product price drops → Manual notification logic
- Each product needs separate handling

With Events Module (automated):
- User subscribes to product → Stored automatically
- Product restocked → All subscribers notified
- All subscriptions managed centrally

Các 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
Email	Gửi tin nhắn email	Cảnh báo có hàng trở lại, giá giảm, bản tin
Thông báo đẩy	Cảnh báo trên di động/trình duyệt	Cảnh báo khẩn cấp, bán hàng chớp nhoáng
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. User subscribes to a product
   ↓
2. Product status changes (restocked, price change, etc.)
   ↓
3. Event detects the change
   ↓
4. Event sends notifications to all subscribers
   ↓
5. Subscribers receive the message

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ý nhận sự kiện sản phẩm theo dấu hiệu
unsubscribeByMarker()	Hủy đăng ký nhận 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 khỏi 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 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:

1. Đăng nhập vào quản trị OneEntry
2. Đi đến phần Sự kiện
3. Tạo hoặc chỉnh sửa sự kiện sản phẩm
4. Cấu hình các kích hoạt, kênh và mẫu
5. 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: Cảnh 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 được kích hoạt tự động 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:

Good markers:
- product_back_in_stock
- product_price_drop
- product_low_stock
- product_new_variant
- product_discontinued

Bad markers:
- 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ông tin thêm 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

---