Prevent duplicate events in TikTok

Generate a unique Event ID

1. Use a random string, UUID, or a combination of timestamp and transaction ID for uniqueness.
2. Generate the event_id in your website’s data layer or with a GTM Custom JavaScript variable.

Expert insight:
‍For e-commerce, combine order ID and timestamp for even stronger uniqueness.

Push the Event ID to the data layer

Reference the Event ID in GTM web container (TikTok Pixel)

1. Create a Data Layer Variable for event_id.
2. Add the variable to your TikTok Pixel tag’s event configuration:

   Parameter name: event_id
   Value: {{DLV – event_id}}

Reference the Event ID in GTM server container (TikTok Events API Tag)

Create a data layer variable for event_id in the server container.
Add the event_id to your TikTok Events API HTTP Request payload:

json
{
 "event": "Purchase",
 "event_id": "{{event_id}}",
 "timestamp": {{Timestamp}},
 // ...user_data and custom_data
}

 Test deduplication

1.  Use GTM Preview mode to ensure the same event_id is present in both client- and server-side events.
2. In TikTok Events Manager, use the Test Events tool to verify deduplication is working.
3. Check that only one conversion is counted per user action.

Best practices

Consistency:
Always generate and assign the event_id at the moment of the user action—before any tags fire.
‍
Parameter Naming:
Use the exact parameter name event_id in both Pixel and Events API implementations.
‍
Uniqueness:
Ensure your event_id is unique per event to avoid accidental deduplication of separate actions.
‍
Debugging:
Regularly monitor deduplication in TikTok Events Manager and resolve mismatches promptly.

Useful resources