Install the Admaxxer WordPress plugin

What this is: a 3-minute walkthrough for installing the official Admaxxer WordPress plugin. The plugin auto-injects the Admaxxer pixel on every page (no theme editing) and, if you have WooCommerce, forwards order revenue to Admaxxer via signed HMAC webhooks for first-party attribution — matched to the visitor's session even when ad blockers strip the client-side pixel.

What you get once installed

Auto-injected pixel. Every WordPress page (posts, pages, products, archive, cart, checkout) gets the Admaxxer pixel without you touching header.php.
WooCommerce revenue webhooks. Each completed or processing order POSTs to Admaxxer, signed with HMAC-SHA256, so revenue lands even when ad blockers strip the client-side pixel.
Visitor stitching. The plugin reads admx_visitor_id from the order's session metadata so each order is attributed to the right click/source.
HPOS-compatible. Works with WooCommerce's High-Performance Order Storage (HPOS) without changes.

Step 1 — Download the plugin ZIP (~30 sec)

Sign in to Admaxxer and open Integrations › WooCommerce (or the WordPress card on the integrations page).
Click Download Plugin. You'll get a file named admaxxer-wordpress.zip — about 30 KB.
Don't unzip it — WordPress wants the ZIP as-is.

Step 2 — Upload to WordPress (~1 min)

Sign in to your WordPress admin (https://yourstore.com/wp-admin) as a user with the install_plugins capability (Administrator role by default).
In the left sidebar: Plugins > Add New Plugin > Upload Plugin (button at the top).
Click Choose File, pick admaxxer-wordpress.zip, and click Install Now. WordPress unpacks the plugin into /wp-content/plugins/admaxxer/.

Step 3 — Activate the plugin (~10 sec)

After install, click Activate Plugin. You'll see a top-of-page banner: "Admaxxer activated. Configure your Website ID under Settings › Admaxxer."

Step 4 — Paste your Website ID (~30 sec)

In the WP admin sidebar: Settings > Admaxxer.
Back in Admaxxer (your dashboard tab), open Websites and copy the Website ID for the site you want to track. It's a UUID like w_8f2b91....
Paste it into the WordPress Website ID field, click Save Changes.
The plugin starts injecting the pixel on the next page load. Visit your storefront in an incognito window — you'll see a real-time pageview in Admaxxer's live analytics within 5 seconds.

Step 5 — Optional: advanced settings (~30 sec)

The plugin's settings page also exposes:

Disable on staging. If your site has a staging copy, tick this on staging so test traffic doesn't pollute production analytics.
Pixel placement. Defaults to wp_head for fastest load; switch to wp_footer if a caching plugin strips inline head scripts.
Debug mode. Tick this once to log the injection target to the JS console — useful when troubleshooting "why isn't my pixel firing?". Untick when you confirm it works.

Step 6 — Optional: WooCommerce HMAC webhook secret (~30 sec)

If you have WooCommerce installed, the plugin auto-detects it and adds a WooCommerce sub-section to the settings page:

Click Generate Secret. The plugin creates a random 32-byte HMAC secret stored in WP options (wp_options).
Copy the secret. Back in Admaxxer, open Integrations › WooCommerce, paste the secret in the Webhook Secret field, and click Save.
Place a test order on your WooCommerce store. The plugin POSTs order_status_completed (and order_status_processing) to Admaxxer signed with the shared HMAC secret. Revenue shows up in your dashboard within a minute.

HPOS-compatible (no changes needed)

The plugin uses the abstract WC_Order API, so it works identically on legacy wp_postmeta order storage and on the new High-Performance Order Storage (HPOS). You don't need to flip any flags.

Caching-plugin gotchas

Aggressive caching plugins can strip or delay the pixel. Configure exclusions for these:

WP Rocket. Settings > File Optimization > under JavaScript, add admaxxer to the Excluded Inline JS list. Then under Cache > Don't cache pages, add /checkout/ and /cart/ if not already excluded.
W3 Total Cache. Performance > Page Cache > Never cache the following pages — add /checkout/ and /cart/. Also untick Minify HTML inline JS on the Minify page.
LiteSpeed Cache. LiteSpeed Cache > Page Optimization > Tuning > under JS Excludes, add admaxxer.

For the authoritative source, the WordPress plugin is open-source at wp-plugin/admaxxer/ in the Admaxxer repo — you can review every line before installing.

FAQ

Q: I'm seeing pageviews but no revenue in Admaxxer. What's wrong?

The most common cause is missing the WooCommerce HMAC secret (Step 6 above). Pageviews use the JS pixel; revenue uses signed webhooks. Check Settings > Admaxxer > WooCommerce in WP admin — if the Webhook Secret field is blank, click Generate Secret, paste it into Admaxxer, and place a fresh test order.

Q: My theme is using a custom checkout flow. Will the plugin still attribute revenue?

Yes — the plugin hooks WooCommerce's woocommerce_order_status_completed and woocommerce_order_status_processing actions, which fire regardless of the front-end checkout UI. As long as orders go through WooCommerce's WC_Order object, attribution works.

Q: Does the plugin slow down my site?

No measurable impact. The pixel is a single async <script> tag (under 5 KB gzipped). The PHP plugin only runs at wp_head emit and on order-status hooks, neither of which is a hot path.

WooCommerce revenue webhook setup · Shopify integration overview · Install the Admaxxer pixel on any platform · Documentation home