Install Admaxxer on Shopify (App Store)
One click in the Shopify App Store. The pixel, GDPR webhooks, and order webhooks install automatically. Revenue starts streaming into your Admaxxer dashboard within minutes.
Overview
The Admaxxer Analytics Shopify app is a public app listed in the official Shopify App Store. It installs a Web Pixel App Extension that captures storefront and checkout events (page_viewed, product_viewed, product_added_to_cart, checkout_started, checkout_completed) and forwards them to your Admaxxer workspace for blended-MER, cohort-LTV, and CAPI-match-rate analysis. The app also registers orders/create, orders/paid, and refunds/create webhooks so server-side order data enriches attribution even when ad blockers strip the client-side events.
The app itself is free to install. To use it you need an active Admaxxer subscription (plans start at $29/month). Billing happens at admaxxer.com via Stripe; the Shopify app never asks for a credit card.
If you previously connected Shopify by pasting Client ID + Client Secret from the Shopify Dev Dashboard, that legacy Custom Distribution flow keeps working — the App Store install is the recommended path for new merchants going forward.
Before you start
- An active Shopify store (any plan tier — Basic, Shopify, Advanced, or Plus).
- An Admaxxer account — sign up free at admaxxer.com (7-day trial, no credit card required).
- About 60 seconds. Most of the work is automatic; you just click Install and then sign in.
Install in 60 seconds
- Visit the listing. Open apps.shopify.com/admaxxer in any browser. (You can also reach it from your Admaxxer dashboard › Connections › Connect Shopify (App Store).)
- Click Install. Shopify prompts you to pick the store you want to install Admaxxer on, then routes you to the OAuth consent screen.
- Approve OAuth permissions. Admaxxer requests the minimum scopes Shopify reviewers approved for our category:
read_orders— pulls order data for revenue attribution.read_products— resolves product titles and SKUs for product-level ROAS.read_customers— powers cohort LTV reporting (no retargeting; we never share customer lists with third parties).write_pixels— required to register the Web Pixel App Extension that fires on storefront and checkout pages.read_analytics— reads Shopify's built-in analytics so we can cross-validate against the pixel and flag tracking gaps.
- Embedded app loads. Shopify drops you into the embedded Admaxxer screen inside your Shopify admin. If you started from your Admaxxer dashboard (Flow A), the workspace link is automatic and you'll see Connected to workspace [Your Workspace Name]. If you started directly from the Shopify App Store (Flow B), click Sign in to Admaxxer — a magic-link to admaxxer.com opens in a new tab, you authenticate, and the embedded app links the two automatically.
- Done. The Web Pixel injects on your next storefront page load. Order webhooks register immediately. The first events arrive in Admaxxer within 15 minutes.
What gets installed
One install action triggers four pieces of integration. You don't have to configure any of them — everything happens behind the OAuth handshake.
- Web Pixel App Extension (auto) — A sandboxed web worker subscribes to Shopify's standard customer events (
page_viewed,product_viewed,collection_viewed,product_added_to_cart,cart_viewed,checkout_started,payment_info_submitted,checkout_completed). Every event POSTs tocollect.admaxxer.comover CORS, signed with a per-shop HMAC. Privacy categories declared:analytics+marketing, so the pixel honors Shopify's consent banner in GDPR regions. - GDPR webhooks (3, auto) — Shopify mandates these for every public app:
customers/data_request— fulfills GDPR data-export requests.customers/redact— deletes a specific customer's data within 30 days.shop/redact— deletes all shop data when you uninstall (within 30 days).
- Order webhooks (3, auto) — Server-side enrichment that attribution depends on:
orders/create— pre-paid order data (cart-abandon recovery context).orders/paid— confirmed payment — this is the trigger for Meta CAPI and Google enhanced conversions.refunds/create— refund event for negative attribution and accurate net revenue.
(provider, order_id). - App webhook (1, auto) —
app/uninstalledfires when you remove the app, flips your connection's pixel_active flag to false, and stops ingest immediately.
Verify it's working
- Open your Admaxxer dashboard.
- Look under Connections › Connected sources. Shopify should appear with your shop domain (e.g.
acme-cosmetics.myshopify.com) and a green Active badge. - Open your storefront in a fresh incognito tab and load any product page.
- Within 15 minutes (usually under 60 seconds) the pageview lands in Admaxxer › Pixel › Realtime. Place a $1 test order — revenue lands in Attribution › Revenue within 30 seconds of order paid.
The embedded app screen inside Shopify also shows live status: pixel state, GDPR webhook health, order webhook health, last event timestamp, and events-today count. Refreshes every 30 seconds while the page is open.
Troubleshooting
- I don't see events flowing yet.
- Wait the full 15 minutes — first-event latency is usually under a minute, but Shopify's Web Pixel registration can take a few minutes to propagate to all storefront edge nodes. After 15 minutes, check the embedded Admaxxer screen inside Shopify: if it shows Pixel: Active, open your storefront in incognito and check DevTools › Network for a POST to
collect.admaxxer.com. If you see the request but no event in Admaxxer, your shop domain may not be linked to a workspace — click Sign in to Admaxxer in the embedded app. - The pixel returns null email/phone for checkout events.
- This means Admaxxer's Protected Customer Data scopes (read_customer_email, read_customer_phone, read_customer_name, read_customer_address) are still pending Shopify approval. Shopify changed this rule in December 2025 — without these scopes, the Web Pixel returns
nullfor PII fields, which silently breaks Meta CAPI matching. We've applied for these scopes; they typically take 3-7 business days. The basic pixel and order webhooks still work without them — only CAPI hashed-PII matching is affected. Refresh your dashboard's CAPI match rate after we email you that scopes are approved. - I see two Shopify connections in my Admaxxer dashboard.
- If you connected Shopify before via the legacy Custom Distribution flow (pasting Client ID + Client Secret from the Shopify Dev Dashboard), both will show. Both work, but the App Store install is the primary path going forward. We recommend disconnecting the legacy custom-distribution connection after you confirm the App Store one is healthy — this removes the duplicate event stream and consolidates attribution into one source.
- How do I uninstall?
- In your Shopify admin go to Apps › Admaxxer Analytics › Uninstall. Cleanup is automatic: Shopify removes the Web Pixel, fires
app/uninstalledto Admaxxer (we mark your connection inactive within seconds), and queuesshop/redactfor 48 hours later. All shop data is deleted within 30 days per Shopify's GDPR requirements. Your Admaxxer subscription is unaffected — you can reinstall anytime, or move to the WordPress plugin or another platform. - Does this conflict with my GA4 or Meta Pixel app?
- No. The Admaxxer Web Pixel runs in Shopify's sandboxed pixel environment and has no DOM access — it can't conflict with GA4, Meta Pixel, TikTok Pixel, or any other Shopify app. Multiple analytics pixels are explicitly supported by Shopify's pixel architecture. Each pixel sees the same standard customer events and forwards them to its own endpoint.
- The OAuth screen says "App not installed" or "invalid_request".
- Almost always a stale browser session. Sign out of all Shopify admins, clear cookies for
shopify.com, and retry from apps.shopify.com/admaxxer. If it persists, contact hello@admaxxer.com with your shop domain and we'll investigate. - My OAuth completed but the embedded app shows a blank screen.
- Check that third-party cookies are enabled for
shopify.com(App Bridge requires them in Chrome's third-party-cookie-restricted mode). Reviewers test in incognito by default; if you're hitting this in Chrome incognito, that's expected — switch to a normal window or whitelist*.myshopify.comin browser settings.
What's collected
Verbatim from the Shopify App Store privacy disclosure:
- Page views — URL, title, referrer, anonymous visitor ID, timestamp.
- Product views — product ID, variant ID, title, price, currency.
- Cart events — line items added/removed, cart total, currency.
- Checkout events — checkout started, payment info submitted, checkout completed (with order ID).
- Customer email and phone (hashed) — when the Protected Customer Data scopes are approved, we receive
emailandphonefromcheckout_completedevents. Both are SHA-256 hashed (lowercase, trimmed) server-side before being forwarded to Meta CAPI / Google enhanced conversions for offline-conversion matching. Raw PII is never logged or stored at rest. - Order data via webhook — order ID, total, currency, line items, customer email (for visitor stitching), shipping/billing country (for fraud detection).
For the full list and our retention policy, see admaxxer.com/privacy.
GDPR / data deletion
When you uninstall the app, Shopify fires a shop/redact webhook 48 hours later. Admaxxer responds 2xx within milliseconds and queues a deletion job that purges all events, orders, customer hashes, and connection metadata for your shop within 30 days. This satisfies GDPR Article 17 (right to erasure) and Shopify's app store requirement.
For per-customer deletion (without uninstalling), Shopify fires customers/redact when a customer requests their data be deleted from your store. Admaxxer queues that customer's hashed email/phone and visitor ID for deletion across our datasets within 30 days.
To proactively delete your data without waiting for uninstall, email hello@admaxxer.com from the email on your Admaxxer account. Or use the self-serve /data-deletion form. We action requests within 7 days.
Pricing
The Admaxxer Shopify app is free to install. An active Admaxxer subscription is required to use it; plans start at $29/month. See admaxxer.com/pricing for the full plan matrix. Billing is handled by Stripe at admaxxer.com — the Shopify app never charges your Shopify Billing API account. You can install on multiple stores under one Admaxxer subscription (each store counts toward your tracked-events quota).
Related
- Install Admaxxer on WordPress / WooCommerce — the GPL v2+ plugin path for non-Shopify stores.
- Legacy Shopify Custom Distribution walkthrough — pre-App-Store install path. Still works for existing merchants.
- Open your Admaxxer dashboard — see Shopify under Connections after install.
- Connect Meta Ads — pair Shopify revenue with Meta spend for blended ROAS.
- Connect Google Ads — same for Google.
- All install guides — copy-paste snippets for 20+ platforms.
- Analytics overview — pixel, attribution, MER, LTV, MMM, forecast, incrementality.
- Privacy policy — what we collect, how long we keep it, your rights.