All Collections
Syncing Events to Destinations
Sync events with TikTok Conversions API
Sync events with TikTok Conversions API

Learn how to enrich your data on TikTok and reduce customer acquisition costs.

Apoorva Wate avatar
Written by Apoorva Wate
Updated over a week ago

The TikTok conversions API connects an advertisers marketing data from different sources to TikTok. This data is used for conversion optimization and retargeting of ads to the right people. These enhanced events help drive a higher ROAS ad reduce CPC, CPM for advertisers on TikTok.

Benefits of using the TikTok CAPI

  1. The TikTok CAPI receives both front end and back end events, whereas the pixel often captures events only from the front end. This reduces any data gaps while enriching ad audience and targeting data.

  2. With Lifesight’s Shopify SDK, the back-end events from Shopify stores and associated integrations (reviews, subscription additions, add to wishlist etc.) are captured more accurately and sent to TikTok to enrich the ad sets.

  3. You can further enrich the data using the contact’s attributes which are recorded via Lifesight’s First-Party Identity Graph

Prerequisites to setting up the TikTok CAPI

In order to set up your CAPI, you will need the following from your TikTok account

  1. TikTok Pixel that is connected to the website and its Pixel ID

  2. An API access token

The below section will walk you through the process of finding those in the Events Manager on TikTok.

Setting up your TikTok pixel

In case you haven’t set up a TikTok pixel already, here’s how you can get started:

  1. Go to TikTok Ads manager

  2. After logging in, hover over "Tools" on the navigation bar, and find "Management", then click on "Events".

  3. Click on the "Manage" button under "Web Events".

  4. Click on the "Partner setup" button under "Web Events".
    Note: Selecting Partner Setup takes you to a page where you can select different supported TikTok partners for your integration, such as Shopify and Google Tag Manager. You will be able to see Lifesight as one of the Partners under CDP.

  5. Click on the "Lifesight" to set up the Pixel integration.

  6. Create an overarching Pixel Name that will hold events regardless of the integration method you end up selecting later on (namely, Pixel, Events API). Make sure to give your pixel a name- The maximum character length is 128 characters, including spaces.

  1. Locating the TikTok Pixel ID

    If you have already had a pixel created and have Pixel ID and Events API Access Token, skip this step and jump to the Lifesight section.

    1. Login to your TikTok Business account and navigate to Tools

    2. Head to Events > Web Events > select a pixel > Settings tab.

    3. At the top, you will find your Pixel ID. Copy and save the Pixel ID.

  2. Locating your TikTok API Access Token

    1. In the same window as your 'Settings' scroll down to click "Generate Access Token".

    2. Copy and save the token information shown.

Now, you should have both your Pixel ID and Access Token. For example, they should look like the following:

  • Pixel ID: CKBJ113C77UA008MM2H0

  • Access Token: 7aea389xxxxxxxxxxxxxxxxxxxxxxxx1991af

You can head over to Lifesight now to finish the rest of the steps to set up the Tiktok Integration in Lifesight Integrations module.

Steps to configure the events API on Lifesight

  1. Set up the TikTok Authentication and Ad Account

    1. In the Integrations module on Lifesight search for Tiktok integration and click on Connect.

    2. Once you have finished authentication for your TikTok account we specify the permissions needed for the TikTok integration to be set up at Lifesight. You can confirm once you have verified the permissions setup.

    3. Choose the TikTok Ad account that is being connected to Lifesight for sending the Web and Offline Events.

  2. Set up the Events and TikTok Pixel settings

    You'll need a Pixel ID and an API Access Token from the TikTok Set up sections to set up this module. Apart from this you will need to know all events being configured during your Web SDK set up and what out of those you need to send to TikTok. Lifesight and TikTok recommend all standard events in its default configuration settings.

    1. Enter the Pixel Id and TikTok Access Token from the TikTok Set up section.

    2. You can generate the Test Pixel from the TikTok section below and send Test code to test and validate events on Tiktok Events Manager.

    3. Select the default event settings or pick and choose the events that you wish to send using TikTok Events API integration.

    4. Once configured, TikTok will appear as active in your Integrations module.

Steps to Validate Events API on TikTok and Lifesight

Test event codes are special codes you can include in your event payload to simulate events. This allows you to test your API implementation without actually recording real event data.

You can optionally enter a test event code as part of your sync configuration. Navigate to Events Manager by clicking the Assets tab, Event and then Manage Web Events. You can find your test event code in the Test Events tab. Verify that events are configured and triggered correctly through Test Events.


  1. In Events Manager, click the pixel to view its configuration details.

  2. In the Test Events tab, click the test code button in Step 2 of the Test Server Events section to copy the code.

  3. Follow steps from the previous section and trigger a test event.

  4. Go to the Test Events tab of the pixel in Events Manager, and look for the test event in the Event Activity section. Any issues with the payload will show up to help you resolve the issues.

Events passed using the TikTok CAPI

When setting up the TikTok CAPI, Lifesight passes some events on to the channel as default data points, with an option to add more. The comprehensive list is a s below:

  1. User Data

  2. Search Results List View

  3. Product Detail View

  4. Cart View

  5. Checkout Step

  6. Product Add to Cart

  7. Search results List View

  8. Collection List View

  9. Product List View Click

  10. Product Add to Cart form

  11. Product Removed from Cart

  12. Cart reconciliation

  13. Checkout Complete

Further reading

If you’re looking for more information, we recommend you go through the following resources:

Did this answer your question?