{"id":318665,"date":"2026-05-28T14:09:48","date_gmt":"2026-05-28T14:09:48","guid":{"rendered":"https:\/\/en-ca.wordpress.org\/plugins\/pierview-agent-analytics\/"},"modified":"2026-05-28T15:56:28","modified_gmt":"2026-05-28T15:56:28","slug":"pierview-agent-analytics","status":"publish","type":"plugin","link":"https:\/\/cn.wordpress.org\/plugins\/pierview-agent-analytics\/","author":23505094,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.7","stable_tag":"1.0.7","tested":"7.0","requires":"5.9","requires_php":"7.4","requires_plugins":null,"header_name":"Pierview Agent Analytics","header_author":"Pierview","header_description":"Agent analytics for WordPress powered by Pierview.","assets_banners_color":"9398ad","last_updated":"2026-05-28 15:56:28","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/pierview.ai\/docs\/integrations\/wordpress-plugin","header_author_uri":"https:\/\/www.pierview.ai\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":64,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.4":{"tag":"1.0.4","author":"kensonpierview","date":"2026-05-28 14:09:20"},"1.0.5":{"tag":"1.0.5","author":"kensonpierview","date":"2026-05-28 15:34:40"},"1.0.6":{"tag":"1.0.6","author":"kensonpierview","date":"2026-05-28 15:54:25"},"1.0.7":{"tag":"1.0.7","author":"kensonpierview","date":"2026-05-28 15:56:28"}},"upgrade_notice":{"1.0.0":"<p>Initial release.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3552442,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3552442,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3552442,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3552442,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.4","1.0.5","1.0.6","1.0.7"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[5061,2353,232,2359,550],"plugin_category":[36],"plugin_contributors":[264800],"plugin_business_model":[],"class_list":["post-318665","plugin","type-plugin","status-publish","hentry","plugin_tags-agent","plugin_tags-ai","plugin_tags-analytics","plugin_tags-bot","plugin_tags-tracking","plugin_category-analytics","plugin_contributors-kensonpierview","plugin_committers-kensonpierview"],"banners":{"banner":"https:\/\/ps.w.org\/pierview-agent-analytics\/assets\/banner-772x250.png?rev=3552442","banner_2x":"https:\/\/ps.w.org\/pierview-agent-analytics\/assets\/banner-1544x500.png?rev=3552442","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/pierview-agent-analytics\/assets\/icon-128x128.png?rev=3552442","icon_2x":"https:\/\/ps.w.org\/pierview-agent-analytics\/assets\/icon-256x256.png?rev=3552442","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>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 <a href=\"https:\/\/www.pierview.ai\/\">Pierview<\/a> dashboard, giving you visibility into which AI systems are reading your content, how often, and which pages they visit.<\/p>\n\n<p>Read more at <a href=\"https:\/\/www.pierview.ai\/\">pierview.ai<\/a>.<\/p>\n\n<h4>Key Features<\/h4>\n\n<ul>\n<li>Named bot identification: distinguishes between 25+ AI agents including ChatGPT, Claude, Perplexity, Gemini, Grok, Bing, and more<\/li>\n<li>Zero performance impact: detection and reporting use a non-blocking background request that adds no latency to page loads<\/li>\n<li>Privacy controls: redact sensitive query parameters and exclude specific URL path prefixes from being tracked<\/li>\n<li>No database tables: lightweight footprint, clean uninstall<\/li>\n<li>Test connection: verify your API key and endpoint are working from the settings page<\/li>\n<li>Enable\/disable without deactivating: pause tracking at any time from the General settings tab<\/li>\n<\/ul>\n\n<h4>How It Works<\/h4>\n\n<ol>\n<li>On each front-end request, the plugin reads the incoming User-Agent header<\/li>\n<li>It checks the User-Agent against a list of 25+ known AI agent patterns<\/li>\n<li>If a match is found, a non-blocking HTTP POST is sent to the Pierview platform in the background<\/li>\n<li>The event appears in your Pierview dashboard with agent name, page path, and timestamp<\/li>\n<li>Regular human visitors and WordPress admin traffic are never tracked<\/li>\n<\/ol>\n\n<h4>Supported AI Agents<\/h4>\n\n<ul>\n<li>ChatGPT \/ OpenAI: GPTBot, ChatGPT-User, OAI-SearchBot<\/li>\n<li>Claude \/ Anthropic: ClaudeBot, Claude-User, Claude-SearchBot, anthropic-ai<\/li>\n<li>Perplexity: PerplexityBot, Perplexity-User<\/li>\n<li>Gemini \/ Google: Google-Extended, Google-CloudVertexBot, GoogleAgent-Mariner<\/li>\n<li>Grok \/ xAI: GrokBot, xAI-Grok, Grok-DeepSearch<\/li>\n<li>Microsoft Bing: Bingbot<\/li>\n<li>Apple: Applebot, Applebot-Extended<\/li>\n<li>Meta: FacebookBot<\/li>\n<li>Amazon: Amazonbot<\/li>\n<li>DuckDuckGo: DuckAssistBot<\/li>\n<li>Plus: Cohere, Mistral, DeepSeek, You.com, ByteDance, Phind, Diffbot, and more<\/li>\n<\/ul>\n\n<h4>Privacy &amp; Security<\/h4>\n\n<ul>\n<li>AI traffic only: only requests from known AI agent User-Agents are reported, regular visitors are never tracked<\/li>\n<li>Admin traffic excluded: wp-admin, wp-login.php, REST API, and feed requests are always skipped<\/li>\n<li>Query parameter redaction: strip sensitive parameters (e.g. <code>token<\/code>, <code>session_id<\/code>) from paths before they leave your server<\/li>\n<li>Path exclusions: exclude entire sections of your site (e.g. <code>\/checkout\/<\/code>, <code>\/members\/<\/code>) from tracking<\/li>\n<li>Nonce-protected admin: all admin actions use WordPress nonces and capability checks<\/li>\n<li>No client-side tracking: server-side only, no cookies, no JavaScript injected into your pages<\/li>\n<\/ul>\n\n<h3>External Services<\/h3>\n\n<p>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.<\/p>\n\n<p>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.<\/p>\n\n<p>Data is only transmitted when:\n* The plugin is enabled (via the \"Enable Tracking\" setting)\n* A request matches a known AI agent User-Agent pattern\n* A valid API key is configured<\/p>\n\n<p>Service provider: <a href=\"https:\/\/www.pierview.ai\/\">Pierview<\/a>\nTerms of Service: https:\/\/pierview.ai\/legal\/terms\nPrivacy Policy: https:\/\/pierview.ai\/legal\/privacy\nData Processing Agreement: https:\/\/pierview.ai\/legal\/dpa<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Download the plugin zip from the <a href=\"https:\/\/www.pierview.ai\/\">Pierview website<\/a><\/li>\n<li>In your WordPress admin go to <strong>Plugins &gt; Add New &gt; Upload Plugin<\/strong><\/li>\n<li>Upload the zip file and click <strong>Install Now<\/strong><\/li>\n<li>Activate the plugin<\/li>\n<li>Go to <strong>Settings &gt; Pierview Analytics<\/strong> and enter your API key<\/li>\n<li>Click <strong>Send Test Event<\/strong> to confirm the connection is working<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"do%20i%20need%20a%20pierview%20account%3F\"><h3>Do I need a Pierview account?<\/h3><\/dt>\n<dd><p>Yes. You need a <a href=\"https:\/\/www.pierview.ai\/\">Pierview<\/a> account and API key. The plugin sends tracking events to Pierview where you can view your analytics dashboard.<\/p><\/dd>\n<dt id=\"will%20this%20slow%20down%20my%20site%3F\"><h3>Will this slow down my site?<\/h3><\/dt>\n<dd><p>No. The plugin fires a non-blocking HTTP POST in the background only when an AI bot is detected. Page delivery is never delayed.<\/p><\/dd>\n<dt id=\"does%20this%20track%20regular%20human%20visitors%3F\"><h3>Does this track regular human visitors?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"what%20data%20is%20sent%20to%20pierview%3F\"><h3>What data is sent to Pierview?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"how%20do%20i%20exclude%20certain%20pages%20from%20tracking%3F\"><h3>How do I exclude certain pages from tracking?<\/h3><\/dt>\n<dd><p>Go to <strong>Settings &gt; Pierview Analytics &gt; Privacy<\/strong> and add path prefixes to the \"Exclude Path Prefixes\" field. For example, adding <code>\/members\/<\/code> will skip all URLs under that path.<\/p><\/dd>\n<dt id=\"can%20i%20redact%20sensitive%20query%20parameters%3F\"><h3>Can I redact sensitive query parameters?<\/h3><\/dt>\n<dd><p>Yes. Go to <strong>Settings &gt; Pierview Analytics &gt; Privacy<\/strong> 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.<\/p><\/dd>\n<dt id=\"how%20do%20i%20disable%20tracking%20temporarily%3F\"><h3>How do I disable tracking temporarily?<\/h3><\/dt>\n<dd><p>Uncheck <strong>Enable Tracking<\/strong> on the General settings tab. No events will be sent until you re-enable it. You do not need to deactivate the plugin.<\/p><\/dd>\n<dt id=\"what%20happens%20if%20the%20pierview%20api%20is%20unavailable%3F\"><h3>What happens if the Pierview API is unavailable?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"how%20do%20i%20verify%20my%20api%20key%20is%20working%3F\"><h3>How do I verify my API key is working?<\/h3><\/dt>\n<dd><p>Click <strong>Send Test Event<\/strong> on the General settings tab. The plugin will send a test payload to the configured endpoint and report the HTTP response status.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<\/ul>","raw_excerpt":"See which AI agents are reading your content \u2014 ChatGPT, Claude, Perplexity, Gemini, and more \u2014 tracked in real time via the Pierview dashboard.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/318665","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=318665"}],"author":[{"embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/kensonpierview"}],"wp:attachment":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=318665"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=318665"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=318665"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=318665"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=318665"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=318665"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}