TikTok Pixel & Events API Configuration

Enable TikTok Pixel tracking on your store.

Your unique TikTok Pixel identifier.

Where to find it:

1. Go to TikTok Ads Manager
2. Go to Assets → Events
3. Select your Pixel
4. Copy the Pixel ID from Settings

Select which events to track via Pixel:

Recommendation: Enable all events for complete funnel tracking.

Enable server-side event tracking via Events API.

Your TikTok Events API access token (stored encrypted).

Where to find it:

1. Go to TikTok Events Manager
2. Select your Pixel
3. Go to Settings → Events API
4. Click "Generate Access Token"

Select which events to track via Events API:

Optional field for testing your Events API integration.

How to use:

1. Go to TikTok Events Manager → Data Sources → Your Pixel → Test Events
2. Copy the Test Event Code
3. Enter it in this field
4. Perform actions in your store
5. View real-time events in TikTok's Test Events tab

Important: Remove the Test Event Code after testing is complete!

Events fire via JavaScript when the action occurs in the browser:

Customer action → Browser JavaScript → TikTok Pixel → TikTok

Pros: Real-time, captures client data Cons: Blocked by ad blockers, affected by browser privacy settings

Events are queued and sent from your server:

Customer action → Magento Observer → Processing Queue → Cron → TikTok API

Pros: Not affected by ad blockers, more reliable Cons: Slight delay (queue processed every 5 minutes)

When both Pixel and Events API are enabled, TikTok uses event_id to deduplicate events, ensuring each action is counted only once.

The following user data is captured and SHA-256 hashed before sending:

For maximum event capture rate:

• Pixel catches immediate interactions
• Events API provides backup for blocked/missed events
• TikTok deduplicates automatically

Enable the same events in both Pixel and Events API settings to ensure complete coverage.

Regularly check the queue for failed events:

1. Go to Marketing → Magmodules TikTok → Processing Queue
2. Filter by Status = Failed
3. Check error messages
4. Fix configuration issues if needed

After setup, verify events in TikTok:

1. Go to Events Manager
2. Select your Pixel
3. Check "Overview" for recent events
4. Use "Test Events" for real-time debugging