This guide walks you through connecting TikTok Ads with Swaarm - from creating a dataset in TikTok Events Manager to configuring your TikTok Partner in Swaarm.
Step 1 - Connect your TikTok Ads account to Swaarm
In Swaarm, go to Marketplace → Partners
Find TikTok and click Connect with TikTok
You will be redirected to TikTok to sign in (if not already signed in). Enter your credentials and log in
The next screen shows the details of the integration.
❗Do not change anything here - click Confirm
Once authorization is approved, the TikTok Partner will be automatically created under your Partners tab and you will be redirected to the partner page
❗ No further action is needed on this page.
Here you will add the Test Event Code from Step 2 (point 12) and test the event
Next, go to the Store App page → Edit → Integration → SAN Attribution → TikTok, and add the TikTok Pixel ID and Access Token
ℹ️ You will generate these values in Step 2 below (point 10) - complete Step 2 first, then return here to fill them in.
Step 2 - Create a dataset in TikTok Ads Manager
Follow the steps below to add the dataset to your TikTok Ads Manager account.
Go to TikTok Ads Manager
Open Events Manager under Tools from the top menu
Click Connect Data Source in the top right of the Events Manager overview page
From the Connect data source menu, select Web and click Next
You can skip the step to add a website URL - click Next to continue
Set the data connection method to Manual
Set the connection method to Events API
Name your pixel — use the format Swaarm_<YOUR COMPANY NAME> (e.g.
Swaarm_YourCompany) - and click CreateOn the Set Up Your Business Funnel page, select the Pre-order Submission template, then configure the event parameters as follows:
On the left side of the Funnels, events, and parameters table, select Complete Registration as the conversion event
On the right side of the table, select the following fields:
General - currency, event_id, value
Events API Only - event_time
Customer Information Parameters - external_id
Events API Only - ttclid, ip, user_agent
Click Next
On the Implement Events API page:
Copy the Pixel ID and add it to the TikTok integration field in the last action of Step 1 (point 7)
Click Generate Access Token, copy the token, and add it to the TikTok integration field in Step 1 (point 7)
❗ Copy and save the Access Token immediately after generating it - it will not be shown again.
Click Next
On the Testing page, click Finish to complete the setup
On the overview page of the data source you just created, go to the Test Events section:
Copy the Test Event Code from under Test server-side events (Events API) and add it to the field in Step 1 (point 6)
Test the event
❗As per TikTok, it may take up to 30 minutes for your event to show up.
Step 3 - Create a SAN Campaign in Swaarm
Step 4 - Create the ad campaign in TikTok Ads Manager
Now you are ready to create the campaign.
In TikTok Ads Manager, create a new campaign and select Lead Generation as the advertising objective
Configure the remaining campaign settings (name, budgets) as needed and click Continue on to the Ad group
At the Ad group level:
Name the ad group
Set Optimization and bidding location to Website and Optimization goal to Leads
Under Data connection, select the data source created in Step 2
❗ If the data source is not available to select, send a few standard events to TikTok from the Swaarm panel first, then wait up to 30 minutes for TikTok to activate the data source.
Set the Optimization event to Complete Registration and set a Target CPA
Configure the remaining ad group settings - bid strategy, schedule, targeting, and placements, as needed
Click Continue to proceed to the Ad level
At the Ad level:
Set the destination to Website
Under Website URL, paste the link copied from Step 3 (point 4)
Add the remaining creative assets and details as needed, then publish the campaign
What happens next?
Once Swaarm starts receiving data from TikTok:
An offer is created automatically in Swaarm for each TikTok campaign
All stats - installs, events, and cost - are recorded under the respective offer in Swaarm