Skip to main content
The Trackbase Analytics plugin connects a WordPress website to Trackbase in one place. It adds the visitor tracking script and it detects crawlers server-side, so you get both visitor analytics and crawler analytics without touching your theme.

​
Before you start

In Trackbase, open Settings and keep two values at hand:
  • your project ID: the site token shown in the analytics tracking card
  • your crawler analytics token, from the WordPress tab of the crawler analytics card

​
Install and configure

1

Install the plugin

In your WordPress admin, go to Plugins → Add New. Search for “Trackbase Analytics” and install it, or upload the plugin ZIP.
2

Open the plugin settings

Activate the plugin, then open Trackbase in the WordPress sidebar.
3

Enter your project ID

Paste your project ID into the Analytics Tracking field.
4

Enter your crawler key

Paste your token into the Crawler Analytics Key field.
5

Handle caching

If your website uses a caching plugin, tick Bypass page cache for AI crawlers under Cache compatibility.
6

Save

Click Save Changes.

​
Why caching matters

A page cache serves a stored copy of a page before WordPress runs. The plugin then never sees the request, and crawler visits to cached pages go uncounted. With Bypass page cache for AI crawlers turned on, the plugin registers the AI crawler user agents with your caching plugin, so those requests reach WordPress. Search engine crawlers keep getting cached pages, so there is no effect on their crawl speed. The bypass works with WP Rocket, W3 Total Cache, WP Super Cache, LiteSpeed Cache, WP Fastest Cache and SiteGround Speed Optimizer.
Caches at server level are not supported by the bypass. This includes Nginx FastCGI cache, Varnish, Kinsta, WP Engine and Cloudflare APO. For those, exclude the AI crawler user agents from the cache yourself. The list of user agents is shown in the WordPress tab in Trackbase and on the plugin settings page.

​
Verify that it works

1

Send a test request

Run this command from any terminal. Replace the domain with your own website.
2

Check the request log

Open the Crawlers page in Trackbase. The GPTBot request should appear in the request log within a minute.
No request in the log? Check the Cache compatibility status in the plugin, or exclude the user agents in your cache manually.

​
Good to know

The crawler analytics token is the same token that Cloudflare Logpush uses. If you regenerate it, update it in WordPress and in any Logpush job that uses it.
Last modified on November 12, 2026