Skip to main content
The Northbeam Pixel is a script that runs on every page of your site. It records each visit, the marketing touchpoint that brought the visitor in, and the pages they view. Northbeam uses this to build each customer’s journey and attribute orders to the right channels. It’s the foundation for all other Northbeam tracking. Purchase events, custom goals, and other events all rely on the pixel being on the page first.
The pixel must fire on every page, all the time. If it doesn’t, Northbeam can’t see which channels drove those visits and orders, and that data can’t be recovered.

​
Which setup you need

Where the pixel goes depends on your store. Your platform guide walks you through every step.
Custom means any store that doesn’t use Shopify’s checkout, and is available on Pro and Enterprise plans. Headless stores that use Shopify’s checkout follow the Shopify guide.

​
Where to find your scripts

Your scripts come pre-filled with your Client ID. You can find them in two places:

​
What the pixel tracks

Once installed, the pixel records page views automatically every time a page loads. Everything else needs a small amount of extra setup.

​
How to test for the Northbeam Pixel

You can check the pixel on any page of your site using your browser’s developer tools. These steps use Google Chrome.
1

Open your website and accept cookies

Open any page on your site. If a cookie banner appears, accept it. On sites with a consent banner, the pixel doesn’t send data until the visitor agrees.
2

Open the Network tab

Right-click anywhere on the page and click Inspect. Open the Network tab, then refresh the page. The Network tab only shows requests made while it’s open.
3

Find the Northbeam request

In the Network tab’s filter box, type nb-collector. Click one of the results and open its Payload tab.Look for a pv field. pv means page view: the pixel recorded the visit and sent it to Northbeam.
4

Check the Client ID

In the same payload, find the aid value. This is the Client ID the pixel is sending data to. Confirm it matches your Northbeam account.This matters most if you have more than one Northbeam dashboard (for example, one per region or brand). Data only shows up in the account that matches the aid, so don’t mix pixels between dashboards.

​
Don’t see an nb-collector request?

  • Accept the cookie banner and refresh. This is the most common cause.
  • Check that the pixel is installed on that page. Follow your platform guide again.
  • Turn off ad blockers and privacy extensions, then refresh. They can block tracking requests.
  • Check your Content Security Policy if you have one. It must allow your i. subdomain. See Custom, step 1.
Still stuck? Contact our support team, or see Troubleshooting Pixel Tracking for deeper checks.