How to Connect TikTok Ads

Connecting TikTok Ads brings the spend and results of your TikTok campaigns into By the Numbers. It also lets you sync segments to TikTok as customer lists.

Before You Start

• You need a TikTok for Business login that can reach your TikTok ad accounts.
• You need the Manage integrations permission in By the Numbers. Without it, Connect, Configure and Remove don’t appear.

Steps

1. Open Integrations: Integrations, under Settings in the navigation.
2. On the TikTok Ads card, click Connect.
3. In the TikTok window, sign in and approve access. Leave every permission it lists turned on.
4. Back in By the Numbers, Configure TikTok Ads opens with every ad account checked. Uncheck any you don’t want. Select All and Select None help with a long list.
5. Click Save.

If the message TikTok Ads: missing_scopes appears, a permission for ad account information or customer lists was left off. Click Connect again and leave them all on.

If the reporting permission is left off, the card connects but shows Ad Spend Disabled: see below.

What Happens Next

The first sync fetches campaign and spend history for the accounts you chose, up to a year back. How long it takes depends on how much history the accounts have. The card shows the sync running until it’s done.

After that, TikTok Ads syncs about every 3 days. Each sync reads at least the last 7 days again, so late changes to spend and conversions are picked up.

Your TikTok spend then appears on:

• Advertising and the Campaign Performance report, by campaign.
• P&L, in Ad Spend.
• Customer LTV, in Blended CAC.

The conversions and value shown for TikTok campaigns are TikTok’s own, taken from its Complete Payment purchases.

If the Card Needs Attention

The card’s status tells you what’s wrong:

• Setup Required: you closed the dialog before saving the accounts, so nothing syncs yet. Click Finish Setup to choose them.
• Ad Spend Disabled: your TikTok connection doesn’t have the permission to read ad spend. Campaign spend won’t appear in your reports until you click Reconnect to Enable Ad Spend and approve every permission.
• Reconnect needed: TikTok no longer accepts your connection, for example because access was revoked. Click Reconnect and sign in again.

If TikTok refuses a purchase sent to your pixel, or your connection lacks the permission das Pixel needs to send one, the card shows Reconnect to Enable Conversions. Click it and approve every permission. See How to Send Conversions to Your Ad Platforms.

Changing the Accounts

Click Configure on the TikTok Ads card, change the checkboxes, and click Save.

• Unchecking an account deletes its stored campaigns and spend, except in the case below.
• Checking a new account fetches up to a year of history for it.
• Accounts you leave checked keep all their history.

Some campaign and spend data from before September 2026 doesn’t record which ad account it came from. By the Numbers keeps that data when you uncheck an account, since it may belong to an account you kept. If it came from the account you unchecked, that spend stays in your reports.

If you check an account again later, only up to a year of its history comes back. Uncheck an account only if you need to.

Syncing Segments to TikTok

Segments you sync to TikTok arrive as customer lists in the ad account you choose. How to Sync a Segment walks through it.

To disconnect TikTok Ads, choose Remove from the menu at the top right of the card. This deletes the stored TikTok campaigns and spend, and removes every segment sync to TikTok. If das Pixel sends your purchases to TikTok, that stops too.