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
TrustData Connectors extract campaigns, ad groups, ads, and keywords, and sync spend, clicks, and impressions. They handle API rate limits and pagination, then transform everything to one schema.
The analytics store holds one unified ad data table, matched with your first-party conversion data and deduplicated for attribution.
Two-step setup
Setup takes two steps:
Step 1: Configure URL parameters (ad platform)
Your ads must include tracking parameters before TrustData can attribute conversions. Add them 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:
- Google Ads URL setup
- Meta Ads URL setup
- TikTok Ads URL setup
- LinkedIn Ads URL setup
- Pinterest Ads URL setup
Step 2: Connect data source (TrustData)
After you add the 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 the ad accounts to sync
- Set the sync start date and 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 |
| LinkedIn Ads | Campaign groups, campaigns, ads, spend, clicks | OAuth 2.0 |
| Pinterest Ads | Campaigns, ad groups, ads, spend, clicks | OAuth 2.0 |
| Custom webhooks | Server-side events (purchases, leads, etc.) | API key |
| Cloudflare AI crawlers | AI-bot visits + AI-engine referrals from edge logs | API key |
The OAuth platforms above are pull connectors: TrustData authenticates and syncs data on a schedule. Custom webhooks and Cloudflare AI crawlers are push data sources. They stream events to TrustData with an API key, so they have no OAuth step and follow the event schema rather than a sync cycle.
Sync schedule
By default, connectors sync daily:
To sync manually, go to 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 and you enabled alerts, TrustData sends one. Common causes:
- Expired credentials: Reconnect the data source
- API rate limits: TrustData retries automatically
- Ad account access removed: Verify permissions in the 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 authorize again
- Rate limited: Wait for the automatic retry
- Permissions changed: Authorize TrustData again in the ad platform
Missing data
- New campaigns: Data appears after the next sync
- Attribution not matching: Verify the URL parameters are set correctly
- Wrong ad account: Check which ad accounts you selected in the data source settings
Click IDs not captured
Check that your landing page URLs include the TrustData tracking parameters:
https://example.com/landing?trdt_cpid={campaignid}&trdt_agid={adgroupid}&gclid={gclid}
Test your URLs before you launch campaigns.
Integrations overview on trustdata.tech · Free trial