Northbeam reports its own attributed numbers (spend, revenue, ROAS and purchases based on your Northbeam attribution model), and those usually differ from what the ad platform reports. Connect Northbeam to Upspring and you can put both on the exact same ads: your platform numbers and Northbeam's, with the difference right there in the table.
Northbeam connects per space, so if you manage several brands, each space gets its own Northbeam account.
What you need
An Upspring space with your Meta ad account already connected. Northbeam numbers are matched to your Meta ads.
Admin access to the space.
Your Northbeam API key and Client ID. Both are in your Northbeam dashboard under Settings → API Keys.
Connect Northbeam
1. Open your space's data sources
In the left sidebar, go to Settings → Data connections, find the Northbeam card, and click Go to Space Settings. (You can also go straight to Space Settings → Data Sources.)
2. Get your API key and Client ID
On the Northbeam card, click Generate API Key to open Northbeam's authentication guide. In your Northbeam dashboard, go to Settings → API Keys and copy both your API key and your Client ID.
3. Connect
Click Connect on the Northbeam card and fill in:
Name: a label for this connection (e.g. your brand name).
API key: your Northbeam API key.
Client ID: your Northbeam Client ID.
Click Connect. Upspring checks the credentials with Northbeam and links the account. When it's done, Northbeam shows as connected under that space.
💡 Managing several brands? Repeat this in each space, using that brand's Northbeam account.
Choose your source: Original, Northbeam, or Both
Once Northbeam is connected, open any report (or a View) and use the source selector in the toolbar:
Original: your platform-reported numbers (Meta), exactly as before.
Northbeam: the same ads, shown with Northbeam's attributed numbers.
Both: Northbeam and your platform numbers side by side, so you can see the gap on every ad.
The source you pick applies across the whole report (the table, KPI tiles, and every chart) and carries into the ad breakdown, the creative view, the Launch Report, shareable reports, and your Views dashboards. It's remembered per space as you move between reports, and resets when you switch to another space.
💡 Have both TripleWhale and Northbeam connected in the same space? The source selector lets you pick which one to use. Only one is shown at a time.
Pick your attribution settings
When Northbeam or Both is selected, the source selector also lets you choose how Northbeam attributes results, the same options you have in Northbeam itself:
Model: Clicks + Modeled Views (default), Clicks + Deterministic Views, Clicks only, First touch, Last touch, or Last non-direct touch.
Accounting: Accrual (default) credits revenue to the day of the ad interaction, which is best for judging ad performance. Cash credits revenue to the day of the order.
Window: 1 day (default), 3, 7, 14, 30, 60 or 90 days. Only used with Accrual; Cash always uses Northbeam's lifetime window.
Your choice is remembered per space and is included when you share a report, so anyone with the link sees the same numbers you do.
What Northbeam changes
Northbeam supplies the attribution-driven metrics: spend, revenue, ROAS, purchases and cost per purchase. Metrics Northbeam doesn't report, like impressions, CTR, CPM and hook rate, always stay on your platform numbers, whatever source you've picked.
Numbers won't match Meta exactly, and that's the point: Northbeam uses its own attribution model, so its ROAS and revenue reflect a different view of what drove each sale.
Good to know
It's per space. Connect Northbeam in each space where you want it. Accounts never cross between spaces.
The first load takes a few seconds. Upspring requests a fresh export from Northbeam the first time you open a date range or change a setting. After that it's cached for 15 minutes, so switching between reports is instant.
Your report always renders. If Northbeam is unreachable, Upspring quietly falls back to your platform numbers.
Matched to your Meta ads. Northbeam numbers are joined to your Meta ads by ad ID.
Troubleshooting
"Northbeam API key or Client ID is invalid"
Double-check both values in Northbeam under Settings → API Keys. The API key and Client ID must come from the same Northbeam account.
I don't see the source selector
It only appears once Northbeam (or TripleWhale) is connected in the space you're working in. Switch to that space, or connect Northbeam there first.
The numbers look different from Meta or from Northbeam
Different from Meta is expected. If they differ from your Northbeam dashboard, check that the model, accounting mode and window in the source selector match the ones you use in Northbeam.
Need help?
Reach out to us in chat and we'll get you connected.