TrustData
Connectors

TikTok Ads

Connect TikTok Ads and configure tracking parameters.

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

URL parameters setup

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

Setting up tracking parameters

TikTok doesn't have account-level URL parameters. Configure them at the ad level:

  1. In TikTok Ads Manager, create or edit an ad
  2. In the Destination section, find URL parameters
  3. Add these parameters:
trdt_cpid=__CAMPAIGN_ID__&trdt_agid=__AID__&trdt_ctid=__CID__&ttclid=__CLICKID__

Available dynamic macros

MacroDescriptionExample Value
__CLICKID__TikTok Click ID (ttclid)E.C.P.CjwKCA...
__CID__Creative/Ad ID1234567890
__CAMPAIGN_ID__Campaign ID9876543210
__CAMPAIGN_NAME__Campaign nameSummer_Sale
__AID__Ad group ID1122334455
__PLACEMENT__PlacementTikTok

For comprehensive tracking:

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

Using URL parameter templates

To avoid setting parameters on every ad:

  1. Create a saved URL parameter template in your workflow
  2. Copy-paste when creating new ads:
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 SettingsData Sources
  2. Click Add Data SourceTikTok 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

Data TypeDescription
CampaignsName, objective, budget, status
Ad GroupsName, targeting, bid, schedule
AdsCreative info, name, status
MetricsImpressions, clicks, spend, CTR, CPC

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.

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