Hướng dẫn sử dụng tính năng đồng bộ hành động người dùng lên đa kênh
Back to omnichannelTính năng “Gửi hành động người dùng đến các kênh” giúp hệ thống tự động gửi các hành vi quan trọng của khách truy cập và khách mua hàng sang các nền tảng đo lường/quảng cáo như Facebook, GA4 và TikTok.
Khi được bật, hệ thống sẽ theo dõi các dữ liệu hành vi mới phát sinh, chuyển đổi chúng thành sự kiện phù hợp với từng nền tảng, rồi gửi qua API máy chủ. Cách này giúp dữ liệu đo lường ổn định hơn so với việc chỉ dựa vào mã theo dõi trên trình duyệt.
Các kênh được hỗ trợ
Hệ thống hiện hỗ trợ gửi dữ liệu đến:
| Kênh | Cấu hình cần có |
|---|---|
| Mã Facebook Pixel, access token dùng để gửi sự kiện Pixel | |
| GA4 | Measurement ID, API Secret |
| TikTok | Mã TikTok Pixel, TikTok Access Token |
Nếu hệ thống có nhiều tên miền, mỗi tên miền có thể có cấu hình riêng. Khi một tên miền chưa có cấu hình riêng, hệ thống sẽ dùng cấu hình chung trong trang cài đặt Omnichannel.
Các sự kiện được gửi
Tính năng hiện gửi các nhóm sự kiện sau:
| Hành động trong hệ thống | GA4 | TikTok | |
|---|---|---|---|
| Người dùng xem nội dung/sản phẩm | ViewContent | view_item | Pageview |
| Người dùng thêm sản phẩm vào giỏ | AddToCart | add_to_cart | AddToCart |
| Đơn hàng được thanh toán | Purchase | purchase | Purchase |
Các loại hành động khác nếu không nằm trong danh sách trên sẽ được bỏ qua, không gửi lên kênh ngoài.
Chuẩn bị trước khi bật
Trước khi bật tiến trình đồng bộ, quản trị viên nên kiểm tra các thông tin sau:
- Vào khu vực quản trị Omnichannel, mở trang Cài đặt.
- Kiểm tra phần Facebook Ads:
- Nhập Mã Facebook Pixel.
- Nhập Access token quản trị/truy cập Pixel.
- Bật “Cho phép gửi hành động người dùng đến Facebook” nếu muốn gửi sang Facebook.
- Bấm Lưu.
- Kiểm tra phần GA4:
- Nhập Mã đo lường GA4.
- Nhập Khóa bí mật GA4.
- Bật “Cho phép gửi hành động người dùng đến GA4” nếu muốn gửi sang GA4.
- Bấm Lưu.
- Kiểm tra phần TikTok:
- Nhập Mã TikTok Pixel.
- Nhập TikTok Access token.
- Bật “Cho phép gửi hành động người dùng đến TikTok” nếu muốn gửi sang TikTok.
- Bấm Lưu.
Với các token/secret đã được lưu trước đó, màn hình có thể hiển thị dạng ẩn. Nếu không muốn thay đổi token/secret, giữ nguyên giá trị ẩn đó và chỉ điều chỉnh các trường khác.
Bật tiến trình đồng bộ
Tại đầu trang Cài đặt Omnichannel, tìm dòng “Gửi hành động người dùng đến các kênh”.
Nếu tiến trình đang tắt, bấm Bắt đầu.
Sau khi bật, trang sẽ tải lại và trạng thái nút sẽ thay đổi. Khi tiến trình đang chạy, màn hình sẽ hiển thị các nút Dừng và Khởi động lại.

Dừng hoặc khởi động lại
Bấm Dừng khi muốn tạm ngừng gửi dữ liệu hành động người dùng sang các kênh ngoài. Việc dừng không xóa cấu hình kênh và không xóa vị trí xử lý đã lưu.
Bấm Khởi động lại khi muốn dừng rồi chạy lại tiến trình. Thao tác này hữu ích sau khi vừa thay đổi cấu hình kết nối hoặc nghi ngờ tiến trình cần nạp lại trạng thái mới.
Cơ chế hoạt động cần biết
Tiến trình chạy nền và chỉ xử lý dữ liệu mới. Mỗi vòng, hệ thống lấy tối đa 100 hành động người dùng và tối đa 100 lịch sử đơn hàng mới để xử lý. Sau khi xử lý xong, hệ thống lưu lại vị trí cuối cùng đã đọc để lần sau tiếp tục từ đó.
Nếu bật lần đầu và trước đó chưa từng có vị trí xử lý, hệ thống sẽ bắt đầu từ bản ghi mới sau thời điểm bật, không tự động gửi ngược toàn bộ lịch sử cũ.
Một điểm rất quan trọng: nếu tiến trình đang chạy nhưng một kênh đang bị tắt, dữ liệu đi qua thời điểm đó sẽ bị bỏ qua cho kênh đang tắt. Khi bật kênh lại sau này, hệ thống không tự động gửi bù các sự kiện đã bị bỏ qua. Vì vậy, hãy cấu hình đầy đủ và bật các kênh cần dùng trước khi bật tiến trình đồng bộ.
Dữ liệu được gửi kèm
Tùy từng hành động, hệ thống có thể gửi các thông tin sau sang nền tảng ngoài:
- Loại sự kiện: xem nội dung, thêm vào giỏ, mua hàng.
- Thông tin sản phẩm: mã sản phẩm, tên sản phẩm, danh mục, giá, số lượng, tổng giá trị, tiền tệ.
- Thông tin đơn hàng khi phát sinh sự kiện mua hàng.
- Đường dẫn trang sản phẩm nếu xác định được tên miền và đường dẫn hợp lệ.
- IP, trình duyệt/người dùng đại diện.
- Email, số điện thoại hoặc mã định danh người dùng nếu người dùng đã đăng nhập hoặc đơn hàng có người tạo hợp lệ.
Với đơn hàng, hệ thống chỉ gửi sự kiện mua hàng khi đơn hàng chuyển sang trạng thái đã thanh toán.
Lưu ý vận hành
Hãy kiểm tra kỹ mã Pixel, Measurement ID, API Secret và Access Token trước khi bật. Nếu cấu hình sai, hệ thống có thể không gửi được sự kiện và các bản ghi đã đi qua có thể không được tự động gửi lại.
Nếu website chạy nhiều tên miền, nên kiểm tra cấu hình theo từng tên miền trước. Tên miền có cấu hình riêng sẽ dùng cấu hình riêng; tên miền không có cấu hình riêng sẽ dùng cấu hình chung.
Không nên bật tiến trình trước rồi mới bật từng kênh sau, vì dữ liệu phát sinh trong khoảng thời gian kênh chưa được cho phép gửi sẽ không được gửi bù.
Kiểm tra sau khi bật
Sau khi bật, quản trị viên có thể kiểm tra trên các nền tảng tương ứng:
- Facebook Events Manager để xem sự kiện Pixel/Conversions API.
- GA4 DebugView hoặc báo cáo sự kiện để xem
view_item,add_to_cart,purchase. - TikTok Events Manager để xem sự kiện Pixel/Conversions API.
Nên tạo một vài thao tác thử như xem sản phẩm, thêm vào giỏ, thanh toán đơn hàng thử, sau đó đối chiếu sự kiện trên từng nền tảng đã bật.