"}]},{"@type":"HowToStep","position":3,"name":"Enable revenue attribution","text":"If you used OAuth, order webhooks are already registered. For the paste path, register a webhook in Shopify Admin → Settings → Notifications → Webhooks for orders/paid pointing to https://cdn.admaxxer.com/api/shopify/orders."},{"@type":"HowToStep","position":4,"name":"Verify the install","text":"Load any public page on your site in a fresh browser tab. Within a few seconds, the Admaxxer dashboard realtime view should show the event. If nothing lands after 2 minutes, re-check the snippet is actually in the rendered HTML <head> (View Source, not just DevTools)."}]}

Install guide · ecommerce · ~4 min

Install Admaxxer on Shopify

OAuth connect or paste into theme.liquid.

Shopify has two install paths. The OAuth flow at /api/integrations/shopify/configure is the cleanest — we handle theme injection and order webhook registration automatically. The manual path puts you in control: paste the script tag directly into theme.liquid.

Steps

  1. 1 Option A — OAuth (recommended)

    In the Admaxxer dashboard go to Sites → Install → Shopify tab. Enter your Shopify app Client ID, Client Secret, and shop domain (e.g. mystore.myshopify.com), then click Configure & authorize. We redirect you through Shopify OAuth and inject the pixel automatically.

  2. 2 Option B — Paste into theme.liquid

    In Shopify Admin → Online Store → Themes → Edit code → Layout → theme.liquid, paste the snippet below immediately before </head> and save.

    html
    <script defer
  data-website-id="YOUR_WEBSITE_ID"
  data-domain="yourdomain.com"
  src="https://cdn.admaxxer.com/js/script.js"></script>

  3. 3 Enable revenue attribution

    If you used OAuth, order webhooks are already registered. For the paste path, register a webhook in Shopify Admin → Settings → Notifications → Webhooks for orders/paid pointing to https://cdn.admaxxer.com/api/shopify/orders.

  4. 4 Verify the install

    Load any public page on your site in a fresh browser tab. Within a few seconds, the Admaxxer dashboard realtime view should show the event. If nothing lands after 2 minutes, re-check the snippet is actually in the rendered HTML <head> (View Source, not just DevTools).

Verify installation

Troubleshooting

The OAuth redirect fails with "App not installed".
Make sure your Shopify app is set to Custom distribution and the shop domain you entered matches the shop the app was distributed to.
Pageviews work but I see no revenue.
Verify the orders/paid webhook is registered (Shopify Admin → Settings → Notifications → Webhooks). Test deliveries can be replayed from the same screen.
No events are showing up. What now?
Open DevTools Console and Network. Filter for script.js and /api/event. If they are blocked:csp, your Content Security Policy is blocking admaxxer.com — see /documentation/troubleshoot/csp. Also double-check that data-website-id matches the ID shown in your dashboard.
Events show up in staging but not production.
Confirm data-domain matches the production hostname exactly (no protocol, no trailing slash). Also confirm the website's Allowed Domains list in settings includes the prod domain.
My site is a single-page app — am I missing pageviews?
Use script.hash.js if you rely on location.hash routing. Otherwise the default script.js already hooks history.pushState/replaceState and tracks SPA navigations.

Related install guides

WooCommerce · WordPress · BigCommerce · All platforms