Shopify Web Pixel Attribution Setup
Enable beyondRegular Web Pixel attribution on Shopify Pro. Turn on the theme app embed, flip the pixel toggle, verify checkout revenue in analytics.
Shopify Web Pixel attribution ships on the Pro plan. Enable the beyondRegular theme app embed in your live theme, then flip the Web Pixel toggle in your beyondRegular dashboard under Settings > Shopify. Checkouts that started from a widget click get tagged with the preset ID, and attributed revenue appears in Analytics within a few minutes of order confirmation.
What you need before you start
You need a Shopify store on any paid plan, a beyondRegular Pro subscription, and admin access to both dashboards. Web Pixel attribution is gated to Pro. If you are on Nano or Starter, upgrade first, otherwise the toggle in the dashboard stays disabled and no checkout events get captured.
You also need the beyondRegular theme app embed installed. If widgets already render on your storefront through the Shopify app, the embed is in place. If you are running the plain script tag route on a non-Shopify surface, Web Pixel attribution does not apply, use the standard embed.js analytics instead.
Enable the theme app embed
Open Shopify admin, go to Online Store > Themes > Customize on your live theme. In the left panel click App embeds, find beyondRegular, and flip the toggle on. Hit Save at the top right. This injects the loader on every storefront page without touching theme.liquid.
If you prefer the raw script route on a custom section, drop this into the template where the widget should mount:
<script async src="https://www.itsbeyondregular.com/embed.js"></script> <div data-bn-preset="YOUR_PRESET_ID"></div>
The theme app embed is the recommended path on Shopify. It survives theme updates and gets the Web Pixel wired automatically. The raw script tag works too, but you lose the auto-registration and have to keep the snippet in sync with theme changes yourself.
Turn on the Web Pixel
In the beyondRegular dashboard go to Settings > Shopify > Attribution. Toggle Web Pixel on and click Save. Behind the scenes we register a Shopify Web Pixel through the Customer Events API, so no code lands in your theme and Shopify handles the sandboxing.
Confirm it stuck by opening Shopify admin > Settings > Customer events. You should see a pixel named beyondRegular listed as Connected. If it shows Disconnected or is missing, disable and re-enable the toggle in the beyondRegular dashboard, which forces a fresh registration call against your store. Give it about thirty seconds to propagate through Shopify before rechecking.
Verify attribution is firing
Load a product page on your storefront in an incognito window. Click a video in the widget, add the tagged product to cart, and check out with a test order using Shopify Payments test mode or a real card on the Bogus Gateway.
Open browser devtools Network tab and filter for itsbeyondregular.com. You should see a POST to /api/attribution/click when you tap a video, and a checkout_completed event forwarded from the Shopify pixel after the order confirms. In the beyondRegular dashboard the order lands under Analytics > Attributed revenue within about five minutes, tagged with the preset ID that drove the click.
Common issues
No orders showing: check the Pro plan is active and not in a failed billing state, the pixel stops posting when the subscription lapses. Also confirm the shopper actually clicked a widget in the same browser session, direct-to-PDP visits are not attributed.
Pixel shows disconnected in Shopify: the store may have revoked the app scopes. Reinstall the beyondRegular Shopify app from the App Store listing and the pixel re-registers on install.
Duplicate attribution: if you also run a plain script tag on the same page as the theme app embed, remove the script tag. Two loaders on one page double-fire click events and inflate the numbers.
Common questions
Does the Web Pixel work with headless Shopify or Hydrogen?
Not directly. The Shopify Web Pixel API runs inside Shopify-rendered storefront and checkout pages, so Hydrogen and other headless setups fall outside its sandbox. If you are on Hydrogen, use the standard embed.js loader with data-bn-preset on your custom storefront, and enable server-side order webhooks from the beyondRegular dashboard under Settings > Webhooks. That path posts order.paid events from Shopify to beyondRegular directly and matches them to widget clicks by cart token, giving you the same attributed revenue view without the pixel.
Which checkout gateways does attribution support?
Any gateway configured inside Shopify checkout. That covers Shopify Payments, Razorpay, PayU, CCAvenue, Cashfree, and Stripe when routed through Shopify. Attribution is tied to the Shopify checkout_completed event, not the gateway itself, so the payment processor does not matter. Prices and currency come from your Shopify catalogue, and Indian shoppers see INR automatically when your store has INR configured as a presentment currency. Manual payment methods and draft orders also get captured as long as they finish through Shopify checkout.
How long does attribution data take to appear?
Click events land in the beyondRegular dashboard in real time, usually under two seconds after the shopper taps a video. Order-level attribution waits for Shopify to fire checkout_completed, which happens the moment the confirmation page renders. From there we match the order to the click session and update Analytics > Attributed revenue. Total lag from order confirmation to dashboard row is around three to five minutes. If nothing shows up after ten minutes, check the pixel status in Shopify admin and confirm the shopper had a fresh widget click event before checking out.