On this page
In short. Every connector belongs to one of five families, and every family feeds one data plane. The planes never mix, so a number always says whose data it is.
How it works#
A plane decides three things: whether a number is reconciled, whether the data assistant may answer from it, and whether it can be a decision's measured outcome. Marketplace and marketing are first-party; market intelligence is a third-party estimate. Marketing never adds to or replaces marketplace revenue: an organization running both reads two planes. A market estimate carries its label everywhere it appears and only forms a hypothesis.
A family groups connectors that share one ingest contract. The connectors in each family are in the catalog.
How a connection runs#
- The organization owner or an admin adds a connection on Connectors ("Kết nối"). Each connection belongs to one brand; an organization with no brand cannot hold one (Multi-brand workspaces).
- A connector shows in the catalog only while its plugin is on for the organization. A shape that does not run a plane never sees that plane's connectors.
- Sources restate their own numbers after publishing, so every scheduled run re-pulls a trailing window. The window is the connector's own, from 3 days (web analytics) to 30 (page and email metrics). A restatement older than the window needs a backfill (Ingest pipeline).
- A secret key is encrypted on save and never shown again; editing means pasting a new key. Test proves read access, not that history has landed.
Without an API connector#
Every plane has a file path. Upload data ("Tải lên dữ liệu") accepts CSV, XLSX and XLS. CSV/Excel mapping ("Cấu hình CSV/Excel") holds the column-mapping template per stream. A template is data: a new file shape is a new template, not a build. Steps: Upload CSV or Excel files.
Where it stops#
Catalog cards that cannot ingest yet are listed on Project status. Vendor names for the third-party market-data plane never appear on a product surface.
Reference#
Connector catalog
| Connector | Family | Loads | Serves |
|---|---|---|---|
| TikTok Shop | marketplace | orders, creators, LIVE sessions, videos | eCom |
| Shopee | marketplace | orders, inventory | eCom |
| Lazada | marketplace | orders, inventory | eCom |
| Shopee · CSV | marketplace | orders, from a file export | eCom |
| Lazada · CSV | marketplace | orders, from a file export | eCom |
| Google Sheets | marketing | spend, budget plan, targets, dataset tabs | multiple |
| Google Ads | marketing | ad spend | Marketing |
| Meta Ads | marketing | ad spend | Marketing |
| TikTok Ads | marketing | ad spend | Marketing |
| Shopee Ads | marketing | ad spend, by API or file | Marketing |
| Google Analytics 4 | marketing | sessions, users, pages, acquisition | Marketing |
| Google Search Console | marketing | queries, pages, impressions and clicks from search | Marketing |
| LinkedIn Page | marketing | social page metrics | Marketing |
| Brevo | marketing | email campaigns and send events | Marketing |
| Market-data feed (API or export) | market intel | category, competitor, creator and product snapshots | Market |
| Social listening feed (spreadsheet) | market intel | daily mentions and trend rankings, through a shared sheet | Market |
| Odoo HRM | dataset | HR dataset records | HR |
What it reads and never reads
| Reads | Never reads |
|---|---|
| The organization's own shop, account and system data, per brand | Another organization's connection or key |
| A vendor's estimate feed, labelled as an estimate | A vendor estimate as a first-party number |
| A file mapped by the organization's own template | A file whose template does not exist yet |