WordPress setup for AI traffic tracking

Install Cleotic AI Traffic from WordPress.org, activate it, then open Cleotic -> AI Traffic in WordPress. You need WordPress administrator access to install and configure the plugin.

Local mode

Leave the connection key empty to keep AI crawler and referral evidence in WordPress. Local mode does not send data to Cleotic.

Connect to a project

  1. In Cleotic, open Project Settings -> Tracking setup -> Connect a site.
  2. Choose WordPress and enter the site's domain.
  3. In Connect, click Generate key and copy the one-time connection key.
  4. Paste and save it in WordPress's Cleotic -> AI Traffic settings.
  5. Run Test connection in WordPress.
  6. Return to Cleotic and click Finish setup.

If you lose the key, rotate it in Cleotic and replace it in WordPress.

Choose what to sync

All eligible pageviews supplies the total needed to calculate AI traffic share. AI events only supplies crawler and referral evidence but leaves the total incomplete.

Use Sync now in WordPress to process queued events, or allow scheduled sync to run. A successful connection test checks credentials; inspect Sources -> AI traffic for collected events.

Caching and missing events

Requests served before WordPress/PHP runs are invisible to server-side plugin tracking. The optional frontend beacon can capture AI referrals on cached pages, but cannot see crawlers that do not execute JavaScript.

Check the saved key, domain, sync mode, and queue if events do not arrive. An ordinary visit is not necessarily an AI event.

Privacy

The plugin strips query strings and fragments from stored URLs and referrers and does not send raw visitor IP addresses to Cleotic. See the plugin's data and connection details for its current behaviour.