Skip to main content

TikTok Pixel

The TikTok pixel allows you to track and optimize your TikTok ad campaigns.

Updated over a month ago

⭐ Available in the following bundle: Core Bundle (incl. in all plans)

⭐ Available on the following plans: Basic, Pro, Agency, Business

👀 Not sure which plan you're on? Check your subscription here.

The TikTok Pixel, just like the Meta Pixel, lets you collect data that helps to track conversions from TikTok ads, build targeted audiences for future ads and remarket to people who have already taken some kind of action in your heyflow.


Set Up

Step 1: Create and Set Up TikTok Pixel

  1. Access TikTok for Business and create an account. This should take no longer than 3 minutes.

  2. Once you’ve created an account, you will see the TikTok Ads Manager dashboard. In your dashboard, click on “Tools” and then “Events” under Management.

  3. Click the “Connect Data Source” button to create your Pixel. In the next window, select “Web” as the data source. You can optionally enter the link to your funnel or skip this step.

  4. Then choose Manual Setup as the data connection method. Click “TikTok Pixel” and “Next.” Here, you need to give your Pixel a name.

  5. In the next step, you can install the installation code. To get your Pixel ID, you can find it in the code snippet after ttq.load:

  6. Alternatively, you can simply click “Email Pixel Code,” which will open a window where you can also find your Pixel ID.

Step 2: Add Pixel to Heyflow

  1. Copy the Pixel ID and go back to your heyflow.

  2. Go to the "Connect" tab and head to "Tracking". Scroll down to "TikTok Pixel" and paste the ID there. Click on Connect.

  3. Don’t forget to save the changes and republish your funnel afterward!

Step 3: Finalize and Test

💡 Tip: Install the TikTok Pixel Helper extension, which will show you right away whether the events in your funnel are being tracked or not.​

  1. Go back to TikTok to complete the setup, click “Next,” and then click “Finish” in the bottom-right corner.

  2. Test your event to make sure everything is set up correctly. In your TikTok Ads Manager, go to “Test Events,” enter the URL of your Heyflow, and click “Open Website.”

  3. Now, submit a response in your flow. If you have the TikTok Pixel Helper installed, you will notice that the events are already being tracked and displayed in the extension.

  4. After your test, you should see event activities such as “View Content,” “Button Click,” or “Submit Form” in your TikTok Ads Manager.

  5. Congratulations! This means your Pixel is now successfully connected to your funnel, and you can start running TikTok ad campaigns!


Events

Default Events

Heyflow automatically tracks and sends the following standard TikTok Pixel events:

  • ViewContent: Triggered when a page is viewed in a flow

  • Lead: Triggered when the submit button is clicked

These are native TikTok events and can be used for conversion optimization in TikTok Ads Manager.

Custom Event Tracking

You can define custom events in Heyflow (i.e. when users click on a continue button or select a multiple choice option).

How to Track Custom Events:

  1. Open the Build tab in your flow.

  2. Select the block you want to track.

  3. In the right sidebar, go to Settings.

  4. Toggle Tracking.

  5. Enter an event name. If the event name matches a Meta Standard Event (e.g., Contact, ViewContent, Subscribe), Meta will classify it as such. Otherwise, it will be recorded as a Custom Event.

All custom events are sent to TikTok as the generic clickbutton event, regardless of the event name you assign.

  • Your custom event name (e.g. lp-button-3) is passed as metadata (under content_id)

  • In TikTok Events Manager, you’ll see the event listed as clickbutton, and must click into it to view the custom metadata

  • TikTok Ads Manager does not support optimization based on this metadata

Therefore, custom events cannot currently be used for conversion optimization in TikTok Ads. Only the standard ViewContent and Lead events can.


Troubleshooting

I don't see any events

There may be several reasons for this:

  • Changes not published yet: First, make sure that your flow has been republished after you have made changes to the integration.

  • Cookies declined: The pixel does not work if a user has declined the tracking cookies. Make sure you accept the cookies to see your test events, for example, or try again in a different browser.

💡 Tip: Use the TikTok Pixel Helper. This is a plugin that checks websites for installed TikTok Pixels and inspects the correct implementation.

Did this answer your question?