TikTok and RedTrack
Info
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.
Parameters sent to TikTok upon conversion creation
The following parameters are sent to TikTok upon conversion creation:
Parameter | Description |
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. |
Integration
1. Add a custom tracking domain
1. Add a CNAME record pointing to your RedTrack default domain in your domain registrar.
2. On the left menu go to Tools → Domains → Create new domain.
3. The default domain is stated right on the top and looks like smth.rdtk.io.
4. Add the integrated domain to your RedTrack account and activate the Free SSL option.
2. Get the TikTok pixel and access token
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. Copy the Pixel ID:
7. Stay in the Settings → Generate Access Token → copy the created token.
3. Add offer/website you are promoting
1. This is the target destination link where you plan to run the traffic: it can be an affiliate offer, a direct link to your website, or the shop.
1. Add the offer source: New from template/New from scratch → find the affiliate network you work with/add your custom name → Save.
2. Add the offer link: Offers → New → choose the offer source from the list, add the offer URL → save the changes.
For example: &affsub={clickid} where {clickid} is RedTrack parameter
More info on offer source and offer in RT can be found here.
1. Go to Brands → New → Add your brand (it is the name of your shop or your website).
2. On the same page, add the purchase data parameters – Name/Description is what you will see in reports – Roles define their use with CAPI.
3. Go to Websites → New → Add your website URL (this is your e-commerce shop/website link).
4. Follow the suggested steps to generate the scripts. You will need it later for your e-commerce platform.
More info on e-commerce platform integration is here.
2. To send the PII data for better attribution for TikTok, go to the added Offer source/Brand → Additional parameters → add the following tokens and assign the relevant roles to them:
Here you can find the general principle of the PII data enrichment process in RT.
Parameter | Macro / Token | Name / Description | Role (selected from the drop-down) |
|---|---|---|---|
phone | {r} | phone | Phone |
email | {r} | email | Email |
contenttype | {r} | contenttype | Content Category |
contents | {r} | contents | Contents |
4. Add TikTok traffic channel template
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. 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
5. Add the target conversion types and map them
1. Tools → Conversion tracking → Conversion types → Add those you plan to track (use this guide to help you add the events).
2. 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
– conversion type
– currency
– sum
– IP
– UA
– conversion date
6. Create a campaign
Campaign in RedTrack
Process of campaign creation in RedTrack slightly differs depending on your account type:
1. Create a campaign in RedTrack.
Campaigns → New → Fill in the info in all the sections and tabs:
- General: Give it a name and choose the traffic channel, tracking domain, and cost-tracking method.
- Funnels: Choose the type of funnel you are using and add the elements from the drop-downs.
- S2S postback: This field will be filled in automatically based on the data you have added to your traffic channel settings.
- Auto update costs: Remember to turn the toggle on if you are working with the API-integrated traffic channel.
2. For TikTok tracking, you can use the standard redirect tracking or the tracking script (we highly recommend working with that tracking method). You will have to use our script on the page code and choose the one that works best for you:
(Skip if you work with redirect)
Simple script (one landing page, one traffic channel)
It is generated automatically once you save the campaign and is available under the no-redirect tab.
Advanced script (one landing page, multiple traffic channels)
2.1. Create a campaign for the organic traffic. With the same setup as for the paid traffic
2.2. Tools → Scripts → New → Fill in the mandatory fields and save the changes
– default – choose this one if you plan to work with your website (e.g. e-com store) where a visitor can click on any link or visit any tab while the target action is tracked always on some other page no matter what the visitor path was before.
– /click support – use it when you lead the visitor from your landing page to a 3rd party offer and use domain.com/click CTA link format.
– /pre-click support – same as /click support but for a prelanding page with domain.com/preclick CTA link.
Title – give your script a name.
Domain – choose a custom tracking domain that will be used in that script.
Default campaign – organic traffic campaign created within step 2.1
Attribution – set the attribution model you want to use:
– First click – first recorded inbound click.
– Last click– last recorded inbound click.
– Last paid click – last recorded inbound click with tracking parameters.
Note: we always recommend using Last paid click attribution, since that in the most accurate way measures which marketing touchpoint a customer last clicked on or engaged with before purchasing, and gives it 100% of the credit.
Attribution window – set the attribution window, the period for the first click, and last paid click models.
Cookie domain – the root domain to place a cookie. This is the root domain of your website
3. Once you save the changes, the ready-to-use link or script will be generated; copy it.
You will need to add the tracking parameters or the link later on the TikTok side. The parameters depend on the type of script you have chosen before and can be taken from the “universal script” (advanced) or “no-redirect” (simple) tab within campaign settings:
1. Create a campaign in RedTrack.
Campaigns → New → Fill in the info in all the sections and tabs:
- General: Give it the name, and choose the traffic channel, tracking domain, and cost-tracking method.
- Funnels: Choose the type of funnel you are using and add the elements from the drop-downs.
- S2S postback: This field will be filled in automatically based on the data you have added to your traffic channel settings.
- Auto update costs: Do not forget to turn the toggle on if you are working with the API-integrated traffic channel.
2. For TikTok, you will need to use our universal tracking script.
The universal tracking script is created automatically once you’ve added the Website and can be taken from your RT account → Scripts.
The script should be placed on the page code or your e-commerce store/website (check out the precise e-commerce guide for details).
The tracking parameters are to be copied from the campaign settings and saved for later:
Campaign on TikTok
1. Generate a test click on TikTok.
2. Check if the tt_test_id provided by TikTok (the tt_test_id is typically included in the URL or as part of the event data when a test click is fired) is in place; it will be available under the RedTrack ref_id parameter.
3. Generate a test conversion.
1. Launch a Campaign on 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, on Ad → Ad details → insert your redirect link/landing page/website URL and the tracking parameters (if applicable) into the URL field:
