Overview
Connectors sync data from your ad platforms into TrustData, giving you one source of truth instead of conflicting platform reports.
The problem with platform data
Each ad platform reports its own numbers:
┌─────────────────────────────────────────────────────────────┐
│ What Each Platform Reports (Same Week) │
├──────────────┬──────────────┬───────────────────────────────┤
│ Platform │ Conversions │ Revenue Claimed │
├──────────────┼──────────────┼───────────────────────────────┤
│ Google Ads │ 342 │ $52,000 │
│ Meta Ads │ 298 │ $41,500 │
│ TikTok Ads │ 124 │ $15,200 │
├──────────────┼──────────────┼───────────────────────────────┤
│ Total │ 764 │ $108,700 │
│ Actual │ 512 │ $89,700 │
│ Overcounting │ +49% │ +21% │
└──────────────┴──────────────┴───────────────────────────────┘
Each platform takes credit for the same conversions. TrustData deduplicates and attributes fairly.
How connectors work
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Google Ads │ │ Meta Ads │ │ TikTok Ads │
└────────┬────────┘ └────────┬────────┘ └────────┬────────┘
│ │ │
│ OAuth 2.0 / API Keys │
│ │ │
▼ ▼ ▼
┌─────────────────────────────────────────────────────────────────┐
│ TrustData Connectors │
│ • Extracts campaigns, ad groups, ads, keywords │
│ • Fetches spend, clicks, impressions │
│ • Handles API rate limits and pagination │
│ • Transforms data to unified schema │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ ClickHouse │
│ • Unified ad data table │
│ • Matched with first-party conversion data │
│ • Deduplicated attribution │
└─────────────────────────────────────────────────────────────────┘
Two-step setup
Setting up a connector requires two steps:
Step 1: Configure URL parameters (ad platform)
Before TrustData can attribute conversions, your ads must include tracking parameters. This happens in your ad platform, not in TrustData.
| Parameter | Purpose | Required |
|---|---|---|
trdt_cpid | Campaign ID | Recommended |
trdt_agid | Ad Group ID | Recommended |
trdt_kwid | Keyword ID | Optional |
trdt_ctid | Creative/Ad ID | Optional |
See platform-specific guides:
Step 2: Connect data source (TrustData)
After configuring URL parameters, connect the data source in TrustData:
- Go to Settings → Data Sources
- Click Add Data Source
- Select the platform
- Complete the OAuth flow
- Select accounts to sync
- Configure sync settings (start date, conversion window)
Available connectors
| Platform | Data Synced | Auth Method |
|---|---|---|
| Google Ads | Campaigns, ad groups, ads, keywords, spend, clicks | OAuth 2.0 |
| Meta Ads | Campaigns, ad sets, ads, spend, clicks, impressions | OAuth 2.0 |
| TikTok Ads | Campaigns, ad groups, ads, spend, clicks | OAuth 2.0 |
Sync schedule
By default, connectors sync daily:
2:00 AM UTC → Connectors fetch new data
2:30 AM UTC → Data transformation
3:00 AM UTC → Attribution calculation
3:30 AM UTC → Dashboard data ready
You can also trigger manual syncs from Settings → Data Sources → Sync Now.
Sync health monitoring
TrustData monitors your connector health:
| Status | Meaning |
|---|---|
| Synced | Last sync completed successfully |
| Running | Sync in progress |
| Failed | Sync failed (check error details) |
| Stale | No sync in >24 hours |
If a sync fails, you'll receive an alert (if configured). Common causes:
- Expired credentials: Re-authenticate via OAuth
- API rate limits: Automatic retry
- Account access removed: Verify permissions in ad platform
Data freshness
| Data Type | Freshness |
|---|---|
| Ad spend & metrics | Previous day (T-1) |
| Events & conversions | Real-time |
| Attribution | Daily recalculation |
Troubleshooting
Sync failed
- Check the error message in Data Sources → click the source → Sync History
- Common fixes:
- OAuth expired: Click Reconnect to re-authenticate
- Rate limited: Wait for automatic retry
- Permissions changed: Re-authorize in the ad platform
Missing data
- New campaigns: Data appears after next sync
- Attribution not matching: Verify URL parameters are configured correctly
- Wrong account: Check selected accounts in data source settings
Click IDs not captured
Verify your landing page URLs include TrustData tracking parameters:
https://example.com/landing?trdt_cpid={campaignid}&trdt_agid={adgroupid}&gclid={gclid}
Test your URLs before launching campaigns.