Description
Trackbase Analytics is the official WordPress plugin for Trackbase. It gives you two things in one simple settings page:
- Analytics Tracking — enter your Trackbase project ID once and the Trackbase analytics script is automatically loaded in the
<head>of every page on your site. - Crawler Analytics — detect bot and crawler visits server-side and send them to Trackbase. Works without Cloudflare, without JavaScript, and without any extra infrastructure.
This plugin requires a (free or paid) Trackbase account and relies on the Trackbase third-party service to function. Both features are opt-in: nothing is sent to Trackbase until you enter a project ID and/or a crawler key in the plugin settings. See the “External services” section below for full details on what data is transmitted and when.
External services
This plugin connects to Trackbase, a third-party software-as-a-service platform operated by Trackbase, to provide its analytics and crawler-tracking functionality. The plugin is not functional on its own and requires a Trackbase account. The plugin only contacts the Trackbase service when you have entered a project ID and/or crawler key on the settings page.
The service is provided by Trackbase. Its terms and policies are available here:
- Terms of Service: https://trackbase.ai/terms-of-service/
- Privacy Policy: https://trackbase.ai/privacy-policy/
1. Analytics Tracking script (https://app.trackbase.ai/js/tracker.js)
When a Trackbase project ID is configured, a <script> tag is added to the front end of your site that loads the Trackbase analytics script from app.trackbase.ai. This script runs in your visitors’ browsers and collects standard web analytics data such as page URL, referrer, browser type, screen size, and approximate location derived from IP address.
- What it is used for: collecting website analytics so you can view visitor data in your Trackbase dashboard.
- Data sent: standard web analytics events triggered in the visitor’s browser (page URL, referrer, browser type, screen size, approximate location derived from IP address).
- When it is sent: on every page view by a visitor on the front end of your site, only when a project ID is configured.
- Service provider: Trackbase
- Terms of Service: https://trackbase.ai/terms-of-service/
- Privacy Policy: https://trackbase.ai/privacy-policy/
2. Crawler Analytics ingest endpoint (https://app.trackbase.ai/api/ingest/wordpress-crawler)
When a Crawler Analytics key is configured, the plugin detects bot/crawler visits on your server and sends a small JSON payload to Trackbase’s ingest endpoint for each detected crawler hit.
- What it is used for: monitoring how search engine and AI crawlers interact with your website so you can view crawler analytics in your Trackbase dashboard.
- Data sent for each crawler hit: timestamp, requesting client IP address, User-Agent string, requested host, requested path, HTTP method, referrer, HTTP response status, the source identifier “wordpress-plugin”, and the plugin version.
- When it is sent: only on front-end page requests where the User-Agent matches a known crawler/bot pattern, and only when a crawler key is configured.
- Service provider: Trackbase
- Terms of Service: https://trackbase.ai/terms-of-service/
- Privacy Policy: https://trackbase.ai/privacy-policy/
By installing this plugin and entering your credentials, you authorize the plugin to transmit the data described above to Trackbase. To stop all transmission, clear the project ID and crawler key fields in the plugin settings.
Privacy
This plugin transmits data to a third-party service (Trackbase) as documented in the “External services” section above. The plugin itself does not store personal data in your WordPress database — only your Trackbase project ID and crawler key are stored as plugin options.
The plugin automatically registers a suggested privacy policy text using wp_add_privacy_policy_content(). To include it in your site’s privacy policy, go to Tools Privacy in your WordPress admin and review the suggested text for “Trackbase Analytics”.
Site owners in jurisdictions with consent requirements (such as GDPR/ePrivacy in the EU/EEA, or similar laws elsewhere) are responsible for obtaining the appropriate visitor consent before enabling analytics tracking on the front end of their site.
Support
Questions? Visit www.trackbase.ai or use the Contact Support button inside the plugin settings.
Installation
- Upload the
trackbase-analyticsfolder to/wp-content/plugins/, or install the ZIP through the WordPress Plugins screen. - Activate the plugin through the Plugins menu in WordPress.
- Go to Trackbase in the WordPress admin sidebar.
- Enter your Trackbase project ID and/or your Crawler Analytics key.
- Click Save Changes. You’re done.
FAQ
-
Where do I find my project ID and crawler key?
-
Log in to your Trackbase dashboard and copy them from the Analytics Tracking and Crawler Analytics sections respectively.
-
Does the crawler tracking slow down my site?
-
No. Hits are sent using a non-blocking HTTP request, so the response is returned to the visitor before we send anything to Trackbase.
-
Do I need Cloudflare?
-
No. This plugin detects crawlers directly in PHP, so it works on any WordPress host.
-
How do I disable data collection?
-
Leave the project ID and crawler key fields empty (or clear them) and save. The plugin will not contact Trackbase servers when both fields are empty.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Trackbase Analytics” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Trackbase Analytics” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release.