Skip to main content

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.
TikTok Ads lets you reach people in the TikTok feed with video ads. Add TikTok Ads as a Connection to Innkeepr to send Audience Signals to TikTok and to measure which ad groups create incremental results.

Getting Started

  1. From your workspace’s Connections page, click Add connection.
  2. Choose TikTok Ads.
  3. Click Connect, log in to TikTok for Business, and allow access for the Innkeepr app.
  4. Select the ad accounts you want to sync.
  5. Enter your Ad ID parameter. This is the URL parameter name you use to pass the ad ID in your ads (see below).
  6. Select the pixel your campaigns optimize on.
  7. 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:
  1. In TikTok Ads Manager, go to Assets > Audiences and click Create audience.
  2. Choose Custom Audience > Website traffic.
  3. Select your pixel and the event of the Audience Signal.
  4. Set the time range: 30 days for Seed Signals, 180 days for Exclusion and Retargeting Signals.
  5. Save the audience.
TikTok needs 24–48 hours to populate the audience and at least 1,000 users before it can be used as a Lookalike source. Matching Innkeepr sends these identifiers with every event. TikTok needs at least one of email address, phone number, 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, replacing your_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__
Implementation For a single ad:
  1. In TikTok Ads Manager, open the ad and click Edit.
  2. In the Destination section, click Build URL parameters.
  3. Add the parameter and click Apply.
  4. Click Preview to check that the URL contains the parameter, then publish your changes.
For many ads, use Bulk Import & Export:
  1. In TikTok Ads Manager, go to the Campaign tab and select the campaigns, ad groups, or ads you want to edit.
  2. Click Bulk export/import and export the ads into a spreadsheet.
  3. Add the parameter to the destination URL of every ad. Do not change the Campaign ID, Ad Group ID, or Ad ID columns.
  4. 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
The Analyst permission is not sufficient. Analysts cannot manage audiences.
Pixel The pixel must be linked to the ad account you connect. If the pixel belongs to a Business Center, share it there with the ad account. Innkeepr only sends events to the pixel and never changes it, so no permission to edit pixels is needed.