WordPress plugin

The TrueMetriks WordPress plugin tracks your pageviews, leads, and WooCommerce sales automatically. Here is how to set it up.

Set this up with AI

Copy this prompt into ChatGPT, Claude or whichever AI you use. It carries this whole guide, the pages it depends on, and a link to every video, so it can walk you through it one step at a time.

Open as text

Video guide

How to install the TrueMetriks plugin on WordPress

Open the Plugins menu in WP Admin

Log in to your WordPress admin. In the left sidebar, hover Plugins, then click Add Plugin from the flyout.

  • Appearance
  • Plugins
  • Users
  • Tools
  • Settings
  • Installed Plugins
  • Add Plugin
  • Plugin File Editor
WP Admin sidebar - hover Plugins, then click Add Plugin

If your WP Admin is set to a compact sidebar, the flyout appears as soon as you hover. On a wider sidebar you can also click Plugins > Installed Plugins, then click the Add Plugin button next to the page title.

Plugins

All (32) | Active (29) | Inactive (3) | Update Available (8)
Plugins page - click Add Plugin to open the install screen

Both routes land you on the same Add Plugins screen.

Find the TrueMetriks plugin

On the Add Plugins screen, type TrueMetriks into the Search Plugins box in the top right. The TrueMetriks Analytics plugin by TrueMetriks appears in the results.

Add Plugins

  • Search Results
  • Featured
  • Popular
  • Recommended
  • Favorites
1 item

Complete analytics for WooCommerce: customer journeys, funnel reports, true ROAS, plus server-side tracking for Facebook, Google & GA4.

By TrueMetriks
Less Than 10 Active Installations
Last Updated: recently
✓ Compatible with your version of WordPress
Add Plugins > search TrueMetriks, then click Install Now on TrueMetriks Analytics

Install and activate

Click Install Now on the TrueMetriks Analytics plugin. WordPress downloads and installs it in a few seconds, then the button turns into Activate - click it to turn the plugin on.

Complete analytics for WooCommerce: customer journeys, funnel reports, true ROAS, plus server-side tracking for Facebook, Google & GA4.

By TrueMetriks
After install the button becomes Activate - click it to turn the plugin on

Connect the plugin to TrueMetriks

After activation, open TrueMetriks Analytics in the WP Admin sidebar. You will see the connect screen below.

TrueMetriks Analytics

Connect to TrueMetriks

Connect this WordPress site to your TrueMetriks account to start tracking visitors, purchases, and ad attribution.

TrueMetriks Analytics in WP Admin - click Sign in with TrueMetriks to connect

Click Sign in with TrueMetriks. You will be taken to your TrueMetriks dashboard to authorize the plugin.

Connect TrueMetriks Analytics plugin

Connect the WordPress plugin to your TrueMetriks account. The plugin will be able to send tracking events on behalf of the site you select.

yourdomain.com
Pick the site to connect, then click Allow

Pick the site you want to connect from the Site dropdown, then click Allow. That is it - the plugin is connected and tracking.

For WooCommerce stores, place a test order while logged out to check it - the order should appear in Events and Revenue within about 10 seconds.

Choose a privacy mode

The plugin settings have a Privacy card with three options: Full tracking, Consent banner (GDPR) and HIPAA (cookieless). It is the same setting as Privacy & Security in your TrueMetriks dashboard, so you can change it in either place.

For Consent banner (GDPR), also pick the Banner position and check the Privacy policy link (optional). The link is filled in from your WordPress privacy page when it uses https://. If you already run a cookie plugin such as Complianz, CookieYes or Cookiebot, tick I already use a consent tool so visitors see only one banner. Your consent tool must publish Google Consent Mode v2 or call tm.consent(), or every visitor stays cookieless.

In Consent banner (GDPR) mode a WooCommerce order is passed on to your ad platforms only when the buyer clicked Accept. In HIPAA (cookieless) mode orders are never passed on, so your ads will not optimize on them. See GDPR and HIPAA compliance for what each mode does.

WooCommerce Subscriptions

If your store runs WooCommerce Subscriptions, renewals are labelled automatically from plugin version 1.0.31. Without that version, nothing changes.

Each subscription order is labelled as a new sale or a renewal. The order that starts a subscription is a new sale, and so are switch and resubscribe orders.

Every renewal order WooCommerce Subscriptions creates is a renewal. It is sent when WooCommerce marks the renewal order paid, like any other order.

Free trials. When a subscription starts with a free trial, the first paid renewal order after the $0 parent order is the new sale, and the renewal orders after that are renewals.

A renewal is matched to the buyer by their email. It does not reuse the visit or cookies from the original checkout.

Renewals inside TrueMetriks. A renewal stays a Purchase in your dashboard, so Total revenue includes it. It is credited to the channel that won the subscription's start (the first sale, or the trial signup for a free trial). This applies going forward: payments made before launch are not relabelled.

