On this page
Dữ liệu vào MSO Cloud qua một khung chung: mỗi kết nối thuộc đúng một họ, mỗi họ thuộc đúng một mặt phẳng dữ liệu, và hai mặt phẳng không bao giờ trộn số với nhau.
Đối tượng: quản trị viên tổ chức chọn nguồn dữ liệu, và người đọc số muốn biết một con số đến từ đâu. Cần đọc trước: Tổng quan sản phẩm.
Năm mặt phẳng dữ liệu#
Mặt phẳng là câu trả lời cho câu hỏi "số này là dữ liệu của ai". Nó quyết định số đó có được đối soát không, có được trợ lý AI trả lời không, và có được dùng làm kết quả đo của một quyết định không.
| Mặt phẳng | Họ kết nối | Dữ liệu của ai | Được đối soát | Làm kết quả đo được |
|---|---|---|---|---|
| Sàn thương mại | marketplace |
chính tổ chức, từ shop của tổ chức | có | có |
| Marketing | marketing |
chính tổ chức, từ tài khoản của tổ chức | có | có |
| Thị trường bên thứ ba | market_intel |
ước tính của nhà cung cấp ngoài | không | không |
| Bộ dữ liệu tổ chức | dataset |
chính tổ chức, từ hệ thống nội bộ | có | có |
| Thảo luận khách hàng | content_intel |
corpus khách hàng duyệt cho từng dự án | có | không |
Sàn thương mại
Đơn hàng, tồn kho, creator và doanh thu affiliate lấy thẳng từ tài khoản người bán của tổ chức. Đây là mặt phẳng tiền: mọi chỉ số ở đây nằm trong cổng đối soát tự động, đối chiếu với một nguồn sự thật giữ ngoài mã nguồn.
Marketing
Chi tiêu quảng cáo, hành vi web, dữ liệu tìm kiếm, email và lead — vẫn là dữ liệu bậc một, nhưng của một hệ thống khác và một đơn vị đo khác. Nó không cộng vào doanh thu sàn và không thay thế doanh thu sàn; một tổ chức chạy cả hai vẫn đọc hai mặt phẳng riêng. Nền của họ này là quyết định kiến trúc ADR 0008.
Thị trường bên thứ ba
Ước tính ngành hàng, đối thủ, creator và sản phẩm do nhà cung cấp dữ liệu ngoài tính. Mọi số ở đây mang nhãn ước tính, nằm ngoài cổng đối soát (không có sự thật bên ngoài để đối chiếu), không bao giờ là KPI bậc một và không bao giờ là kết quả đo của một quyết định. Nó dùng để đặt giả thuyết, không dùng để kết luận.
Bộ dữ liệu tổ chức
Số liệu vận hành nội bộ — nhân sự, tài chính, kho vận — đến từ bảng tính hoặc từ hệ thống nội bộ (ERP, HRM) qua một hợp đồng kết nối riêng (ADR 0049). Khác với bốn họ còn lại, lược đồ ở đây do chính tổ chức khai báo chứ không phải do nền tảng định sẵn; xem Bộ dữ liệu và chỉ số.
Thảo luận khách hàng
Corpus thảo luận đã được khách hàng duyệt, dùng cho các deck Content Intelligence. Họ content_intel đã có trong mô hình nhưng chưa có kết nối API nào thuộc họ này: corpus vào hệ thống qua đường tải lên file và cấu hình mapping.
Một kết nối hoạt động thế nào#
- Thêm ở màn hình Kết nối (
/connectors), chỉ chủ sở hữu và quản trị viên tổ chức. - Khoá bí mật được mã hoá ngay khi lưu và không hiển thị lại; sửa nghĩa là dán khoá mới đè lên.
- Bấm Kiểm tra để gọi một API đọc nhẹ, xác nhận khoá dùng được. Kiểm tra xanh chứng minh quyền đọc, chưa chứng minh dữ liệu lịch sử đã về đủ.
- Đồng bộ chạy theo lịch của từng kết nối và luôn kéo lùi một cửa sổ ngày, vì nguồn tự điều chỉnh số sau khi công bố.
- Mỗi kết nối gắn với một thương hiệu. Tổ chức chưa có thương hiệu thì không giữ được kết nối nào — xem Đa thương hiệu.
- Một kết nối chỉ xuất hiện trong danh mục khi tính năng tương ứng đang bật cho tổ chức. Một workspace không chạy bán hàng thì cả nhóm kết nối sàn biến mất khỏi danh mục, không chỉ bị ẩn khỏi menu.
Danh mục kết nối#
Cột Trạng thái nói đúng mức sẵn sàng hôm nay: chạy = có trình đồng bộ theo lịch; chưa có trình đồng bộ = tạo được khoá nhưng chưa có job nào nạp dữ liệu; chưa mở = mới là thẻ trong danh mục; đang ngừng = đã có đường thay thế và bản ghi cũ đang được gỡ.
| Kết nối | Họ | Nạp gì | Phục vụ mảng | Trạng thái |
|---|---|---|---|---|
| TikTok Shop | marketplace | đơn hàng, creator | eCom | chạy |
| Shopee | marketplace | đơn hàng, tồn kho | eCom | chạy |
| Lazada | marketplace | đơn hàng, tồn kho | eCom | chạy |
| Shopee · CSV | marketplace | đơn hàng, từ file export | eCom | chạy |
| Lazada · CSV | marketplace | đơn hàng, từ file export | eCom | chạy |
| TikTok Affiliate | marketplace | — | eCom | chưa có trình đồng bộ |
| Warehouse | marketplace | — | eCom | chưa có trình đồng bộ |
| Google Sheets | marketing | chi tiêu, kế hoạch ngân sách, chỉ tiêu, tab bộ dữ liệu | nhiều mảng | chạy |
| Google Ads | marketing | chi tiêu quảng cáo | Marketing | chạy |
| Meta Ads | marketing | chi tiêu quảng cáo | Marketing | chạy |
| TikTok Ads | marketing | chi tiêu quảng cáo | Marketing | chạy |
| Shopee Ads | marketing | chi tiêu quảng cáo | Marketing | chạy |
| Google Analytics 4 | marketing | phiên, người dùng, trang, nguồn truy cập | Marketing | chạy |
| Google Search Console | marketing | truy vấn, trang, hiển thị và nhấp từ tìm kiếm | Marketing | chạy |
| LinkedIn Page | marketing | chỉ số trang mạng xã hội | Marketing | chạy |
| Brevo | marketing | chiến dịch email và sự kiện gửi | Marketing | chạy |
| Bitrix24 | marketing | — | Marketing | chưa mở |
| Facebook Page Insights | marketing | — | Marketing | chưa mở |
| Creator Commerce | market_intel | ảnh chụp ngành hàng, đối thủ, creator, sản phẩm | Thị trường | chạy |
| EcomHeat / ECI | market_intel | ước tính doanh số theo nhãn, theo tuần | Thị trường | chạy, nạp bằng file |
| SocialHeat | market_intel | lượt nhắc mạng xã hội theo ngày | Thị trường | đang ngừng, dùng bảng tính |
| SocialTrend | market_intel | xếp hạng xu hướng và bài đăng nổi bật | Thị trường | đang ngừng, dùng bảng tính |
| Odoo HRM | dataset | bản ghi bộ dữ liệu nhân sự | Nhân sự | chưa kiểm chứng trên hệ thống thật |
Hai kết nối "chưa có trình đồng bộ" vẫn hiện trong danh mục và vẫn lưu được khoá; một lệnh đồng bộ cho chúng sẽ dừng với lỗi chưa đăng ký trình xử lý. Không dùng chúng làm đường nạp dữ liệu cho một tổ chức thật.
Khi chưa có kết nối API#
Mọi họ đều có đường nạp bằng file: Tải lên dữ liệu (/connectors/uploads) nhận CSV, XLSX và XLS, còn Cấu hình CSV/Excel (/connectors/uploads/templates) giữ mẫu ánh xạ cột cho từng luồng. Mẫu ánh xạ là dữ liệu, không phải mã: thêm một hình dạng file mới là thêm một mẫu, không phải một bản dựng mới. Xem Tải CSV/Excel thủ công.