Table of Contents

• Introduction
• How Impact data maps to Northbeam
• Step 1: Connect Your Impact Account
• Step 2: Insert Northbeam UTM Parameters
• Step 3: Remove Impact Custom Spend (Optional)
• Impact FAQ

Introduction

This guide will show you how to set up tracking for the following Impact metrics in Northbeam:

• Spend, visits, and all conversion-based metrics attributed to Impact campaigns
• Partner and campaign data imported from Impact's reporting

How Impact data maps to Northbeam

Once connected, Impact data appears in your Northbeam dashboard across three levels:

This mirrors Impact’s native hierarchy — Programs (campaigns) contain partners, and partners use individual ads/creatives.

Step 1: Connect Your Impact Account

1A: Find your Impact credentials

Northbeam connects via Impact's Legacy API Token. You'll need your Account SID and Auth Token.

🚧

Required Role

Only users with the Account Administrator or Implementation Specialist role in Impact can access API credentials.

If you don't see the API section in Settings, ask your Impact account admin to either grant you one of these roles or retrieve the credentials on your behalf.

1. In Impact, go to [User profile] → Settings → Technical → API
2. Click Enable Legacy Tokens
   • If the button isn't visible, legacy tokens are already enabled
3. Under Legacy Account Tokens, click your token's card
   • If no token exists, click Create Access Token first, then click the card
4. From the left nav, select API Credentials
5. Copy your Account SID and Auth Token

📘

Can't find credentials?

Refer to Impact’s official guide on enabling and managing legacy API tokens.

1B: Connect in Northbeam

• Onboarding: Go to Integrations > Impact
• Dashboard: Go to Settings > Connections > Impact

Paste your Account SID and Auth Token, then click Connect.

If you see "An error occurred: Invalid credentials," double-check both values and try again.

Step 2: Insert Northbeam UTM Parameters

Add the following custom UTM parameter to the click URLs for all new and existing Impact ads:

Step-By-Step Guide

1. In Impact, go to [User profile] → Settings → Gateway

2. Under Program Tracking Template, add a new parameter row:
   1. Name: nbt
   2. Value: nb:impact::{ircid}:{irpid}:{iradid}

3. Click Save

Step 3: Remove Impact Custom Spend (Optional)

Once connected, Northbeam pulls up to 3 years of historical spend data from Impact. If you're currently sending Impact spend via a Spend Sheet or Spend API, you may want to remove overlapping spend to avoid duplicate reporting.

For example:

• If the integration is connected on 5/10/26, Northbeam will backfill Impact spend data to 5/10/23

If you have Impact spend data older than the integration lookback window and would like to preserve it, keep those older records in place.

Removing from Spend Sheet

1. Go to Settings > Data Spreadsheets
2. Locate the sheet tied to Impact
3. Remove spend overlapping with the integration backfill period
   • Example: if connecting on 5/10/26, remove spend from 5/10/23 onward

📘

Note

Custom spend sheets can vary by setup. Some use formulas tied to raw data import tab, while others use manually entered spend.

Removing from Spend API

Delete existing Impact spend records using the Delete Spend endpoint: https://docs.northbeam.io/reference/delete_spend

Need Help?

If you're unsure which values to remove, please submit a support ticket and we’d be happy to help.

Impact FAQ

1. Can I connect multiple Impact accounts?

At this time, Northbeam supports connecting one Impact account per dashboard.

If you manage multiple Impact accounts, you can still track the others by:

• Connecting one account through the native Impact integration
• Sending spend for additional accounts via a Spend Sheet or Spend API
• Using standard UTMs for tracking on those additional accounts

Any non-connected Impact accounts will work similarly to other Non-Integrated Channels.

2. Can I use other UTM parameters alongside Northbeam's?

Yes — Northbeam's nbt parameter is additive and will not interfere with any other parameters you're already using. Feel free to keep parameters like utm_source, utm_medium, utm_campaign, or any other tracking params for Google Analytics or other platforms. Northbeam only uses nbt for attribution.

3. I was already using Northbeam's previous recommended UTMs for Impact. Do I need to switch?

You can either swap them out for the new nbt parameter or simply add nbt alongside your existing params — there's no harm in leaving the old ones in place. Northbeam uses nbt to tie sessions back to the correct ad spend, so as long as nbt is present, attribution will work correctly.

4. Why do I see a data discrepancy?

Discrepancies in Revenue and Orders are expected. The key reason is a difference in attribution methodology:

• Impact's attribution credits 100% of each conversion to a single partner using Impact's own click-based rules
• Northbeam's attribution treats Impact data as one input into cross-channel, multi-touch attribution — so conversions may be shared with or re-assigned to other channels

For more details: Why are my metrics different in Northbeam than in-platform reporting?

5. I think there's an issue with tracking. Please help!

Please reference our Troubleshooting Tracking Issues FAQ.

• Connection: Go to Settings > Connections and check for any errors on the Impact connection
• UTMs: Ensure all Impact click URLs include the Northbeam nbt parameter listed in Step 2
• Northbeam Pixel: Confirm the Northbeam pixel is firing on your landing page
• Purchase Pixel: Confirm the Purchase pixel is firing on your checkout page