Description
AI assistants like ChatGPT, Claude, Perplexity, and Gemini crawl websites to generate answers for their users. Pierview Agent Analytics detects these visits and reports them to your Pierview dashboard, giving you visibility into which AI systems are reading your content, how often, and which pages they visit.
Read more at pierview.ai.
Key Features
- Named bot identification: distinguishes between 25+ AI agents including ChatGPT, Claude, Perplexity, Gemini, Grok, Bing, and more
- Zero performance impact: detection and reporting use a non-blocking background request that adds no latency to page loads
- Privacy controls: redact sensitive query parameters and exclude specific URL path prefixes from being tracked
- No database tables: lightweight footprint, clean uninstall
- Test connection: verify your API key and endpoint are working from the settings page
- Enable/disable without deactivating: pause tracking at any time from the General settings tab
How It Works
- On each front-end request, the plugin reads the incoming User-Agent header
- It checks the User-Agent against a list of 25+ known AI agent patterns
- If a match is found, a non-blocking HTTP POST is sent to the Pierview platform in the background
- The event appears in your Pierview dashboard with agent name, page path, and timestamp
- Regular human visitors and WordPress admin traffic are never tracked
Supported AI Agents
- ChatGPT / OpenAI: GPTBot, ChatGPT-User, OAI-SearchBot
- Claude / Anthropic: ClaudeBot, Claude-User, Claude-SearchBot, anthropic-ai
- Perplexity: PerplexityBot, Perplexity-User
- Gemini / Google: Google-Extended, Google-CloudVertexBot, GoogleAgent-Mariner
- Grok / xAI: GrokBot, xAI-Grok, Grok-DeepSearch
- Microsoft Bing: Bingbot
- Apple: Applebot, Applebot-Extended
- Meta: FacebookBot
- Amazon: Amazonbot
- DuckDuckGo: DuckAssistBot
- Plus: Cohere, Mistral, DeepSeek, You.com, ByteDance, Phind, Diffbot, and more
Privacy & Security
- AI traffic only: only requests from known AI agent User-Agents are reported, regular visitors are never tracked
- Admin traffic excluded: wp-admin, wp-login.php, REST API, and feed requests are always skipped
- Query parameter redaction: strip sensitive parameters (e.g.
token,session_id) from paths before they leave your server - Path exclusions: exclude entire sections of your site (e.g.
/checkout/,/members/) from tracking - Nonce-protected admin: all admin actions use WordPress nonces and capability checks
- No client-side tracking: server-side only, no cookies, no JavaScript injected into your pages
External Services
This plugin transmits data to the Pierview analytics service when a known AI agent bot is detected visiting your site. No data is sent for regular human visitors.
The following data is sent on each detected bot visit: the bot’s User-Agent string, normalized agent name, your site’s hostname, the request path, HTTP method, HTTP referer header, the visitor’s IP address, and a UTC timestamp.
Data is only transmitted when:
* The plugin is enabled (via the “Enable Tracking” setting)
* A request matches a known AI agent User-Agent pattern
* A valid API key is configured
Service provider: Pierview
Terms of Service: https://pierview.ai/legal/terms
Privacy Policy: https://pierview.ai/legal/privacy
Data Processing Agreement: https://pierview.ai/legal/dpa
Installation
- Download the plugin zip from the Pierview website
- In your WordPress admin go to Plugins > Add New > Upload Plugin
- Upload the zip file and click Install Now
- Activate the plugin
- Go to Settings > Pierview Analytics and enter your API key
- Click Send Test Event to confirm the connection is working
FAQ
-
Do I need a Pierview account?
-
Yes. You need a Pierview account and API key. The plugin sends tracking events to Pierview where you can view your analytics dashboard.
-
Will this slow down my site?
-
No. The plugin fires a non-blocking HTTP POST in the background only when an AI bot is detected. Page delivery is never delayed.
-
Does this track regular human visitors?
-
No. The plugin only records visits from known AI agent User-Agents. Regular browser traffic, WordPress admin activity, REST API calls, and login page requests are all ignored.
-
What data is sent to Pierview?
-
Each event includes: the matched agent name, bot User-Agent string, your site’s hostname, the request path, HTTP method, referer header, visitor IP address, and a UTC timestamp. No page content or WordPress user data is ever collected.
-
How do I exclude certain pages from tracking?
-
Go to Settings > Pierview Analytics > Privacy and add path prefixes to the “Exclude Path Prefixes” field. For example, adding
/members/will skip all URLs under that path. -
Can I redact sensitive query parameters?
-
Yes. Go to Settings > Pierview Analytics > Privacy and add parameter names (one per line) to the “Redact Query Parameters” field. Those parameters will be stripped from the path before the event is sent to Pierview.
-
How do I disable tracking temporarily?
-
Uncheck Enable Tracking on the General settings tab. No events will be sent until you re-enable it. You do not need to deactivate the plugin.
-
The tracking request uses a non-blocking fire-and-forget POST. If the endpoint is unreachable, the request times out silently with no impact on your site.
-
How do I verify my API key is working?
-
Click Send Test Event on the General settings tab. The plugin will send a test payload to the configured endpoint and report the HTTP response status.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Pierview Agent Analytics” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Pierview Agent 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