TikTok Ads

Connect your TikTok Ads account to sync campaign data and enable attribution.

URL parameters setup

Setting up tracking parameters

TikTok doesn't have account-level URL parameters. You need to configure tracking at the ad level using bulk edit:

1. In TikTok Ads Manager, go to the Campaigns page
2. Navigate to the Ad level in the left sidebar
3. Select the ad(s) you want to edit using the checkboxes
4. Under Bulk edit in the left panel, click Destination link

5. In the destination link field, paste your landing page URL with the tracking parameters appended, then click Apply to all
6. Click Review to confirm and save your changes

The tracking parameters to append to your URL:

trdt_cpid=__CAMPAIGN_ID__&trdt_agid=__AID__&trdt_ctid=__CID__

Available dynamic macros

Recommended URL parameter string

For comprehensive tracking:

trdt_cpid=__CAMPAIGN_ID__&trdt_agid=__AID__&trdt_ctid=__CID__&ttclid=__CLICKID__

Verify your setup

1. Preview the ad in TikTok Ads Manager
2. Click through to your landing page
3. Check the URL:

Expected URL:

https://example.com/landing?trdt_cpid=9876543210&trdt_agid=1122334455&trdt_ctid=1234567890&ttclid=E.C.P.CjwKCA...

Connecting in TrustData

After configuring URL parameters:

1. Go to Settings → Data Sources
2. Click Add Data Source → TikTok Ads
3. Click Connect with TikTok
4. Log in with your TikTok for Business account
5. Select the advertiser accounts to sync
6. Click Confirm then Save

Required permissions

TrustData requests these permissions:

• Ad Account Management (read-only)
• Ad Insights (read-only)

TrustData only reads data. We never modify your campaigns.

Business center access

For Business Center accounts:

1. Your TikTok account must have access to the advertiser accounts
2. Select specific advertiser IDs during setup
3. Each advertiser syncs independently

Synced data

Date range

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

Metrics available

• Impressions
• Clicks
• Click-through rate (CTR)
• Cost per click (CPC)
• Total spend
• Video views (25%, 50%, 75%, 100%)
• Engagement (likes, comments, shares)

Attribution matching

TrustData matches TikTok clicks to conversions:

User clicks ad → ttclid + trdt_cid captured
        ↓
User converts → conversion event sent
        ↓
TrustData matches via trdt_cid
        ↓
Attribution credit assigned

TikTok pixel vs TrustData

TikTok's pixel provides:

• In-platform conversion reporting
• Optimization signals for bidding

TrustData provides:

• Cross-platform attribution
• First-party data collection
• Unified view with other channels

Recommendation: Use both. TikTok pixel for optimization, TrustData for attribution.

Conversion forwarding

TrustData can forward server-side conversion events to the TikTok Events API. This improves attribution accuracy and helps TikTok optimize ad delivery.

Getting an access token

Generate a long-lived access token from the TikTok Business API portal:

1. Go to TikTok for Business Developers → select your app
2. Navigate to Tools → Generate Access Token
3. Select the advertiser accounts and grant the Event Management permission
4. Copy the generated token

Finding your Pixel Code

1. In TikTok Ads Manager, go to Tools → Events
2. Select Web Events → click on your pixel
3. The Pixel Code is shown at the top (format: CXXXXXXXXX, e.g., C1A2B3C4D5E6F7G8)

Configuring in TrustData

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

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

Troubleshooting

"Advertiser account not found"

1. Verify your TikTok Business account has advertiser access
2. Check that you're logging in with the correct account
3. Ensure the advertiser account is active

"No data synced"

1. Confirm the account has active campaigns with spend
2. Check that campaigns ran within the last 60 days
3. Verify API access in TikTok Business Center

"ttclid not captured"

1. Verify __CLICKID__ macro is in your URL parameters
2. Check your landing page doesn't strip query parameters
3. Test with a real ad click (not preview)

"URL parameters not working"

1. TikTok requires parameters at the ad level
2. Check for typos in macro names (case-sensitive)
3. Ensure no conflicting parameters in the destination URL

Spark ads

For Spark Ads (boosted organic posts):

1. URL parameters work the same way
2. Add parameters in the ad setup, not the original post
3. The original post URL is not modified