Install guide · Shopify · ~60 seconds

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

Install in 60 seconds

  1. 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).)
  2. Click Install. Shopify prompts you to pick the store you want to install Admaxxer on, then routes you to the OAuth consent screen.
  3. 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.
    Click Install app to grant.
  4. 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.
  5. 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.

Verify it's working

  1. Open your Admaxxer dashboard.
  2. Look under ConnectionsConnected sources. Shopify should appear with your shop domain (e.g. acme-cosmetics.myshopify.com) and a green Active badge.
  3. Open your storefront in a fresh incognito tab and load any product page.
  4. Within 15 minutes (usually under 60 seconds) the pageview lands in Admaxxer › PixelRealtime. Place a $1 test order — revenue lands in AttributionRevenue 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 null for 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 AppsAdmaxxer AnalyticsUninstall. Cleanup is automatic: Shopify removes the Web Pixel, fires app/uninstalled to Admaxxer (we mark your connection inactive within seconds), and queues shop/redact for 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.com in browser settings.

What's collected

Verbatim from the Shopify App Store privacy disclosure:

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).