TrustData
Connectors

Overview

Connect your ad platforms into one unified data layer, with no more conflicting reports.

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)

PlatformConversionsRevenue claimed
Google Ads342$52,000
Meta Ads298$41,500
TikTok Ads124$15,200
Total764$108,700
Actual512$89,700
Overcounting+49%+21%

Each platform takes credit for the same conversions. TrustData deduplicates and attributes fairly.

How connectors work

Loading diagram…

TrustData Connectors extract campaigns, ad groups, ads and keywords, fetch spend, clicks and impressions, handle API rate limits and pagination, and transform everything to a unified schema.

The analytics store holds one unified ad data table, matched with your first-party conversion data and deduplicated for 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.

ParameterPurposeRequired
trdt_cpidCampaign IDRecommended
trdt_agidAd Group IDRecommended
trdt_kwidKeyword IDOptional
trdt_ctidCreative/Ad IDOptional

See platform-specific guides:

Step 2: Connect data source (TrustData)

After configuring URL parameters, connect the data source in TrustData:

  1. Go to SettingsData Sources
  2. Click Add Data Source
  3. Select the platform
  4. Complete the OAuth flow
  5. Select accounts to sync
  6. Configure sync settings (start date, conversion window)

Available connectors

PlatformData SyncedAuth Method
Google AdsCampaigns, ad groups, ads, keywords, spend, clicksOAuth 2.0
Meta AdsCampaigns, ad sets, ads, spend, clicks, impressionsOAuth 2.0
TikTok AdsCampaigns, ad groups, ads, spend, clicksOAuth 2.0
LinkedIn AdsCampaign groups, campaigns, ads, spend, clicksOAuth 2.0
Pinterest AdsCampaigns, ad groups, ads, spend, clicksOAuth 2.0
Custom webhooksServer-side events (purchases, leads, etc.)API key
Cloudflare AI crawlersAI-bot visits + AI-engine referrals from edge logsAPI key

The OAuth platforms above are pull connectors: TrustData authenticates and syncs data on a schedule. Custom webhooks and Cloudflare AI crawlers are push integrations: 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:

Loading diagram…

You can also trigger manual syncs from SettingsData SourcesSync Now.

Sync health monitoring

TrustData monitors your connector health:

StatusMeaning
SyncedLast sync completed successfully
RunningSync in progress
FailedSync failed (check error details)
StaleNo 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 TypeFreshness
Ad spend & metricsPrevious day (T-1)
Events & conversionsReal-time
AttributionDaily recalculation

Troubleshooting

Sync failed

  1. Check the error message in Data Sources → click the source → Sync History
  2. 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

  1. New campaigns: Data appears after next sync
  2. Attribution not matching: Verify URL parameters are configured correctly
  3. 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.


Integrations overview on trustdata.tech · Free trial