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.
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.
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.
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.
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
- Login to your Signalsight.io account.
- 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.
- Click on the tracker that you want to add a Tiktok destination.
- Click the "Add New Destination" button to add your Tiktok pixel.
- 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
Copy Pixel ID and paste it into the “Create Destination” screen.
2.3 Tiktok Events API Creation
Click the “Add New Destination” button again to add your Tiktok server-side API connection.
Select "Tiktok Events API" as "Destination Type" from the screen that opens and enter your Tiktok Pixel ID and Access Token information.
2.4 TikTok Generate Access Token
To create a TikTok Events API access token, access the Pixel settings screen and follow the appropriate procedures:
You can activate the “Automatic Advanced Matching” option for more matches. (optional)
Click the “Generate Access Token” button.
Copy the text of the generated Access Token and paste it into the designated field.
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).
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.
Stop all your other Tiktok tags by going into detail and clicking the "Pause" button.
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.
In the line where the Signalsight loader code is loaded, add the phrase “-tt” after the version information.
Include the "-tt" characters in the Signalsight loader code:
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.
You can use the Tiktok Pixel Helper tool for testing.
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.
