Connecting TikTok
CleanClicks sends conversion events to TikTok via the Events API. Like Meta, TikTok uses a manually generated access token.
CleanClicks sends conversion events to TikTok via the Events API. Like Meta, TikTok uses a manually generated access token.
Prerequisites
- A TikTok Ads Manager account
- A TikTok Pixel created in Events Manager
- Access to generate API tokens
Getting Your Credentials
Pixel Code
- Go to TikTok Ads Manager > Assets > Events > Web Events
- Select your pixel
- The Pixel Code is displayed on the overview page (format:
CXXXXXXXXXXXXXXXXX)
Access Token
- On the same pixel settings page, look for Generate Access Token
- Click to generate a token
- Copy it immediately (you may not be able to see it again)
Connecting in CleanClicks
- Go to Connections in your CleanClicks dashboard
- Select your domain
- Find TikTok in the Token Entry section
- Paste your Access Token
- Enter your Pixel Code
- Click Save
Configuring the Vendor
After connecting:
- Go to Configuration > Vendors tab
- Enable TikTok
- Verify the Pixel Code and Access Token are present
- Save
How It Works
When a visitor converts:
- CleanClicks captures the
ttclid(TikTok Click ID) from the landing page URL - The conversion event is sent server-side to TikTok's Events API with the ttclid
- TikTok matches the conversion to the original ad click
- Customer data is sent as SHA-256 hashes for Advanced Matching
Recommended TikTok settings
| Setting | Recommended | Why |
|---|---|---|
| Pixel | Use your existing pixel | CleanClicks sends server-side events into the same pixel — never create a second pixel just for CleanClicks |
| Access token | Generate from that same pixel's settings page | Tokens are pixel-scoped; a token from a different pixel sends your events to the wrong place |
| Automatic Advanced Matching (web pixel) | Off | CleanClicks already sends hashed customer data server-side, deliberately and consistently |
| Event rules / automatic events | Off for events CleanClicks delivers | Prevents TikTok-guessed events from duplicating or polluting the deterministic set |
CCPA and opt-out behavior
When a visitor opts out (through Global Privacy Control, a CleanClicks opt-out cookie, or your consent platform's "reject"), CleanClicks sends TikTok nothing for that visitor. Opted-out conversions are dropped before they leave CleanClicks, not transmitted to TikTok under a limited-data-use flag or any other mechanism.
For visitors who have not opted out, conversions are sent to the Events API normally. CleanClicks does not attach limited_data_use: true by default.
Troubleshooting
| Issue | Solution |
|---|---|
| Token rejected | Regenerate the access token in TikTok Events Manager |
| Events not appearing | Verify the Pixel Code matches your pixel. Check that TikTok is enabled in Configuration > Vendors. |
| Pixel Code format | Must start with C followed by alphanumeric characters (e.g., CXXXXXXXXXXXXXXXXX) |
Next: Microsoft Ads