Skip to main content
When you’re done, Northbeam shows your Impact spend, visits, and attributed revenue on the same programs, partners, and ads.
Before you start, make sure you have:
  • An Impact user with the Account Administrator or Implementation Specialist role, so you can create API credentials
  • Access to Impact Settings to edit the program tracking template

1. Connect the account

Create an Impact API token and paste it into Northbeam.

2. Add Northbeam parameters

Add nbt once to your program tracking template.

3. Confirm tracking

Check that parameters and spend are reaching Northbeam.
1

Connect your Impact account

Northbeam connects with Impact’s Legacy API Token. You need your Account SID and Auth Token.
Only users with the Account Administrator or Implementation Specialist role in Impact can see API credentials. If you don’t see the API section in Settings, ask your Impact admin to give you one of these roles or to get the credentials for you.
Create the token in Impact
  1. In Impact, go to [User profile] → Settings → Technical → API.
  2. Click Create Access Token. See Impact’s guide for details.
  3. Complete the Setup and Contact Information steps.
  4. On the API Scopes step, select these scopes (all GET):
    • /Advertisers/<AccountSID>/Campaigns
    • /Advertisers/<AccountSID>/Actions
    • /Advertisers/<AccountSID>/Ads
    • /Advertisers/<AccountSID>/MediaPartners
    • /Advertisers/<AccountSID>/ReportExport/{ReportId_or_Handle}
    • /Advertisers/<AccountSID>/Reports
    • /Advertisers/<AccountSID>/Reports/{ReportId}
  5. Click Create.
Impact Create Access Token screen with the API scopes selected
Connect in Northbeam
  1. Open Connections and select Impact. If you’re still in onboarding, go to Integrations > Impact instead.
  2. Paste your Account SID and Auth Token, then click Connect.
If you see “An error occurred: Invalid credentials,” check both values and try again.
Northbeam Impact connection form with Account SID and Auth Token fields
If you skip this step: campaign, partner, and ad names are missing, along with spend metrics.
2

Add Northbeam parameters to your ads

Add this parameter to the click URLs for all new and existing Impact ads:
  1. In Impact, go to [User profile] → Settings → Gateway.
  2. Under Program Tracking Template, add a new parameter row with Name nbt and Value nb:impact::{ircid}:{irpid}:{iradid}.
  3. Click Save.
Impact Program Tracking Template with the nbt parameter row added

Settings > Gateway > Program Tracking Template

Impact Settings menu with Gateway selected

Settings > Gateway

If you skip this step: Northbeam can’t tie visits and orders to your Impact ads, so spend and revenue show up on separate lines.
3

Confirm tracking

If a check fails, see Troubleshooting Northbeam data.

​
How Impact data maps to Northbeam

Impact data follows Impact’s own hierarchy: programs (campaigns) contain partners, and partners use individual ads.

​
Remove Impact custom spend (optional)

Once connected, Northbeam pulls up to 3 years of historical spend from Impact. If you already send Impact spend through a Spend Sheet or the Spend API, remove the overlap so it isn’t reported twice. For example, if you connect on 5/10/26, Northbeam backfills Impact spend to 5/10/23. If you have Impact spend older than that window and want to keep it, leave those older records in place. From a Spend Sheet
  1. Go to Settings > Data Spreadsheets.
  2. Find the sheet tied to Impact.
  3. Zero out the Impact spend that overlaps the backfill period. For example, if you connect on 5/10/26, zero out Impact spend from 5/10/23 onward.
Don’t delete rows, columns, or cells from the Spend Sheet. Replace the overlapping Impact spend values with 0 instead. Custom spend sheets vary: some use formulas tied to raw data import tabs, others use manually entered spend.
From the Spend API Delete the existing Impact spend records with the Delete Spend endpoint. If you’re not sure which values to remove, submit a support ticket and we’ll help.

​
Need help?

Impact FAQ

Common Impact setup and reporting questions.

Troubleshooting Northbeam data

Start here if a check above fails.