Install guide · cms · ~3 min

Install Admaxxer on WordPress

One-click plugin, WooCommerce-aware.

The Admaxxer WordPress plugin handles pixel injection and WooCommerce revenue attribution (via the woocommerce_thankyou hook) automatically. No theme edits required.

Steps

  1. 1 Download the plugin

    Grab the latest plugin ZIP from /wp-plugin/dist/admaxxer-1.0.0.zip.

  2. 2 Upload & activate

    In WordPress admin, go to Plugins → Add New → Upload Plugin, upload the ZIP, and click Activate.

  3. 3 Paste your website ID

    Open Settings → Admaxxer, paste your website ID, and save. The plugin injects the pixel site-wide and registers WooCommerce order hooks.

  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 plugin shows "Activated" but no events arrive.
Check if a caching plugin (WP Rocket, W3 Total Cache, LiteSpeed) is stripping the pixel. Exclude cdn.admaxxer.com from minification and deferred-JS rules.
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 · Shopify · Ghost · All platforms