SignalBridge- Install
- Script Manager, storefront channel, header placement
- Page location
- All pages, which covers storefront, cart, checkout and order confirmation
- Checkout requirement
- Optimized One-Page Checkout for scripts on checkout and confirmation pages
- Confirmation URL
- /checkout/order-confirmation
- Consent
- Follows the script category you choose and your cookie banner
- Coexists with
- Your existing Meta Pixel, Google tag and TikTok pixel
- Custom events
- sb_track() for anything the script does not detect
- Not included
- Refund, cancellation and fulfilment events, which need order data from BigCommerce
How it works
Script Manager loads the script
BigCommerce adds your script to the pages you choose. On a Stencil storefront this includes the cart, the checkout and the order confirmation page when the location is all pages and the store uses Optimized One-Page Checkout.
It records the visit
The script stores the visitor's landing page, campaign parameters and ad click IDs, and sends page views and storefront events such as product views and add to cart.
It follows your existing pixels
If your Meta Pixel, Google tag or TikTok pixel fires an event, SignalBridge mirrors it to the server with the same event ID, so the platform counts the browser and server copies once.
It captures the purchase
On the order confirmation page it takes the order from your data layer or the page and sends one Purchase. If it cannot read the order total, you can send the order yourself, as described below.
The server delivers it
Consent is applied, then each connected platform receives the event through its own queue with retries, matched back to the ad click captured on arrival.
Script Manager settings to use
These are the settings that matter for tracking. Script Manager is in the storefront channel's settings.
| Setting | Value | Why |
|---|---|---|
| Placement | Header | The script starts as the page loads and sees the landing page parameters. |
| Location | All pages | Includes storefront, cart, checkout and order confirmation. The storefront option leaves out checkout and the confirmation page. |
| Script type | Script | You paste the snippet you copied from SignalBridge. |
| Script category | The one that matches your consent setup | Essential scripts always load. Other categories load only after the shopper accepts them when a cookie banner is enabled. |
| Checkout type | Optimized One-Page Checkout | Scripts only load on checkout and order confirmation pages with this checkout. It is the default for new Stencil stores. |
What the script captures on a BigCommerce store
Events are inferred from the pages and your existing pixels, so the table also shows the source.
| Event | Detected from | Notes |
|---|---|---|
| PageView | Every page load | Includes the page type, such as product, cart or checkout. |
| ViewContent | Product page markup | Uses product structured data and page metadata. |
| AddToCart | Your pixel, or add to cart button clicks | The click fallback runs only when no ad pixel on the page reports the event. |
| InitiateCheckout | A checkout URL | Reported when the visitor reaches checkout. |
| Purchase | The order confirmation page | Needs the order identity and total to be readable on the page or in your data layer. |
| Anything else | sb_track() | Send your own events with values and user data. |
Requirements
- A BigCommerce store on a Stencil theme, with access to Script Manager in the storefront channel settings.
- Optimized One-Page Checkout enabled, so scripts can load on checkout and the order confirmation page.
- A SignalBridge pixel and the ad platforms you want to connect.
- Optionally, a subdomain for first-party tracking, with access to your DNS.
Set up BigCommerce
Copy the snippet
Open your pixel in SignalBridge, choose Install and copy the snippet. It uses your custom domain automatically when one is active.
Create the script in Script Manager
In your BigCommerce admin open the storefront's Script Manager and create a script. Set placement to header, location to all pages and type to script, then paste the snippet.
Choose the script category
Pick the category that matches how your cookie banner treats advertising and analytics scripts. An uncategorised script does not load on stores that have a cookie banner enabled.
Check the checkout type
In your store settings confirm that Optimized One-Page Checkout is active. Without it, scripts do not render on checkout or the order confirmation page.
Connect your ad platforms and test
Connect Meta, Google Ads, TikTok or any other destination, place a test order, and watch the event stream for one Purchase with the correct value and currency.
Verify it works
Open the confirmation page
After a test order the browser lands on the order confirmation URL. View the page source or the network tab and check that the SignalBridge script loaded.
Check the Purchase
The event stream should show one Purchase with the BigCommerce order number, a value and a currency. Reload the page and confirm that it is not recorded twice.
Check the platform
In Meta Events Manager and your other platforms, look for the server event and confirm that it matches the browser event where one exists.
Troubleshooting
The script does not load on checkout or the confirmation page
Set the location to all pages, and confirm the store uses Optimized One-Page Checkout. A private theme may need Optimized One-Page Checkout support added.
The script is saved but never loads
Give it a script category. Uncategorised scripts do not display on stores that have a cookie banner, and non-essential categories wait for the shopper's consent.
The Purchase has no value
Add a second script with the location set to order confirmation. BigCommerce lets it read the order ID, and the storefront order endpoint returns the order total and currency, which you can pass to sb_track as a Purchase.
Purchases appear twice
Make sure the script exists once. Another tool that also reports purchases can double count, so check the Meta Pixel and Google tag set-up.
Only the storefront reports
The storefront location excludes checkout and the order confirmation page. Change the location to all pages.
Orders in BigCommerce exceed purchases in SignalBridge
Buyers who pay and close the page before confirmation, or whose payment method does not return to the store, are not seen by the script. Compare over several days.
What to know before you rely on it
Where this integration stops, so the numbers you see are read correctly.
- There is no BigCommerce order feed. Refunds, cancellations, status changes and orders created in the admin are not seen.
- A purchase is only captured when the buyer reaches the order confirmation page in a browser that runs the script.
- Script Manager applies to Stencil storefronts. Check that your store has it.
- Order details depend on what the confirmation page exposes. Verify value and currency on your own store.
- Visitors who have not agreed to marketing tracking are not sent to ad platforms where consent applies.
Questions about this integration
Is there a SignalBridge app in the BigCommerce marketplace?
No. SignalBridge is installed as a script in Script Manager, so there is nothing to install from the marketplace and nothing is added to your admin.
Why must I use Optimized One-Page Checkout?
BigCommerce only renders Script Manager scripts on the checkout and order confirmation pages when the store uses it. It is the default checkout for new Stencil stores, and older stores can switch in settings.
Which location should I choose?
All pages. It covers the storefront, cart, checkout and order confirmation. The storefront location leaves out checkout and the confirmation page, which is where the purchase happens.
What script category should I pick?
Choose the category that fits how your cookie banner is set up. Essential scripts always load. Others load after the shopper accepts that category, and uncategorised scripts do not load when a banner is enabled.
How do I send the order total myself?
Add a second script with the location set to order confirmation. It can read the order ID, fetch the order from the storefront order endpoint, and call sb_track with Purchase, the order ID, the total and the currency.
Can it work with my Meta Pixel and Google tag?
Yes. SignalBridge mirrors the events they fire and shares the event IDs, so ad platforms count each conversion once.
Can I track refunds?
Not automatically. SignalBridge sees what happens in the browser, so refunds made in the admin are not reported. You can send a custom event if you need one.
Does it work on a headless storefront?
This page covers Stencil storefronts and Script Manager. On a headless build such as Catalyst, check how your front end loads scripts, or add the SignalBridge snippet in your own front end code.