Connect your TikTok ad account and add Northbeam parameters so spend and revenue line up.
When you’re done, Northbeam shows your TikTok spend, impressions, visits, and attributed revenue on the same campaigns, ad groups, and ads.
Before you start, make sure you have:
A TikTok login with admin access to the ad account
Access to TikTok Ads Manager to edit your ads
1. Connect the account
Sync spend, impressions, and campaign structure from TikTok.
2. Add Northbeam parameters
Add nbt and nb_platform so visits and orders tie back to your ads.
3. Confirm tracking
Click a live ad and check the landing page URL.
1
Connect your TikTok ad account
Open Connections. If you’re still in onboarding, go to Integrations instead.
Find TikTok Ads and click Connect.
Sign in with a TikTok login that has admin access to the ad account.
The connection pulls your current and historical campaigns, ad groups, and ads from the TikTok Ads API, along with spend, impressions, and TikTok-reported conversion and creative metrics. Impressions also power the Clicks + Modeled Views attribution model.If you skip this step: campaign, ad group, and ad names are missing, along with spend, impressions, and TikTok-reported metrics.
2
Add Northbeam parameters to your ads
Add these two custom parameters to every new and existing ad:
Parameter
Value
nbt
nb:tiktok::__CAMPAIGN_ID__:__AID__:__CID__
nb_platform
tiktok
In your ad settings, click Build URL parameters.
Click Add parameter twice and enter both parameters above.
Click Apply.
Edit Ad > Build URL Parameters
To have Northbeam add the parameters to new TikTok ads automatically, ask Support to turn on UTM auto-appending.
Watch a walkthrough
If you skip this step: Northbeam can’t tie visits and orders to your TikTok ads, so spend and revenue show up on separate lines.
3
Confirm tracking
Quick check: click one of your live TikTok ads and look at the landing page URL. nbt should show real numbers where __CAMPAIGN_ID__, __AID__, and __CID__ are. If you see that placeholder text, check the parameters against the table above.For a full check:
Parameters captured: follow Checking UTM tracking to confirm the Northbeam parameters reach your landing pages.
Connection syncing: follow Checking platform connections to confirm the account shows as connected and data is arriving.
GMV Max is TikTok’s automated campaign type for TikTok Shop. It handles targeting, bidding, and creative to hit a target ROI on total shop sales.Northbeam attributes GMV Max automatically once these are in place:
Your TikTok Shop is connected to a TikTok ad account
That ad account is connected to Northbeam
The connected user is an admin on both the ad account and the TikTok Shop
You’ll find the results on the Sales page under a platform called GMV Max.
Don't see GMV Max data?
Usually your TikTok Shop isn’t connected to an ad account, or it’s connected to one that isn’t linked to Northbeam. To check in TikTok Business Center:
Select the right Business Center.
Go to Assets → Ad Accounts and select the ad account.
Go to Assets → TikTok Shop. If your shop isn’t listed, it isn’t linked to that ad account.
Smart+ 2.0 adds Asset Groups between ad groups and creatives. Northbeam shows the asset group at the start of the ad name, so there’s nothing to set up:Asset Group Name |:| Creative NameFor example: Prospecting - UGC |:| spark-echo_V3_QRT472_LD-20251112.mp4To see performance for one asset group, open the Sales page, filter Platform to TikTok, and at the Ad level search for the asset group name.
