Skip to main content
Custom Events let you track actions that happen on your website, beyond page views and purchases. For example:
  • Email or SMS sign-ups
  • Add-to-carts
  • Checkout starts
  • Quiz or lead form submissions
Each event shows up as a metric on your Sales page. Custom events count how many times an action happens. They don’t record revenue or other values.

Which setup you need

Custom Events work the same way on Shopify and custom stores. You add a short script wherever the action happens, then register the event in your dashboard.
Custom events must happen in the browser. The script has to run on your website, on the same domain as the Northbeam Pixel, while the visitor is on the page.

Set up a custom event

1

Check that the Northbeam Pixel is installed

The Northbeam Pixel must be running on the page where the action happens, and it must load first. Custom events won’t track without it.
2

Add the script

Add this script so it runs when the action happens, for example after a form submits successfully or after an add-to-cart click:
Replace your_goal_id with your own Goal ID. You can add the script through Google Tag Manager (easiest for most stores) or directly in your site’s code.
3

Register the event in your dashboard

Go to Settings → Custom Events and click Add Custom Event. Fill in:
  • Goal ID: the exact Goal ID from your script. If it doesn’t match exactly, the event won’t show up.
  • Display Name: the metric name you’ll see in your dashboard (for example, SMS Sign Up).
Then click Add. New or changed events take effect after the next data processing run.
Settings, Custom Events page with the Add Custom Event button and the Add a custom event form
4

Add the event to your Sales page

After the event fires at least once, it’s available as a metric. On the Sales page, click Customize Table.
The Customize Table button on the Sales page
Click Custom events, select your event’s metrics, then click Apply.
Customize table window with Custom events selected and phone sign-up metrics checked

Goal ID rules

  • Use lowercase letters, numbers, and underscores only. Hyphens or spaces stop the event from showing up in your dashboard.
  • The Goal ID in your script and in your dashboard must match exactly.
Good examples: sms_signup, email_signup, add_to_cart, quiz_submit, initiate_checkout.

Troubleshooting

If an event isn’t showing up, check that:
  • The Northbeam Pixel is running on the page where the action happens
  • The Goal ID in your dashboard matches the script exactly
  • The script runs when the action happens, not on page load or on the wrong trigger
  • The action happens on the same domain as the Northbeam Pixel
  • At least one processing run has finished since you added the event