What are Custom Goals?

Custom goal refer to any event outside of the standard Purchase event. In order to start tracking any of these events, please implement our fireCustomGoal script, which you can find below.

// Args:
// Arg0: The name of the custom goal. 
// Arg1: An empty object.
window.Northbeam.fireCustomGoal("sms_signup", {})

Examples of custom goal that can be tracked via the script:

• Email or SMS Sign Ups
• Add To Carts
• Initiate Checkout
• Quiz Submissions
• Leads
• Any other action that occurs on your website

How to set up Custom Goals

Step 1: Make sure the Northbeam Pixel is firing

Confirm the following:

• The base Northbeam Pixel is firing on the page of where the event occurs
• This page lives on the same top-level domain as your website

Step 2: Implement the Script

window.Northbeam.fireCustomGoal("sms_signup", {})

Replace sms_signup with your own Goal ID -- this becomes the metric name you'll register in the dashboard. It can be deployed via Google Tag Manager or hardcoded directly on your site.

📘

Goal ID rules:

1. Lowercase letters, numbers, and underscores only (e.g. sms_signup, add_to_cart)
2. No hyphens or spaces — the event won't show up in the dashboard
3. Must exactly match what you register in Step 3
4. Tracks event count only — no revenue or values can be passed

⚠️

GTM users: When deploying via a Custom HTML tag, wrap the code in <script></script> tags. Make sure the trigger fires on the actual event (click, form submission, etc.) — not on page load.

Step 3: Add the Goal ID in the dashboard

Go to Settings → Custom Goals and add a new entry:

• Goal ID — enter the exact same Goal ID used in your script (e.g. sms_signup)
• Display Name — enter what you want the metric to be named in your dashboard (e.g. SMS Signup)

Step 4: Add the goal to your Sales view

After at least one event fires, the goal will be available as a metric on the Sales page.

1. Go to the Sales Page
2. Click Customize Table

3. Click Custom Goals
4. Find your metric(s) and add them to your view.

Limitations

This script tracks event count only. No revenue, value, or other parameters can be passed. For value tracking, use Purchase Events, the Orders API, or FPE instead.