Prism DocsTag your TikTok ad URLs
How to add Prism tracking parameters to your TikTok ads so campaign, ad group, and ad attribution show up in your dashboard.
When you connect TikTok Ads, Prism automatically pulls your platform spend, impressions, clicks, and ROAS into the attribution table and the campaign drill-down. That part needs zero setup.
What needs one small change is campaign-, ad-group-, and ad-level Prism
attribution — i.e. which of your TikTok campaigns actually drove orders
according to Prism's own multi-touch models. TikTok's click identifier
(ttclid) tells Prism the order came from TikTok, but it doesn't say which
campaign or ad. To get that, you add a short tracking template to your TikTok ad
URLs so TikTok stamps the campaign / ad-group / ad IDs onto every click.
This is forward-only, exactly like all attribution: orders that came in before you tagged your URLs stay at the channel level. Channel-level TikTok attribution (the headline TikTok row) works regardless of tagging.
The tracking template
Add this to your ad's URL (TikTok substitutes the __…__ macros at click time):
Prism reads its native pr_* parameters at the highest priority, so this
template is all you need — no other change.
A couple of things worth getting right:
- The macros are ALL-CAPS and double-underscore-wrapped. TikTok only replaces them in that exact form.
- TikTok's macros map to Prism's parameters like this:
| Prism parameter | TikTok macro | Meaning |
|---|---|---|
pr_campaign_id | __CAMPAIGN_ID__ | Campaign ID |
pr_adgroup_id | __AID__ | Ad group ID |
pr_ad_id | __CID__ | Ad / creative ID |
Heads up: TikTok's
__AID__is the ad group and__CID__is the ad / creative — the opposite of what the names suggest. The template above already has them mapped correctly.
If you also want human-readable names in your reports, TikTok offers
__CAMPAIGN_NAME__, __AID_NAME__, and __CID_NAME__ — but the IDs above are
what Prism uses to match campaigns, so the three *_id parameters are the
important ones.
Where to add it in TikTok Ads Manager
- Open the ad you want to track (or set it as a default for new ads).
- In the ad's destination settings, find the URL (the landing page) and the Tracking / URL parameters field.
- Append the template above to the existing URL parameters. If your landing page
already has a
?in it, join with&instead of a leading?. - Save and publish. New clicks will carry the campaign / ad-group / ad IDs.
Example — a landing page of https://yourstore.com/products/best-seller
becomes:
How to tell it's working
After your next sync (TikTok syncs hourly, or use Sync now on the integration card):
- The TikTok row in the attribution table shows spend, clicks, and platform ROAS — this appears whether or not you've tagged your URLs.
- Open the TikTok drill-down. Until a tagged click converts, you'll see platform spend with empty Prism-attributed columns and a reminder linking back here. Once tagged orders land, campaign / ad-group / ad rows fill in with Prism's own attributed orders and revenue.
That's it — one tracking template, added once, and TikTok campaign attribution flows into Prism alongside Meta and Google.