About this plugin
Cleotic AI Traffic helps site owners understand how AI systems interact with their site.
The plugin works immediately after activation, without a Cleotic account. In local mode it records AI-positive events only, such as visits from known AI crawlers and referrals from AI assistants, then shows the totals in site admin.
If you connect a Cleotic account, the plugin can send signed batches of eligible traffic events to Cleotic so your site traffic appears alongside your Cleotic AI traffic analytics.
Features
- Local admin report for AI crawler visits and AI assistant referrals.
- Optional dashboard widget with recent AI traffic totals.
- Curated, explainable detection for AI crawler user agents and AI referral sources.
- Optional Cleotic connection key for signed server-side sync.
- Optional AI-events-only sync mode.
- Optional frontend beacon for AI-positive referral capture on cached pages. This is off by default.
- Configurable retention up to 90 days.
- Uninstall cleanup for plugin tables and options.
Local mode
Cleotic AI Traffic is useful without a Cleotic account. When no Cleotic connection key is configured, the plugin sends nothing to Cleotic or any other external service. It stores AI-positive evidence locally in your site database and displays it in admin.
Connected mode
When a Cleotic connection key is configured, the plugin can sync traffic to Cleotic using signed HTTPS requests. The default sync mode is all eligible pageviews because it allows Cleotic to calculate AI traffic share. You can choose AI events only if you prefer a narrower sync mode.
Cache limitations
Server-side crawler detection only works when the request reaches PHP. Full-page caches, CDN caches, and static hosting layers can serve pages before PHP runs, which means those crawler requests may not be visible to the plugin. The optional frontend beacon can help capture AI-positive referrals from cached pages, but it cannot detect crawlers that never execute browser JavaScript.
Privacy
Without a Cleotic connection key, this plugin sends no data to Cleotic.
Local mode stores AI-positive event evidence in your site database. Raw visitor IP addresses are never sent to Cleotic. Query strings and URL fragments are stripped from stored URLs and referrers.
When connected, the plugin sends signed HTTPS batches to Cleotic. Depending on your sync mode, batches may include eligible public pageview details such as URL path, method, status code, user agent, referrer, timestamp, and page title. Sync uses a timestamp-bound HMAC signature.
External services
This plugin connects to the Cleotic service only when you add a Cleotic connection key or use the Test connection button after saving a key. Cleotic AI Traffic does not send data to Cleotic in local mode.
Cleotic is an AI visibility and AI traffic analytics service provided by General Dataworks DWC-LLC. The plugin can be used to populate AI traffic analytics for Cleotic tracked sites.
ai. When connected, the plugin posts signed HTTPS JSON batches to a URL in this format:
ai/<site-token>/wordpress
The site token comes from the Cleotic connection key entered by the site administrator. The secret part of the connection key is used locally to create an HMAC signature and is not sent as a separate field.
Each request includes the JSON body, a timestamp header, and an HMAC signature header. The JSON body includes the site URL, plugin version, WordPress version, PHP version, selected sync mode, and the event batch. Depending on the selected sync mode, event batches may include eligible public pageview details such as URL path, HTTP method, status code, user agent, referrer, UTM source, timestamp, and page title.
Query strings and URL fragments are stripped from stored URLs and referrers before sync. Raw visitor IP addresses are not sent to Cleotic by this plugin.
Data is sent when WordPress cron or the manual Sync now action processes queued events. The Test connection button sends the same signed request structure with an empty event batch to verify that the connection key and endpoint work.
ai/
com/clickwrap/d9ad49df-902a-494f-8dc6-be5ee2686e6e/latest