Skip to content
MSO CloudDocumentation

Connectors and data planes

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.

Connector families on three data planes: marketplace and marketing are first-party and reconcilable, market intelligence is a labelled estimate outside reconciliation

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