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.

Before you start

You need a MetriXs account. The plugin itself is free and fully functional; a free MetriXs plan is enough to get started.

1. Go to app.metrixs.eu and sign up
2. Verify your email address via the link you receive

Step 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)

Step 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

Step 3: Install the plugin

From your WordPress admin:

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

Step 4: Configure the plugin

Go to Settings → MetriXs 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.

Step 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.

Step 6: 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 (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

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.