TikTok
Set up TikTok Events API to send server-side conversion events from ioZen to TikTok Ads.
Send server-side conversion events to TikTok for advertising attribution using the Events API.
Prerequisites
- A TikTok Ads Manager account
- A TikTok Pixel created in Events Manager
- Access to generate an Events API token
Step 1: Get Your Pixel ID
- Go to TikTok Events Manager
- Select your Pixel
- Copy the Pixel Code (your Pixel ID)
Step 2: Generate an Access Token
- In TikTok Events Manager, go to Settings
- Under the Events API section, generate an Access Token
- Copy the token
Step 3: Configure in ioZen
- Open your Intake Bot → Settings → Marketing & Attribution
- Toggle TikTok on
- Paste your Pixel ID and Access Token
- The settings auto-save
Step 4: Test the Connection
Click Test Connection. TikTok validates the pixel and token configuration.
Troubleshooting
| Error | Cause | Fix |
|---|---|---|
| Error code 40001 | Access token is invalid | Generate a new token in TikTok Events Manager → Settings. |
| Error code 40002 | Pixel ID is invalid | Copy your Pixel Code from TikTok Events Manager. |
Best Practices
- Enable TikTok Click ID capture — Enable "Capture Click IDs" in ioZen's attribution settings to pass
ttclidfor better match rates. - Verify in TikTok Events Manager — After a successful test, check the Events tab to confirm events are arriving.