Northbeam Pixel
Northbeam Pixel is Northbeam's JavaScript tag for client-side attribution tracking. This destination loads the Northbeam pixel in the browser and forwards page view, identity, and ecommerce events to Northbeam. For server-side order reporting, see the Northbeam destination.
Getting Started
This is a device-mode destination. The Northbeam pixel is loaded automatically — no manual script installation is required. You will need:
- Data Client ID — the UUID that identifies your Northbeam account. Found in the Northbeam dashboard under Settings > API Keys.
Optionally, configure custom goal IDs for ecommerce funnel events (see Custom Goals below).
Connecting to the Northbeam Pixel CDP Destination
- Log into the Chord data platform.
- Navigate to the CDP.
- Click the "Add" button next to Destinations.
- Select Northbeam Pixel from the destination catalog.
- Enter the destination name and your Data Client ID.
- Optionally configure custom goal IDs for Product Viewed, Add to Cart, and Checkout Started events.
- Click "Create" to connect.
Using Alongside the Northbeam (Cloud-Mode) Destination
The Northbeam Pixel and the Northbeam server-side destination can be used together. Both send purchase data to Northbeam — the pixel via firePurchaseEvent and the cloud-mode destination via the Orders API. Northbeam deduplicates purchases by order ID, so running both should not result in double-counted orders.
If you are using only the pixel destination (no cloud-mode), note that Order Refunded events are not reported — refunds require the server-side Orders API.
Event Mapping
Chord Event | Northbeam Call |
|---|---|
page | trackPageView() |
identify | identify(email) + identifyCustomerId("custom", userId) |
Order Completed | firePurchaseEvent(orderData) |
Product Viewed | fireCustomGoal(productViewedGoalId, {}) |
Product Added | fireCustomGoal(addToCartGoalId, {}) |
Checkout Started | fireCustomGoal(checkoutStartedGoalId, {}) |
Email Captured | fireEmailCaptureEvent(email, {}) |
Page Events
Northbeam call: window.Northbeam.trackPageView()
Called on every page event after the initial page load. The Northbeam pixel fires trackPageViewInitial automatically during initialization to capture the first page view — subsequent SPA navigations fire trackPageView().
No additional attributes are sent with page events.
Identify Events
Updates the Northbeam identity graph for the current visitor.
Northbeam calls:
- window.Northbeam.identify(email) — fires when context.traits.email is present
- window.Northbeam.identifyCustomerId("custom", userId) — fires when userId is present
Both calls are made independently if their respective fields are available.
Northbeam Parameter | Chord Source |
|---|---|
context.traits.email | |
customerId | userId |
Order Completed
Fires a purchase conversion event with full order and line item data.
Northbeam call: window.Northbeam.firePurchaseEvent(orderData)
Northbeam Field | Chord Source | Notes |
|---|---|---|
id | properties.order_id | Required by Northbeam for deduplication |
totalPrice | properties.total → properties.revenue → properties.value | Defaults to 0 |
shippingPrice | properties.shipping | Defaults to 0 |
taxPrice | properties.tax | Defaults to 0 |
coupons | properties.coupon | Empty string if absent |
currency | properties.currency | Defaults to "USD" |
lineItems[].productId | product.product_id → product.sku → product.id | |
lineItems[].variantId | product.variant_id → product.sku → product.product_id | |
lineItems[].productName | product.name | |
lineItems[].variantName | product.variant → product.name | |
lineItems[].price | product.price | Defaults to 0 |
lineItems[].quantity | product.quantity | Defaults to 1 |
Custom Goals
Northbeam tracks Product Viewed, Product Added, and Checkout Started events as custom goals. Custom goals count event occurrences only — they do not carry revenue or product data. Goal names must be registered with the Northbeam team before they appear in your Northbeam dashboard.
Configure goal IDs in the destination settings to match what you have registered with Northbeam:
Setting | Default Value | Chord Event |
|---|---|---|
Product Viewed Goal ID | product_viewed | Product Viewed |
Add to Cart Goal ID | add_to_cart | Product Added |
Checkout Started Goal ID | checkout_initiated | Checkout Started |
Northbeam call: window.Northbeam.fireCustomGoal(goalId, {})
Email Captured
Fires when an Email Captured track event includes a user email address. This both records the email capture goal and links the email to the current visitor in Northbeam.
Northbeam call: window.Northbeam.fireEmailCaptureEvent(email, {})
The event is skipped if no email is present on the event.
Initialization
The plugin loads //j.northbeam.io/ota-sp/{dataClientId}.js and sets up a command queue to buffer calls before the script loads. trackPageViewInitial fires automatically during initialization to capture the first page view.
The plugin manages SDK loading state (fresh → loading → loaded/failed) to prevent duplicate script loads. If the script fails to load, subsequent events are silently dropped.
CSP Requirements
If your site uses a Content Security Policy, allow the following domains:
Directive | Domain |
|---|---|
script-src | https://j.northbeam.io |
connect-src | https://j.northbeam.io |
Updated 11 May 2026