Connectors
Connectors link Whimful to your ad platforms and e-commerce store. Once connected, Whimful can pull in campaign data, push enriched conversion signals via server-side APIs, and sync custom audiences — all automatically.
How to add a connector
- Go to Connectors in the sidebar.
- Click Add Connector.
- Choose the platform you want to connect.
- Follow the on-screen authorization flow for that platform.
- Once authorized, the connector appears in your connectors list with a status of Active.
Supported platforms
The Shopify connector is the quickest path to full tracking. It automatically installs the Whimful tag, syncs purchase events, and provides access to order and customer data.
What it enables:
- Automatic tag installation into your storefront theme
- Real-time purchase and add-to-cart event capture
- Order and customer data sync for attribution
- Product catalog access for audience building
How to connect: Click Add Connector › Shopify, enter your myshopify domain, and authorize the Whimful app via the Shopify OAuth flow.
Connects your Meta Ads account so Whimful can forward enriched conversion events server-side via the Meta Conversions API (CAPI).
What it enables:
- Server-side conversion event forwarding (bypasses browser restrictions and ad blockers)
- Event matching and deduplication with browser-side pixel events
- Audience sync — push custom segments to Meta Custom Audiences
- Campaign data ingestion for cross-channel reporting
How to connect: Click Add Connector › Meta and authorize via Meta's OAuth. Select the Ad Account you want to connect.
Connects to your Google Ads account to pull campaign performance data and push enhanced conversion events.
What it enables:
- Enhanced Conversions — sends hashed first-party data to improve bidding accuracy
- Campaign and keyword performance data ingestion
- Customer Match list sync for targeted advertising
- Cross-channel ROAS reporting
How to connect: Click Add Connector › Google Ads, authorize with your Google account, and enter your Google Ads Customer ID.
Connects your TikTok Ads account to enable server-side event forwarding via the TikTok Events API.
What it enables:
- Server-side events forwarding via TikTok Events API
- Accurate conversion tracking that isn't affected by browser restrictions
- Campaign performance data ingestion
How to connect: Click Add Connector › TikTok and authorize via TikTok's OAuth. Your Advertiser ID is selected automatically.
Connects your Google Merchant Center account to import product performance data and catalog health metrics.
What it enables:
- Product performance data ingestion (impressions, clicks, CTR)
- Catalog health monitoring and diagnostic data
- Cross-channel product-level reporting
How to connect: Click Add Connector › Google Merchant Center, enter your Merchant ID, and add the Whimful access email as an Admin.
Connects your Google Search Console property to import organic search performance data. This powers SEO agents and enriches your cross-channel reporting.
What it enables:
- Organic search impressions, clicks, and keyword data
- Indexing status and crawl error monitoring
- Site performance data for SEO agents
How to connect: Click Add Connector › Google Search Console, authorize with the Google account that has access to your Search Console property.
Connector status
Each connector shows a status badge in the connectors table:
- Active — connected and syncing normally.
- Warning — connected but there may be a partial issue (e.g. rate-limited). Hover over the badge for details.
- Error — the connection has failed. This usually means the authorization token has expired. Re-authorizing the connector will resolve it.
- Inactive — manually disabled.
Data sync schedule
By default, Whimful pulls data from connected platforms hourly. The last sync time is shown in the connectors table under Data Pull.
Server-side event forwarding (to Meta CAPI, Google Ads, TikTok Events API) is real-time — events are forwarded as they happen on your site.
Disconnecting a connector
To remove a connector, find it in the connectors table and click the Disconnect action. This immediately stops all data sync for that platform. This action cannot be undone — you'll need to reconnect and re-authorize if you want to restore the sync.