Meta Ads

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

URL parameters setup

Setting up URL parameters

Add the following URL parameters to your ads:

trdt_cpid={{campaign.id}}&trdt_agid={{adset.id}}&trdt_ctid={{ad.id}}

You can set URL parameters at the account, campaign, or ad level. Here is how to bulk edit URL parameters at the ad level:

1. In Meta Ads Manager, navigate to the Ads tab
2. Select the ads you want to modify

3. Click the Edit button in the toolbar
4. From the dropdown menu, select URL parameters

5. In the left sidebar, click URL parameters under Tracking
6. Enter the tracking parameters in the URL parameters field for all selected ads or individually per ad
7. Click Save as draft

8. Click Review and publish to apply the changes to your ads

Available dynamic parameters

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 Settings → Data Sources
2. Click Add Data Source → Meta 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

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.

Conversion forwarding

TrustData can forward server-side conversion events directly to the Meta Conversions API (CAPI). This improves match rates and gives Meta better optimization signals.

Getting a system user access token

For the most reliable setup, create a system user token in Meta Business Manager:

1. Go to Meta Business Settings → Users → System Users
2. Click Add to create a system user (or select an existing one)
3. Set the role to Admin
4. Click Generate New Token
5. Select your app and grant the ads_management permission
6. Copy the generated token

Finding your Pixel ID

1. Go to Meta Events Manager
2. Select your pixel from the left sidebar
3. The Pixel ID is displayed at the top of the page (a 15–16 digit number, e.g., 123456789012345)

Configuring in TrustData

1. Go to Settings → Attribution IDs → select your ID → Edit Tracking Config
2. Open the Forwarding tab
3. Under Meta Conversions API:
   • Enable Meta CAPI
   • Enter your Pixel ID
   • Paste the system user Access Token
4. Click Save Configuration

If you leave the access token empty, TrustData will attempt to use the OAuth token from your connected Meta Ads data source.

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