Recognizing the diverse requirements of our user base, we're thrilled to unveil a feature that empowers you to switch between product_id and variant_id values as needed. With this enhancement, you have full control over tracking events when utilizing the TikTok Pixel through OnePixel. This functionality allows you to optimize your data collection, ensuring accurate tracking based on your specific business needs.

Table of Contents

Understanding OnePixel's Tracking Events
The Power of Switching Between product_id and variant_id
Default Settings for Tracking Events
How to Toggle Between product_id and variant_id
Customizing Events Automatically and Manually
Important Considerations

Understanding OnePixel's Tracking Events

OnePixel supports multiple tracking events that help businesses monitor user interactions and conversions through TikTok Pixel. These events are crucial for understanding customer behavior, optimizing ad targeting, and improving return on investment (ROI).

The Power of Switching Between product_id and variant_id

With this new feature, you can easily toggle between product_id and variant_id for each supported event. This flexibility ensures that you collect the most relevant data for your tracking and marketing strategies. Additionally, you have the option to restore events to their default settings or customize them further to align with your unique tracking needs.

Default Settings for Tracking Events

By default, the following tracking events are enabled with variant_id:

- ViewContent - ON - variant_id
- AddToCart - ON - variant_id
- InitiateCheckout - ON - variant_id
- AddPaymentInfo - ON - variant_id
- PlaceAnOrder - ON - variant_id
- CompletePayment - ON - variant_id
- Purchase - OFF - variant_id
- Search - ON - variant_id

These settings can be adjusted based on your preference, allowing for precise tracking control.

\

Note: The handling of the "AddPaymentInfo" event is only managed through the Server-side API, not on the Browser.
When an event is disabled, neither the server nor the browser will track it.

How to Toggle Between product_id and variant_id

Switching between product_id and variant_id is straightforward:
Access the Tracking Settings: Navigate to your OnePixel settings dashboard.
Select the Event to Modify: Choose the specific event you want to update.
Toggle the Identifier: Switch between product_id and variant_id as required.
Save Changes: Confirm your updates to apply the new tracking settings.
Test the Configuration: Use testing tools to ensure events are firing correctly with the selected identifier.

Customizing Events Automatically and Manually

You can further enhance tracking by:
- Automatically Connecting Pixels: Streamline event customization by letting OnePixel intelligently configure event tracking.
- Manually Adjusting Event Settings: Gain full control by specifying unique tracking requirements for each event.

Important Considerations

- Handling of the "AddPaymentInfo" Event: This event is managed solely through the Server-side API and is not tracked on the browser.
- Impact of Disabling an Event: When an event is turned off, it will not be tracked by either the server or browser, ensuring compliance with your data collection strategy.


With the introduction of the ability to switch between product_id and variant_id, OnePixel provides a more flexible and efficient way to track events using the TikTok Pixel. Whether you're looking for granular product tracking or a more streamlined approach, this feature gives you full control over your data. Start customizing your tracking today to optimize your ad performance and business insights.

If you have any question, don't hesitate to contact us via live chat or email us at support@socialhead.io.

Updated on: 21/03/2025