Connection Info
The TikTok Ads Connection is an Advertising and Signals connection.
- Advertising: Innkeepr reads campaigns and spend data.
- Signals: Innkeepr sends Signals to this platform.
Getting Started
- From your workspace’s Connections page, click Add connection.
- Choose TikTok Ads.
- Click Connect, log in to TikTok for Business, and allow access for the Innkeepr app.
- Select the ad accounts you want to sync.
- Enter your Ad ID parameter. This is the URL parameter name you use to pass the ad ID in your ads (see below).
- Select the pixel your campaigns optimize on.
- Click Save.
How Innkeepr sends Audience Signals
Innkeepr sends every user of an Audience Signal to your pixel through the TikTok Events API. Each Audience Signal has its own event,innkeepr_targeting_<signal-id>, for example innkeepr_targeting_64f1a2b3c4d5e6f7a8b9c0d1. You find these events in TikTok Ads Manager > Tools > Events Manager on the pixel you connected.
Innkeepr does not create the audience in TikTok. You create it once per Audience Signal:
- In TikTok Ads Manager, go to Assets > Audiences and click Create audience.
- Choose Custom Audience > Website traffic.
- Select your pixel and the event of the Audience Signal.
- Set the time range: 30 days for Seed Signals, 180 days for Exclusion and Retargeting Signals.
- Save the audience.
ttclid, or _ttp to match a user:
The more users have an email address or phone number, the more of them TikTok can match.
URL Parameter
Innkeepr reads your ad groups as Treatments. To match website visits to them, Innkeepr needs the TikTok ad ID as a URL parameter. You choose the parameter name yourself. Make sure it matches the Ad ID parameter in the connection settings. Parameters Add the following to the URL parameters of your ads, replacingyour_parameter with the parameter name you configured in Innkeepr. TikTok macros must be written in capital letters:
your_parameter=__CID__
If you already use URL parameters, add the Innkeepr parameter at the end with &:
&your_parameter=__CID__
If you do not use URL parameters yet and want a complete setup including UTMs:
utm_source=tiktok&utm_medium=paid&utm_campaign=__CAMPAIGN_NAME__&utm_term=__AID_NAME__&utm_content=__CID_NAME__&your_parameter=__CID__
Upgraded Smart+ campaigns pass the ad ID with
__ADID_V2__ instead of __CID__. Use the same parameter name in these campaigns: your_parameter=__ADID_V2__ - In TikTok Ads Manager, open the ad and click Edit.
- In the Destination section, click Build URL parameters.
- Add the parameter and click Apply.
- Click Preview to check that the URL contains the parameter, then publish your changes.
- In TikTok Ads Manager, go to the Campaign tab and select the campaigns, ad groups, or ads you want to edit.
- Click Bulk export/import and export the ads into a spreadsheet.
- Add the parameter to the destination URL of every ad. Do not change the Campaign ID, Ad Group ID, or Ad ID columns.
- Import the spreadsheet again.
Permissions
To connect TikTok Ads, the TikTok user who logs in needs these permissions: Ad account The user needs the Admin or Operator permission on the ad account. This is required to:- Read campaigns, ad groups, and their spend
- Manage audiences