How to configure TikTok Events API Gateway

 

1. Create a TikTok Events API Gateway on Stape.

 

1.1. Create an account or log in to Stape. Click on “Create Gateway” in the TikTok section.

 

 

1.2. Write in the gaps:

 

• Gateway name. You can create a random name.  
• Admin email. This email will be used to manage your TikTok Events API Gateway and can be different from your Stape account email. It should be unique for each Gateway.
• Server location. Select a location closer to your website visitors. 

 

Click “Create TikTok Events API Gateway”.

 

 

1.3. Choose a subscription plan. Stape offers:

 

• 7-day free trial.
• Pay as you go plan - 10$/month per Pixel.
• Ultimate plan - 100$/month for 100 Pixels.

 

1.4. Wait till the status of your gateway is “Running”.

 

 

2. Connect your Pixel.

 

2.1. Click on “Finish TikTok Gateway setup”. You will be redirected to the login interface of TikTok Gateway.

 

 

2.2. In the Events API Gateway hub click on “View details” and then - “Connect Data Source”.

 

2.3. Choose the account and Pixels you’d like to connect and confirm your choices.

 

 

2.4. You will see the added pixel in your dashboard.

 

 

3. [Recommended] Load TikTok js from your subdomain.

 

This will help you increase the protection of your events from ad blockers.

 

After validating your Data routing domain you will see a link that you can use to download TikTok js on your site. Click on “View base code” and copy the snippet.

 

 

4. [Optional] Add new Pixels.

 

You can use a single TikTok Events API Gateway to set up multiple TikTok Pixels. Additionally, Pixels from various TikTok Business Accounts can be connected to the same Events API Gateway, provided you have admin access to all the Pixels. 

 

The process is straightforward: configure your TikTok Events API Gateway, then add new Pixels through the hub interface. Simply click on “Connect data source”.

 

 

5. Test your setup.

 

As mentioned before, TikTok Events Gateway uses web events to route them via the server. 

 

Within 30 minutes of connecting your pixel to the TikTok Events APIG hub, you should notice that the event count is no longer zero, and you should also see the names of the events that have been received. 

 

 

You can also verify that events are sent correctly to the TikTok Events APIG hub by checking the website console:

 

1. Open your browser developer network tab on your site.
2. Check that events were sent to your Events API Gateway URL (look at the screenshot below).