TrustData
Connectors

Meta Ads

Connect Meta Ads (Facebook & Instagram) and configure tracking parameters.

Connect your Meta Ads account to sync Facebook and Instagram advertising data.

URL parameters setup

Do this first! Configure URL parameters in Meta Ads Manager before connecting in TrustData.

Set parameters at the account level:

  1. In Meta Ads Manager, go to Account Settings
  2. Find URL Parameters
  3. Enter:
trdt_cpid={{campaign.id}}&trdt_agid={{adset.id}}&trdt_ctid={{ad.id}}
  1. Click Save

Option 2: Campaign-level URL parameters

Set parameters per campaign:

  1. When creating or editing a campaign, go to Tracking
  2. In URL Parameters, enter:
trdt_cpid={{campaign.id}}&trdt_agid={{adset.id}}&trdt_ctid={{ad.id}}

Option 3: Ad-level URL parameters

For granular control, set at the ad level:

  1. Edit an ad
  2. Under TrackingURL Parameters, enter:
trdt_cpid={{campaign.id}}&trdt_agid={{adset.id}}&trdt_ctid={{ad.id}}

Available dynamic parameters

ParameterDescriptionExample Value
{{campaign.id}}Campaign ID23851234567890
{{campaign.name}}Campaign nameSummer_Sale_2024
{{adset.id}}Ad set ID23851234567891
{{adset.name}}Ad set nameUS_25-34_Interest
{{ad.id}}Ad ID23851234567892
{{ad.name}}Ad nameVideo_Creative_1
{{placement}}PlacementFacebook_Feed
{{site_source_name}}Platformfb, ig, an
Note: Meta's fbclid is automatically appended by Meta. TrustData captures both fbclid and your custom trdt_cid.

Verify your setup

  1. Preview an ad in Ads Manager
  2. Click on the ad preview
  3. Check the URL in your browser:

Expected URL:

https://example.com/landing?trdt_cpid=23851234567890&trdt_agid=23851234567891&trdt_ctid=23851234567892&fbclid=IwAR3...

Connecting in TrustData

After configuring URL parameters:

  1. Go to SettingsData Sources
  2. Click Add Data SourceMeta Ads
  3. Click Connect with Facebook
  4. Log in with your Facebook account
  5. Select the ad accounts you want to sync
  6. Click Done then Save

Required permissions

TrustData requests these permissions:

  • ads_read - Read ad account data
  • ads_management - Access campaign structure (read-only usage)

TrustData only reads data. We never modify your campaigns.

Business manager access

For Business Manager accounts:

  1. Ensure your Facebook user has Analyst or higher access
  2. The ad accounts must be claimed by the Business Manager
  3. Select the specific ad accounts during connection

Synced data

Data TypeDescription
CampaignsName, objective, status, budget
Ad SetsName, targeting, budget, schedule
AdsCreative, name, status
MetricsImpressions, reach, clicks, spend, CPM, CPC

Date range

  • Historical: Last 90 days on first sync
  • Ongoing: Daily incremental sync

Breakdown data

Metrics are synced with these breakdowns:

  • By day
  • By campaign/ad set/ad
  • By platform (Facebook, Instagram, Audience Network)

Attribution matching

TrustData matches Meta clicks to conversions:

User clicks ad → trdt_cid + fbclid captured
        ↓
User converts → conversion event sent
        ↓
TrustData matches via trdt_cid
        ↓
Attribution credit assigned to campaign/ad set/ad

View-through attribution

Meta reports view-through conversions (user saw ad but didn't click). TrustData focuses on click-through attribution for accuracy.

To compare with Meta's view-through data, check the Meta Ads dashboard.

Troubleshooting

"No ad accounts found"

  1. Verify your Facebook account has access to ad accounts
  2. Check Business Manager permissions
  3. Try disconnecting and reconnecting

"Permission denied"

  1. Ensure you have Analyst access or higher
  2. Check that the ad account is active (not disabled)
  3. Verify Business Manager settings allow API access

"URL parameters not appearing"

  1. Check for conflicting URL parameters at different levels
  2. Campaign-level overrides account-level
  3. Ad-level overrides campaign-level

"fbclid not captured"

Meta automatically adds fbclid unless:

  1. You're using a link shortener (don't use them)
  2. Your site strips query parameters (check your redirects)
  3. The landing page has JavaScript errors

Instagram stories/reels

For swipe-up links in Stories:

  1. URL parameters work the same way
  2. Parameters are applied to the destination URL
  3. Verify with the preview tool