Skip to main content
When you’re done, Northbeam shows your X spend, impressions, visits, and attributed revenue on the same campaigns, ad groups, and ads.
Before you start, make sure you have:
  • An X login with admin access to the ad account
  • Access to X Ads Manager to edit your ads

1. Connect the account

Sync spend, impressions, and campaign structure from X.

2. Add Northbeam parameters

Add nine values in Add URL tracking 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 X ad account

  1. Open Connections. If you’re still in onboarding, go to Integrations instead.
  2. Find X Ads and click Connect.
  3. Sign in to X with the admin login.
The connection pulls your current and historical campaigns, ad groups, and ads from the X Ads API, along with spend, impressions, and X-reported conversion and creative metrics. Impressions power the Clicks + Modeled Views attribution model.If you skip this step: campaign, ad group, and ad names are missing, along with spend and impressions.
2

Add Northbeam parameters to your ads

In X Ads Manager, open Add URL tracking on every ad and fill in all nine values below. Northbeam needs all of them to match your X traffic to spend. You can also copy each one from your UTM Guide in Northbeam.The first five are the standard fields at the top of the panel. Add the last four under Custom parameters by clicking Add custom parameter for each.
X Ads Manager Add URL tracking panel with Source twitter, Medium paid, Name {{campaign_name}}, Term {{adgroup_name}}, Content {{ad_name}}, and custom parameters x_campaign_id, x_adgroup_id, x_ad_id, and nb_platform filled in

Add URL tracking with all nine values filled in

Your final URL looks like:
Published ads can’t be edited. To add the parameters to an existing ad, duplicate it and add them to the new copy.
If you skip this step: Northbeam can’t tie visits and orders to your X ads, so spend and revenue show up on separate lines.
3

Confirm tracking

Quick check: click one of your live X ads and look at the landing page URL. You should see real IDs, like x_campaign_id=1234567890.
If the URL shows the literal text {{campaign_id}}, or the parameters are missing, check the values in Add URL tracking against the table above.
For a full check:

Need help?

X Ads FAQ

Adding accounts, and why X and Northbeam numbers differ.

Troubleshooting Northbeam data

Start here if a check above fails.