Overview

If you're running a TikTok campaign in your own account for a Swaarm MMP client, here's your guide. It comes down to three steps:

ℹ️ If instead the advertiser is connecting their own TikTok account directly to Swaarm, use this guide: Running App Campaigns on TikTok with Swaarm MMP instead.

Step 1 - Create Your TikTok Dataset

In TikTok Ads Manager, open Events Manager under Tools
Click Connect Data Source, select Web, click Next
On the Add your website screen, click Skip, don't add a website URL here
Set the connection method to Manual, then Events API
Name your pixel (e.g. Swaarm_<AdvertiserName><AppName>) and click Create
On the Set Up Your Business Funnel page, select the Pre-order Submission template, then configure the event parameters as follows:
1. On the left side of the Funnels, events, and parameters table, select Complete Registration as the conversion event
2. 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
ℹ️ To add custom event click '+' sign next to conversions and add your custom event for eg. first_purchase. And add such Event parameters configuration:
- General - currency, event_id, value
- Events API Only - event_time
- Customer Information Parameters - external_id
- Events API Only - ttclid, ip, user_agent
On the Implement Events API page, copy the Pixel ID, then click Generate Access Token and copy it immediately, it won't be shown again
❗Copy and save the Access Token immediately after generating it - it will not be shown again.
On the Testing page, click Finish

ℹ️ As per TikTok, it may take up to 30 minutes for your event to show up.

In Partner Platform, go to Offers, select the relevant offer
Go to the TikTok tab below
Enter your Pixel ID and Events API Access Token from Step 1
Map Your Events in Event Mapping
Left side - the event as defined in your app (e.g. Install, Open, Reinstall)
Right side - the Conversion name from the TikTok data source you created in Step 1. Paste the corresponding ID into each field
Click Save
Fire a Test Event - TikTok requires at least one live event before it treats a data source as active. Under Fire Event, select a mapped event and click Fire Event to send a real production event to your pixel.
Get Your Tracking Link
At the top of the TikTok tab, copy the Tracking Link. It carries TikTok's own URL macros.

Link example: https://pb.fourpawns.net/click?offer_id=123&pub_id=45&site=tiktok&campaign_id=__CAMPAIGN_ID__&campaign=__CAMPAIGN_NAME__&adset_id=__AID__&adset=__AID_NAME__&ad_id=__CID__&ad=__CID_NAME__&placement=__PLACEMENT__&ttclid=__CLICKID__
❗Don't edit the __...__ macros, TikTok fills these in automatically when your ad serves.

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 1
  ❗ 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 2 (last point - 7)
- Add the remaining creative assets and details as needed, then publish the campaign