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, the Connect button doesn’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. It can take a while, and 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 your connection lacks the permission das Pixel needs to send purchases to TikTok, 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 that account’s stored campaigns and spend.
• Checking a new account fetches up to a year of history for it.
• Accounts you leave checked keep their history, unless the next case applies.

Older campaign and spend data may not record which ad account it came from. If you have any, saving with an account unchecked deletes it as well, then fetches the history again for every account you kept. That fetch goes back up to a year, so anything older is lost.

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.