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 admaxxer-1.3.0.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-1.3.0.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 Connections › Pixel install. The Website ID is at the top of the snippet card — the line that starts data-website-id="admx_...". Copy that value (it looks like admx_a1b2c3d4e5f6).
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 sessions within 5 seconds.

Where to find your Website ID

The Website ID is shown at the top of the in-app pixel install card. The full path:

Open the Admaxxer dashboard.
Click Connections in the sidebar.
Open Pixel install. Copy the value of data-website-id from the snippet at the top of the card — that's your Website ID (always prefixed admx_).

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.

Cookieless mode (optional, GDPR-friendly)

The plugin's settings page exposes a Cookieless mode toggle. Enabling it swaps the loaded bundle to /js/script.cookieless.js — the exact same runtime the dashboard injects when you flip cookieless mode under Connections › Pixel install. No cookies are written; visitors are stitched via a salted fingerprint that rotates daily, so EU/UK consent banners are generally not required for the pixel itself (review with your DPO for final compliance). With cookieless mode off (the default), the plugin loads /js/script.js, which sets a single first-party _admx_visitor cookie with a 1-year expiry.

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

If you have WooCommerce installed, the plugin's settings page exposes a Webhook HMAC Secret field. To get the value:

Open Integrations in the Admaxxer dashboard, click WooCommerce › Connect, and copy the Signing secret from the “Final step: webhook setup” card.
Back in WordPress (Settings › Admaxxer), paste the value into the Webhook HMAC Secret field and click Save Changes.
Place a test order on your WooCommerce store. The plugin POSTs order_status_completed (and order_status_processing) to Admaxxer signed with HMAC-SHA256 of the raw JSON body. 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