Skip to content
MSO CloudDocumentation

Connect marketing sources

On this page

Connect an ad platform, web-analytics, search-console, email or page account so its performance data syncs into Marketing performance ("Hiệu quả Marketing") on a schedule.

Who can do this: an owner or admin.

Before you start#

  • You can create or grant a key on the provider's side.
  • The organization has at least one brand; a marketing connection is refused without one.
  • Google Analytics 4, Search Console and Sheets share one service account. Create it in Google Cloud Console and download its JSON key. Invite its email as Viewer on the GA4 property, Restricted on the Search Console property, and Viewer on a spreadsheet.
ConnectorCredentialRe-pull windowSyncsLimitGoogle Analytics 4Service account JSON + Property ID3 dsessions, users, page views, channelGoogle Search ConsoleService account JSON + Site URL5 dqueries, pages, clicks, impressionsGoogle AdsOAuth client + refresh token + Customer ID7 dspend, conversionsVND accounts onlyMeta AdsSystem-user token + Ad Account ID14 dspend, conversionsVND accounts onlyTikTok AdsAccess token + Advertiser ID7 dspend, conversion countVND only; no conversion valueShopee AdsPartner ID/key + shop token + Shop ID7 dspendVN shops only (VND implied)LinkedIn PageOAuth token + Organization ID30 dfollowers, impressions, engagementBrevoAPI key30 dcampaigns, delivered, opened, clickedOnly spend is summed across platforms; conversions, results and ROAS stay platform-reported. Bar scale: 30 days = full width.
Credential, trailing re-pull window (days), synced facts and the currency rule per connector. The bar is the default window the worker re-reads on every sync.
Provider consoleGoogle Cloud: service account,download its JSON key, inviteits email into GA4 (Viewer) andSearch Console (Restricted)Ads managers: long-lived tokenor OAuth refresh token + theaccount id (act_..., 10 digits)1Where the data landsHiệu quả Marketing · Marketingperformance: overview, ads,website and search viewsSpend is the only figure summedacross platforms; conversionsstay platform-reportedEvery sync re-pulls a trailing window:platforms restate recent days.Thêm kết nối mới · Add new connectorMarketing & Web · 1st-partyMarketingGoogle AdsMeta AdsTikTok AdsShopee AdsGoogle Analytics 4Google Search ConsoleLinkedIn PageBrevo2Nhãn hiển thị · Display labelAcme GA4Thương hiệu · Brand (required)Acme3KHOÁ KẾT NỐI · CONNECTION KEY — ONE OF TWO SHAPESService account · GA4, Search ConsoleService Account JSON{ "client_email": ..., "private_key": ... }Property ID (GA4) / Site URL (Search Console)123456789 · sc-domain:example.comNumeric property id, not G-XXXX; Site URL as stored.Token · ads managers, LinkedIn Page, BrevoAccess Token / Refresh Token / API Key••••••••••••••Account id (Customer / Ad Account / Advertiser / Shop)act_1234567890Google Ads also takes Client ID + Client Secret.4Tần suất đồng bộ · Sync frequency15 phút · 15 minutesStored encrypted, never shown again.Re-authorize refreshes an OAuth token; never retype it.TestCreate56
Step 1 happens in the provider's console; steps 2-6 in the Add new connector wizard. The credential block takes one of two shapes.

Steps#

  1. On the provider's side create the credential in the matrix: a service account for GA4 and Search Console, a long-lived or OAuth refresh token plus the account id for the others.
  2. Open Connectors ("Kết nối"), select Add connector ("Thêm kết nối") and pick the source under Marketing.
  3. Enter a display label and choose the brand.
  4. Paste the credential: Service Account JSON plus Property ID or Site URL, or the token plus the account id. It is stored encrypted and never shown again.
  5. Select Test; a green result means the credential reads.
  6. Set the sync frequency and select Create. Each sync re-pulls the matrix's trailing window, as platforms restate recent days.
  7. Check the card shows a last-sync time, and Marketing performance shows the brand's views. TikTok Ads and Shopee Ads live verification: status.

If it fails#

Symptom Cause Fix
Test fails on GA4 or Search Console Service account not invited, or Site URL mismatch Invite the email, or match sc-domain: versus https://.../.
A currency error names a non-VND account The ads account runs another currency Only VND accounts sync; there is no exchange-rate path.
Meta reports a permanent error The system-user token was revoked Generate a new token and use Re-authorize, never retype it.
TikTok Ads shows a dash for conversion value The platform reports a count, not a value Expected; ROAS stays blank for that connector.
Test is green but no spend arrives Wrong account id, or an account outside the key's scope Check the id format: act_ prefix for Meta, 10 digits for Google Ads.