TikTok and RedTrack
TikTok is a social media platform for creating, sharing and discovering short videos.
TikTok has an API integration with RedTrack, which allows you to:
- pass all the conversion data back to TikTok.
- pause non-converting creatives and campaigns directly on the TikTok side, with no manual work.
- auto update your cost data.
Integration
Important before you start
Before you proceed with the integration, make sure you already have:
1. Added custom tracking domain.
2. TikTok pixel and access token.
PixelId – identifies where the conversion is going (e.g.: ABC123XYZ789).
PixelKey – API key for pixel access.
EventName – type of conversion defined by matching types of conversions between RedTrack and TikTok (e.g.: purchase).
EventTime – time for conversion action (it’s recorded in UTC and taken from the created_at conversion value).
ClickId – click in TikTok (e.g.: EAIaIQobChMI3oztgOuugQMV1uLtCh1Q8A2tEAAYASAAEgIe8PD_BwE).
Page – value for the page field from your conversion.
Referrer – value for the referrer field from your conversion.
Phone – hashed phone value taken from the sub parameter with the assigned Phone role (Offer source → Additional parameters).
Email – hashed email value taken from the sub parameter with the assigned Email role (Offer source → Additional parameters).
IP – value for the IP field from your conversion.
UserAgent – value for the UA field from your conversion.
ContentType – hashed value taken from the sub parameter with the assigned Content Category role. e.g.: Entertainment (Offer source → Additional parameters).
Contents – hashed value taken from the sub parameter with the assigned Contents role (Offer source → Additional parameters).
Currency – a constant USD value.
Revenue – conversion sum (in USD), value for the revenue_default field from your conversion.
To get your pixel and access token from TikTok, do the following:
1. If you already have a pixel for your website, copy it from the settings:
2. Stay in the Settings → scroll down → Generate Access Token → copy the created token.
If you don’t have the pixel you’ll need to create it first:
1. Go to Assets → Events:
2. Web Events → Manage:
3. Set Up Web Events at the top left corner:
4. In the pop-up windows give your pixel a name → Events API → Manually Set Up Events API → Next
5. Go to settings:
6. That’s it, your pixel has been created. Copy the Pixel ID:
7. Stay in the Settings → Generate Access Token → copy the created token.
Setup in RedTrack
1. Add Tiktok as a Traffic channel in RedTrack.
Traffic channels → New from template → Add → Save the template:
2. Integrate RedTrack with your TikTok account.
- Go to the saved TikTok template → TikTok API integration → Connect TikTok:
- Log in with the email that gives you access to the target ad account → Confirm to accept the integration permissions → select the TikTok ad account from the drop-down list:
3. Add Offer & Offer source (if you are an affiliate) / Brand & Website (if you are an advertiser).
To send the PII data for better attribution go to the added Offer source/Brand → Additional parameters → add the following tokens and assign the relevant roles to them:
Parameter | Macro / Token | Name / Description | Role (the role should be selected from the drop-down) |
Phone | {r} | phone | Phone |
Email | {r} | email | Email |
ContentType | {r} | contenttype | Content Category |
Contents | {r} | contents | Contents |
4. Add conversion types to RedTrack.
Tools → Conversion tracking → Conversion types → use this guide to help you add the events.
5. Fill in the default data source in the traffic channel settings.
- Pixel ID – add your TikTok pixel ID
- Access Token – add your access token from TikTok
6. Set up the mapping for your conversion events in the traffic channel settings.
- Conversion type: your RedTrack conversion types
- Event name: the TikTok event name you want to match your RedTrack conversion type
7. Create a Campaign in RedTrack.
1. Create a campaign in RedTrack using this guide. Once the campaign is created, all the tracking links and the parameters for the script will be generated automatically and include all the supported macros.
2. For TikTok tracking you will need to use the tracking script. Follow this guide to choose the one that suits your needs better and set it up.
You will have to use our script on the page code.
The tracking parameters are to be added to the TikTok campaign. You will need to use the “universal script” or “no-redirect” tracking parameters later depending on the type of script you have chosen before. Copy them and save for later:
3. Enable Auto-update costs toggle to receive costs automatically:
1. Create a campaign in RedTrack using this guide. Once the campaign is created, all the tracking links and the parameters for the script will be generated automatically and include all the supported macros.
2. For TikTok you will need to use our universal tracking script (created automatically once you’ve added the Website) on the page code or for your e-commerce store.
The tracking parameters are to be copied and saved for later.
3. Enable Auto-update costs toggle to receive costs automatically:
8. Set up the automation.
Setup in TikTok
1. Launch a Campaign in TikTok
TikTok Ads Manager structures ads into three parts: Campaigns, Ad groups, and Ads. Creating a campaign is the first step where you will need to set up your advertising objective, campaign name, and budget. Please use the dedicated TikTok guide on creating Campaigns and handling settings within ad groups, and ads.
2. To finish integrating TikTok with RedTrack go to Ad → Ad details → insert your landing page/website URL + the tracking parameters from your RedTrack Campaign in the URL field: