An integration connects a client to one data source. This guide covers the steps that every integration shares. Each provider has its own guide with the exact access it needs.
Who can do this: the workspace owner, a workspace admin, the client's client admin, or the client's own client login. Your email address must be confirmed.
Before you start
Choose a provider and check its prerequisites:
| Provider | How it connects | Guide |
|---|---|---|
| Google Analytics 4 | A Google Cloud service account you add as a Viewer on the property | Google Analytics 4 |
| Google Search Console | Sign in with Google | Google Search Console |
| YouTube | Sign in with Google | YouTube |
| Facebook Page | Sign in with Meta | Facebook Page (Meta) |
| Meta Ads | Sign in with Meta | Meta Ads |
Coeff IQ only reads from accounts you already have. It does not create properties, Pages, channels or ad accounts for you.
Connect
- Open the client, then Integrations in the client navigation.
- Select Connect an integration.
- Choose the provider under Provider. Providers that cannot be connected yet appear under Not available to connect yet.
- Follow the provider's steps:
- Sign-in providers (Search Console, YouTube, Facebook, Instagram, Threads, Meta Ads, TikTok): select Connect with Google, Connect with Facebook, Connect with Instagram, Connect with Threads or Connect with Meta. Sign in and approve read-only access, and you are returned to Coeff IQ.
- Google Analytics 4: paste the service account's details, select Fetch available properties, choose the property, then select Connect.
- If the account can see more than one property, Page, channel or ad account, a panel asks Which one should Coeff IQ sync? Choose one and select Save selection. If there is only one, it is selected for you.
Expected result: the integration is listed with the status CONNECTED and a "Syncing:" line naming what it syncs.
The first sync
- Select Sync now at the top of the client page to run the first sync. The first sync after connecting is always allowed, even on the free trial.
- It fetches history first: up to about 13 months on a paid plan, 14 days on the free trial, or as far back as the provider has data. Long histories arrive in stages. Until it has all of it, the integration shows "Older history still to fetch — sync again to continue." Select Sync now for the next stage.
- When data has arrived, the integration shows Data through with the latest day stored.
- Coeff IQ doesn't sync in the background. Select Sync now again whenever you want fresh data — at most once per hour on paid plans and once per day on the free trial.
More detail: Syncing, Sync now and data freshness.
If the connection fails
- "You declined access, so nothing was connected." Start again and approve the requested access.
- "This provider is already connected for this client." A client can have one connection per provider. Use the existing one.
- No properties or accounts are listed. The account you signed in with does not have the required access at the provider. Check the provider's guide.
More fixes: Fix integration errors.
