Install guide · framework · ~3 min

Install Admaxxer on React Native / Expo

Mobile apps: track via the API (the pixel is browser-only).

The Admaxxer pixel and the @admaxxer/pixel npm SDK both need a browser DOM, which a React Native / Expo app does not have — so neither runs inside a native app. For now, send your key mobile events (signups, trials, purchases) to Admaxxer from your server with a simple API call. A dedicated native SDK is on the roadmap.

Steps

  1. 1 Send events from your backend

    When your mobile app reports a conversion to your server, forward it to Admaxxer with a server-side API call. See the API reference for the event schema and authentication.

  2. 2 Stitch the user identity

    Pass the same user email or id you use elsewhere so mobile conversions stitch to the same customer profile as your web funnel — that keeps attribution consistent across web and app.

Verify installation

Troubleshooting

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.