What your ad platforms receive. A first payment always goes to your ad platforms as a Purchase. For renewals, open Settings > Integrations, click the Subscription renewals tile and pick one under Send renewals to ad platforms as: a custom event (named Renewal unless you change it), a Purchase, or don't send. The tile shows the current choice. The setting is one per site and covers every payment source.

Sites that existed before this setting started on Purchase, so nothing changes for them until they pick another option. Sites created after launch start on a custom event named Renewal.

When renewals go out as a custom event or are not sent, they are not uploaded to Google Ads. When they go out as a Purchase, they upload to Google Ads like any other Purchase.

On Facebook, a custom conversion keyed on Purchase does not fire for a renewal sent as a custom event.

See Revenue for how renewals show in your dashboard.

WooCommerce refunds

From plugin version 1.0.32, a refund you make in WooCommerce is sent to TrueMetriks automatically and taken off the sale it belongs to. Update the plugin from Plugins if yours is older.

A partial refund takes off the amount you refunded. A full refund, where WooCommerce marks the order Refunded, takes off the whole sale.

Two partial refunds of one order both count.

The sale keeps its date and its ad, so the refund lowers revenue, ROAS and profit on the day of the sale. See Refunds on the Revenue page.

Each refunded order gets a note: TrueMetriks: Refund sent when it reached TrueMetriks, or a note saying why it was not sent.

Refunds never go to your ad platforms. They only change your numbers in TrueMetriks.

Refunds made before you updated to 1.0.32 are not sent.

Cache and speed plugins

Cache and speed plugins, such as LiteSpeed Cache, WP Rocket, W3 Total Cache and Autoptimize, save copies of your pages and change how JavaScript loads. Two things matter for TrueMetriks.

The page cache. A cache keeps showing visitors the copies of your pages it saved before you connected TrueMetriks, and those copies do not have the tracker. When you connect, the plugin asks your cache plugin to clear its cache for you.

If the tracker is still missing from your live homepage, a warning appears in WP Admin and in your TrueMetriks dashboard. Click Clear cache now in the warning, or clear the cache in your cache plugin, then click Check again.

Minify, combine, defer and delay. TrueMetriks marks its script so these plugins leave it alone. If your plugin still changes it, add your tracker hostname to every JavaScript exclude list the plugin has. Your tracker hostname is shown next to Tracker on the TrueMetriks page in WP Admin, for example kite.yourstore.com.

Where to find the exclude lists:

Plugin Where to add your tracker hostname
LiteSpeed Cache LiteSpeed Cache > Page Optimization > Tuning: JS Excludes and JS Deferred / Delayed Excludes
WP Rocket Settings > WP Rocket > File Optimization: the Excluded JavaScript Files box under minify / combine, under Load JavaScript deferred and under Delay JavaScript execution
W3 Total Cache Performance > Minify, JS section: Never minify the following JS files
Autoptimize Settings > Autoptimize > JavaScript Options: Exclude scripts from Autoptimize
Other plugins Look for a JavaScript "exclude" or "excluded files" box in the plugin's settings

After you change these settings, clear the cache once so visitors get the updated pages.

How to test

After connecting the plugin, the next step is verifying everything is firing correctly. See Test your integration for the full walkthrough.

Something not firing? See Troubleshooting.

Frequently asked questions

How do I find the plugin in WordPress?

In your WordPress admin go to Plugins > Add Plugin, then search for TrueMetriks. The TrueMetriks Analytics plugin by TrueMetriks appears in the results - click Install Now, then Activate. You can also view the public listing at wordpress.org/plugins/truemetriks-analytics.

I searched but cannot find it. What now?

Make sure you are on Plugins > Add Plugin (the WordPress.org directory search), not Upload Plugin, and type TrueMetriks exactly. The listing is live at wordpress.org/plugins/truemetriks-analytics; give WordPress.org a few minutes if a brand-new search index has not picked it up yet.

Does the plugin work without WooCommerce?

Yes. The plugin always tracks pageviews. WooCommerce purchase, add-to-cart, and checkout events light up automatically if WooCommerce is active. Lead events from Contact Form 7, WPForms, and Gravity Forms light up the same way when those plugins are active.

Will the plugin slow down my site?

No. The tracker is a tiny async script served from your own first-party domain (see CNAME setup). Event tracking is lightweight and adds only a few milliseconds to the relevant request.

How do I update the plugin later?

Updates are one-click from WP Admin. When we publish a new version to WordPress.org, WordPress shows an update notice under Plugins - click Update and you are done.

Need help with this?

Reach us instantly on WhatsApp, or send us a message and we will get back to you. On workdays we usually respond in less than 24 hours.

or send us a message