WordPress plugin

MetriXs has a first-party WordPress plugin that adds the tracker to every page of your site, verifies your site automatically, and can track WooCommerce revenue server-side. No child theme, no code editing, no consent banner.

This guide walks through the full setup, step by step.

Quick start (one click, recommended)

No MetriXs account needed yet, and nothing to copy:

1. In your WordPress admin, go to Plugins → Add New Plugin, search for “MX Cookieless Analytics”, install and activate it
2. Go to Settings → MX Cookieless Analytics and click Connect with MetriXs
3. The MetriXs dashboard opens: create your account (or log in), pick a plan, and click Connect site — your site is added, connected and verified automatically, and you land back in WordPress with tracking live

That’s it. Your site shows as Verified in the MetriXs dashboard and the plugin settings show the green “Site connected” notice.

Works on your phone: no snippet, no API key, no switching between apps.

Manual setup (API key)

Prefer to set things up by hand, or managing the site for an agency? The classic flow works unchanged.

1. Add your site in MetriXs

1. Log in to the MetriXs dashboard
2. During onboarding (or via Settings → Sites), add your site’s domain, e.g. yourdomain.com — without https:// and without www.
3. Skip the dashboard’s snippet verification step — the plugin verifies your site automatically in step 5
4. If prompted, start a trial or pick the free plan (events require an active plan)

2. Create a site API key

The plugin authenticates with a site-scoped API key. It only grants access to that one site (stats:read + event:write), never to your account, and can be revoked at any time.

1. In the dashboard, go to Settings → Sites
2. Expand your site and find the API keys section
3. Click Create API key and give it a name, e.g. “WordPress”
4. Copy the key (mtx_live_...) immediately — it is shown once and cannot be retrieved later

3. Install the plugin

From your WordPress admin:

1. Go to Plugins → Add New Plugin
2. Search for “MX Cookieless Analytics”
3. Click Install Now, then Activate

4. Configure the plugin

Go to Settings → MX Cookieless Analytics:

Field	What to enter
Site domain	Usually pre-filled with your site’s hostname; must match the domain registered in MetriXs
MetriXs URL	Leave at the default https://app.metrixs.eu
Site API key	The key from step 2

Click Save Changes.

5. Connect and verify

This replaces manual verification — it only needs to be done once.

1. On the same settings page, click Connect & verify site
2. You should see the green notice “Site connected. Tracking is live”
3. In the MetriXs dashboard, your site now shows as Verified

How it works: the plugin asks the MetriXs API for a one-time challenge token, serves it from your own domain, and the API fetches it back. Only someone who controls your domain can serve the token, so this proves ownership.

Verify tracking works

1. Open your site in an incognito/private window and browse a few pages
2. Open the MetriXs dashboard and check the Realtime view — pageviews should appear within seconds

Note: logged-in administrators are excluded from tracking by default (you usually don’t want to count yourself). Test from an incognito window or adjust the exclusions in the plugin settings.

WooCommerce (optional)

If you run WooCommerce, enable revenue tracking:

1. Save your API key first (manual setup, step 4)
2. On the plugin settings page, check the WooCommerce option
3. Save, then click Connect & verify site once more — this also enables commerce for the site in MetriXs
4. Place a test order to confirm

Once enabled, the MetriXs dashboard shows:

• Revenue, Average Order Value and conversion rate
• The conversion funnel: visitors → checkout → payment → order
• Top products by revenue

The events are sent server-side from your WordPress server, so redirect-based payment methods (iDEAL, Bancontact, etc.) are captured reliably. Revenue is converted to EUR automatically using daily ECB rates and displayed in your chosen display currency.

Settings reference

Setting	Default	Meaning
Site domain	Your site’s hostname	Must match the domain in MetriXs
MetriXs URL	https://app.metrixs.eu	Only change for custom endpoints
Site API key	—	Site-scoped key from the dashboard
Exclude all logged-in visitors	Off	Don’t track anyone who is logged in
Exclude roles	Administrator on	Pick which user roles to exclude
WooCommerce	Off	Server-side commerce events

Developers can also use the metrixs_settings filter, the metrixs_script_attributes filter, the metrixs_exclude_visitor filter, or define METRIXS_DISABLE_TRACKING (e.g. on staging sites) in wp-config.php.

Troubleshooting

One-click connect fails (“did not complete” notice)

• The connect request expires after 15 minutes or was already used — click Connect with MetriXs again
• If it keeps failing, use the manual API-key flow below

Verification fails

• Check that your permalinks are not set to “Plain” (Settings → Permalinks — pick any other structure and save; the verification route needs pretty permalinks on some setups)
• Make sure your site is publicly reachable (no maintenance mode, no firewall blocking the MetriXs servers)
• Wait a minute and try again

No data in the dashboard

• The settings page must show “Connected”
• The domain in the plugin must exactly match the domain in MetriXs (no www., no https://)
• You are logged in as admin? You’re excluded by default — test incognito
• Using a caching plugin? Purge the cache so the tracker script lands on your pages

API key lost Keys cannot be retrieved after creation. Revoke the old one in the dashboard (Settings → Sites → API keys), create a new one, and update it in the plugin settings.

Uninstalling

When you deactivate and delete the plugin:

• Your site is automatically disconnected in MetriXs (events stop being accepted)
• Your historical data stays in your MetriXs account
• The plugin’s options are removed from your WordPress database

Prefer no plugin?

You can always add the tracker manually with the snippet from the platform guides — the plugin simply automates installation, verification and WooCommerce tracking.