Tracking Parameters
Tracking parameters (UTMs and platform-specific macros) are added to your ad URLs so TrueTracked can identify which campaigns, ad sets, and ads are driving traffic and conversions. The parameter builder in TrueTracked generates the correct URL parameters for each ad platform.
Why Tracking Parameters Matter
Without tracking parameters, TrueTracked can only attribute traffic to the referring domain. With proper parameters, you get granular attribution down to the specific campaign, ad group, and individual ad, enabling accurate ROAS calculations for each.
How to Use the Parameter Builder
- Go to Settings > Tracking Parameters in your TrueTracked dashboard
- Select your ad platform from the dropdown (Meta, Google Ads, TikTok, Snapchat, Pinterest, ChatGPT Ads)
- The builder generates the required platform-specific parameters automatically
- Optionally enable or customize UTM parameters (utm_source, utm_medium, utm_campaign, utm_content, utm_term)
- Optionally add custom parameters for your own tracking needs
- Copy the generated parameter string and append it to your ad destination URLs
Platform-Specific Parameters
Each ad platform uses dynamic macros that get replaced with actual values when the ad is served. Here are the required parameters by platform:
Meta (Facebook & Instagram)
tt_source=meta&tt_adid={{ad.id}}Meta replaces {{ad.id}} with the real ad ID when the ad is clicked. The ad ID is enough: TrueTracked works out the ad set and campaign from it.
Google Ads
{lpurl}?tt_source=google&tt_campaignid={campaignid}&tt_adsetid={adgroupid}&tt_adid={creative}Google Ads uses {lpurl} as the landing page URL placeholder, followed by ValueTrack parameters in curly braces. The campaign ID is always filled in, so Performance Max campaigns, which have no ad group or ad ID, still count at the campaign level.
The builder also offers an optional tt_gcid={gclid}. It keeps a copy of Google's click ID for browsers that remove gclid from links, such as Safari, Firefox and Brave.
TikTok
?tt_source=tiktok&tt_adid=__CID__TikTok uses double-underscore macros that resolve when the ad is clicked. __CID__ is the ad ID, which is enough for TrueTracked to work out the ad group and campaign.
Snapchat
?tt_source=snapchat&tt_adid={{ad.id}}Snapchat replaces {{ad.id}} with the real ad ID when the ad is clicked. Connect your Snapchat ad account under Integrations so TrueTracked can show spend and ROAS next to these clicks.
?tt_source=pinterest&tt_adid={adid}Pinterest fills in {adid} when the ad is clicked, so sales are attributed to your Pinterest ads. Pinterest ad accounts can't be connected yet, so spend and ROAS for Pinterest aren't shown.
ChatGPT Ads
tt_source=chatgpt&tt_adid={ad_id}&utm_source=chatgpt&utm_medium=cpc&utm_campaign={campaign_id}&utm_content={ad_group_id}&utm_term={ad_id}ChatGPT Ads fills in {campaign_id}, {ad_group_id}, and {ad_id} when the ad is clicked. The ad ID is enough for TrueTracked to work out the ad group and campaign. The UTM half is OpenAI's own default template, and keep utm_source=chatgpt as it is: it separates paid ChatGPT clicks from organic ChatGPT traffic, which arrives as chatgpt.com.
UTM Parameters
In addition to the required platform parameters, you can enable standard UTM parameters for broader analytics compatibility:
| Parameter | Purpose | Example Value |
|---|---|---|
utm_source | Traffic source | meta, google, tiktok, snapchat, pinterest, chatgpt |
utm_medium | Marketing medium | cpc, paid_social, display |
utm_campaign | Campaign name | summer_sale, brand_awareness |
utm_content | Ad creative identifier | video_1, carousel_a |
utm_term | Search keywords | running+shoes, best+coffee |
Custom Parameters
You can add custom parameters for your own tracking needs. Custom parameter names must be alphanumeric (with underscores allowed) and cannot duplicate existing parameter names.
&my_param=my_value&variant=controlHow to Apply Parameters
- Copy the full parameter string from the TrueTracked parameter builder
- In your ad platform, paste it into the URL Parameters or Tracking Template field:
- Meta: Ad level > Destination > URL Parameters
- Google Ads: Campaign Settings > Tracking Template (or at ad group/ad level)
- TikTok: Ad level > URL > URL Parameters
- Snapchat: add it to the end of the ad's website URL
- Pinterest: add it to the end of the ad's destination URL
- ChatGPT Ads: Ad group or ad level > URL parameters
- Save and publish your ads
Troubleshooting
- Parameters not showing in TrueTracked: Click on an ad and check the landing page URL in your browser bar. If you don't see the parameters, verify they're applied at the correct level in your ad platform.
- Double question marks in URL: This happens when parameters are added to a URL that already has query params. Google Ads handles this automatically with
{lpurl}. For other platforms, ensure the parameter string starts with&if your landing page URL already has a?. - Attribution shows "Direct" instead of platform: Ensure the
tt_sourceparameter is present. This is the primary identifier TrueTracked uses to attribute traffic to a platform.