How to Set Up Events and Parameters with Events Builder

You can set up web events using custom code Pixel and Events API. If you need an alternative solution that doesn't require heavy technical resources, you can use our Event Builder tool for event setup after you create and add the TikTok Pixel base code to your website.

Before you begin

• Ensure that all of your webpages have the TikTok Pixel base code installed.

• Make sure you have edit permissions for the pixel.

• If Content Security Policy is enabled on your website, see developer documentation for additional setup recommendations

How to set up events and parameters with Event Builder

Once you've added the TikTok Pixel to your site:

1. In Select Setup Method, choose Event Builder.

2. Enter your business URL and click Launch Event Builder. The event builder will launch on your website in a new tab.

3. Click Add event

4. Select whether you want to add events via button clicks or URL visits.

   • Button Clicks: Measure when a specific button or element is clicked. The event builder highlights clickable buttons and elements, such as add to cart button, search field, etc. Click the button or element you would like to measure or optimize

   • URL Visits: Measure when a URL with specified keyword is visited. For instance, when a user reaches a page with "/product" in the URL, you can set up the event as "ViewContent" to measure and optimize all visits to URLs with "/product" keyword. This method helps track actions on pages with consistent URL keywords, like product detail pages, order confirmation page, or thank you page after a purchase

To create event buttons:

1. In Event Builder, choose Add event, and click on Button Click, then Next.

2. Click on the desired highlighted element on the webpage and click Next.

3. Select the event type from the dropdown menu that best describes this user action, eg. AddToCart.

4. Add parameters such as 'Value', 'Currency', 'Content ID', and 'Content Type' and click Confirm to save your changes.

   • Elements for 'Value' will be highlighted on your webpage, and you must set the 'Currency' in the dropdown.

   • Elements for 'Content ID' on your webpage, and you must set the 'Content Type' in the dropdown

     • 'Content ID' needs to match 'SKU ID' in your catalog if you are using Video Shopping Ads

5. Click Add Event to setup additional events on your webpage.

6. Once you are done, click Finish Setup. Your changes may take up to 30 minutes to be effective.

To create events from URL:

1. In Event Builder, choose Add event, and click on URL Visits, then Next

2. Select the event type from the dropdown menu, eg. 'CompletePayment'

3. Specify the URL keyword for the page you wish to measure, such as 'thankyou'.

4. Add parameters such as 'Value', 'Currency', 'Content ID', 'Content Type' and click Confirm.

   • The tool will highlight elements for 'Value' on your webpage, and you can set the 'Currency' in the dropdown

   • The tool will highlight elements for 'Content ID' on your webpage, and you can set the 'Content Type' in the dropdown

5. Click Add Event to setup additional events on your webpage.

6. Once you are done, click Finish Setup. Your changes may take up to 30 minutes to be effective.

Note: To use advanced ad solutions such as ROAS reporting and value optimization, ensure you add 'Value' and 'Currency' parameters to your events. To use Video Shopping Ads and Catalog Management solutions, ensure you add 'Content ID' and 'Content Type' parameters to your events.

Learn more about web diagnostics or Pixel Helper for troubleshooting support if you encounter issues.