TikTok Events API Integration with Leeloo.AI
UA | US | RU |
|---|
Sending server events to TikTok Ads provides businesses with a more accurate signal about real user actions within the Leeloo.AI platform. This directly affects the quality of optimization and the economics of your campaigns.
Better ad optimization: the TikTok algorithm receives conversion events and more accurately finds the audience performing the target action.
More stable data: server event transmission is less dependent on blockers, browser restrictions, and client tracking losses.
Lower lead cost: thanks to higher quality signals, campaigns reach effective connections faster and yield lower CPL.
Better scalability: when events are transmitted correctly, it's easier to scale budgets without a sharp drop in lead quality.
More transparent analytics: businesses get a fuller picture of the path from click to conversion and can make decisions based on actual data.
As a result TikTok Events API combined with Leeloo.AI is not just a technical integration but a tool to increase ROMI, improve lead quality, and ensure stable growth in advertising results.
1. Introduction
This guide will help you:
Set up TikTok Events API integration with Leeloo.AI.
Send server events to TikTok Ads Manager.
Test events and verify connection correctness.
After completing the steps, you will be able to send server events from Leeloo.AI to TikTok Ads.
2. Key Terms
TikTok Events API — server-side event transmission channel in TikTok.
Pixel ID — unique identifier of the data source in TikTok.
Access Token — token for request authorization.
Test Event Code — code for testing events in Events Manager.
Event Type — conversion action (e.g., ViewContent, AddToCart, CompletePayment).
LGT (mini-landing) — source from which event context is sent in Leeloo.AI.
Fallback — backup value if the lead variable is missing.
3. Before You Start
You need to:
Register a TikTok account.
Log in to TikTok Ads: https://ads.tiktok.com/
Have access to Leeloo.AI.
It is recommended to:
Define the list of events to transmit.
Determine the required lead variables.
Check that keys/tokens have no extra spaces.
4. Step-by-Step Guide
Step 1. Go to Events Manager
In TikTok Ads go to Tools → Events Manager.
Step 2. Create a Data Source
Click Connect Data Source. Choose Web.
Step 3. Choose Setup Type
Skip the URL step. Choose Manual Setup. Select Events API.
Step 4. Get Connection Data
Enter the source name.
Choose a template (e.g., Application submission).
Copy the Pixel ID.
Generate and copy the Access Token.
Step 5. Copy the Test Key
Go to Test Events.
Copy the Test Event Code from the right window.
Step 6. Go to Leeloo.AI
Log in to the Leeloo.AI platform.
Go to Settings → Ad Analytics.
Select TikTok and click Add.
Step 7. Add TikTok Connection
Fill in the fields:
Name - specify the Connection Name on the Leeloo.AI platform
Pixel ID - insert the Pixel ID copied earlier (Step 4). Or under the name of your Data source in the TikTok ADS cabinet.
Access Token - insert the Access Token from your previously copied Data source (Step 4). Or in the Settings tab of your Data source, in the Events API.
Test Code - insert the copied Test Event Code from the Test events section in your Data source (Step 5).
Click Save.
Step 8. Adding Events
Click on the name of the connected DataSet.
Click Add Event (Add Event).
Specify:
Event name on the platform.
Event type.
Link to LGT (mini-landing) or your personal website.
Event data.
If you need to substitute values from the client card, select the required variable from the lead card variables list, click the blue plus (+).
Choose the variable and set a fallback (e.g., null).
Step 9. Check the Test Event
After creating and filling in the fields, click OK — the test event is sent immediately.
Check it in TikTok Ads → Events Manager → Test Events of your Data source.
Sending Events from the Leeloo.AI Platform
In LGT:
Open your LGT, go to the "Traffic" tab
Click the "Add Event" button
Specify:
1. Action type - "subscription"
2. In the "Analytics" field, specify the previously created TikTok analytics
3. Specify the created event you want to use to track the subscription to the bot.
4. Click the "Save" button
In Offers:
Go to Sales Tunnels → Offers → Select the category of the desired offer
Go to the offer to which you want to add analytics
Open "Ad Analytics". Click "+ Add Event"
Select:
1. The "Action Type" you want to transmit
2."Analytics", which you previously connected from TikTok
3. Select the event you previously set up for the offer
4. Click the "Save"
In the Sales Tunnel:
Go to Sales Tunnels → Select the desired tunnel
Right-click (for Windows)/two-finger tap on the touchpad (for MacOS) on an empty space next to the LGT from which you want to transmit analytics, select "Action"
Select the created block. Choose "Ad Analytics"
Select:
1. In the "Analytics" field, the previously created analytics
2. In the "Event" field, the previously created event
3. Click the "Save" buttonConnect the "Action" block to the desired block
Conclusion
After completing all the steps, the TikTok Events API integration with Leeloo.AI is fully ready to operate.
From now on, server events will be correctly transmitted to TikTok Ads Manager, providing the business with more accurate conversion signals for ad optimization.
This will allow:
• improving the quality of ad campaign training;
• increasing the accuracy of analytics for key user actions;
• reducing the cost of target actions through optimization based on real events.
We recommend regularly checking Test Events and the correctness of field transmission after changes in Tunnels or forms of Leeloo.AI