TikTok Events API Setup


You can benefit from 2 different methods in the SignalSight TikTok Events API creation process. The first is automatic setup and the other is manual. With automatic setup, you can speed up the process and complete the tracker creation process more easily.

Please follow these steps to install TikTok Events API on Signalsight:

1. Automatic Setup

You can take advantage of automatic TikTok installation in either an existing tracker or in the tracker creation wizard. If you're creating a tracker for the first time and don't have one yet, you can initiate the setup process using the tracker creation wizard.

You can enter your website address by selecting Website Javascript in the source creation, which is the first step of the Wizard. After you enter your site address, you can save the source and proceed to the next step.

Source Step

In the new step, you can click the + Add Destination button, select the TikTok pixel from the Destination list, and then click the Create with TikTok button, where you can automatically install. After logging into your TikTok account, you will see a window like the one in the image.

Adding Destination Step

To prepare your TikTok Pixel, first select your advertiser account and then choose the Pixels associated with it from the current window. After that, proceed to the Destination step and select the TikTok Events API from the list. To add another destination, click on "+ Add Destination" again. You should make this destination ready by selecting Advertiser and pixel again. In the last step, you can complete the wizard by giving the tracker a name.

Create With TikTok Advertiser and Pixel

If you already have a tracker, click Trackers on the left sidebar. Next, navigate to the tracker where you want to add the integration, and on the right side of the tracker detail page, add two new destinations. Click "Add New Destination," then select "Create a new" in the pop-up. From the list, select "TikTok Pixel" and click "Create with TikTok." After selecting the advertiser and pixel information, click "Create" to add your destination to the tracker.

Tracker information

To select the TikTok Events API from the list, click "Add New Destination" and create a new one. Then, use "Create with TikTok" to establish the server-side connection in the tracker, including the advertiser and pixel information. With this, your tracker will be ready and you can move on to the GTM/Frontend Code Activation Transactions stage.

2. Manual Setup

Aside from automatic setup, you can also opt for manual setup using the TikTok pixel ID and access token creation method.

2.1 Tiktok Pixel Creation

  1. Login to your Signalsight.io account.
  2. If you already have a tracker on Signalsight, you can go to Trackers from the left menu otherwise you can use the wizard to create a new tracker.
  3. Click on the tracker that you want to add a Tiktok destination.
  4. Click the "Add New Destination" button to add your Tiktok pixel.
  5. Tracker Detail
  6. Select "Tiktok Events API" as "Destination Type" from the screen that opens and enter your Tiktok Pixel ID and Access Token information. Please refer to the NEXT STEP to see how you can create Access Token

2.2 How to Find Pixel ID on Tiktok Ad Manager?

You can find your Tiktok Pixel ID on your Tiktok Ad Manager using following path:

Tiktok Ad Manager >> Events >> Pixel ID

TikTok Ad Manager

Copy Pixel ID and paste it into the “Create Destination” screen.

Tiktok Pixel

2.3 Tiktok Events API Creation

Click the “Add New Destination” button again to add your Tiktok server-side API connection.

create destination

Select "Tiktok Events API" as "Destination Type" from the screen that opens and enter your Tiktok Pixel ID and Access Token information.

Tiktok Web Api

2.4 TikTok Generate Access Token

To create a TikTok Events API access token, access the Pixel settings screen and follow the appropriate procedures:

generate access token

You can activate the “Automatic Advanced Matching” option for more matches. (optional)

advanced matching

Click the “Generate Access Token” button.

Copy the text of the generated Access Token and paste it into the designated field.

tiktok access token

5. GTM/Frontend Code Activation Transactions

Caution! Familiarity with Tag Manager is necessary for this step. If you are not the designated tag manager, please seek assistance from the appropriate parties.

To view your TikTok tags, navigate to your Tag Manager application and search for "TikTok tags" (ttq).

gtm tiktok

Select the “Tiktok Base Code” tag and disable the lines starting ttq.load and ttq.page with the // sign (comment-out), then press the “Save” button.

tiktok base code

Stop all your other Tiktok tags by going into detail and clicking the "Pause" button.

tiktok ttqs

6. Signalsight - Activating TikTok Script

Locate your active Signalsight tags by searching for "p2sq" on the Tag Manager screen. To view all tags containing "p2sq" click the "View more results" button.

tag manager

In the line where the Signalsight loader code is loaded, add the phrase “-tt” after the version information.

gtm tt tags

Include the "-tt" characters in the Signalsight loader code:

loader tt tags

Verify that your TikTok server-side events are activated by clicking the "Preview" button, to confirm that the modifications you have made on the tag manager screen are accurate.

tagmanager preview

You can use the Tiktok Pixel Helper tool for testing.

tiktok test

Consent management and data privacy

To stay compliant in regard to data protection, you should only activate script if users given consent within your Consent Management framework.

Contents

About SignalSight

SignalSight is an experienced tech solution who strives to connect brands with their customers like never before.

About SignalSight Server-side Signal Success Stories Pricing Docs Contact Us

Privacy Policy | Terms & Conditions