{"id":372867,"date":"2026-09-22T08:13:14","date_gmt":"2026-09-22T08:13:14","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/ai-agent-traffic-sensor\/"},"modified":"2026-09-22T08:35:15","modified_gmt":"2026-09-22T08:35:15","slug":"atsens-ai-agents-traffic-analytics","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/atsens-ai-agents-traffic-analytics\/","author":23526898,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"0.1.0","stable_tag":"0.1.0","tested":"7.1.2","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"Atsens AI Agents Traffic Analytics","header_author":"Agent Ready Commerce","header_description":"Tracks AI crawler bots and chat-platform referrals with WooCommerce order attribution.","assets_banners_color":"e2f7f5","last_updated":"2026-09-22 08:35:15","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/wordpress.org\/plugins\/atsens-ai-agents-traffic-analytics\/","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":71,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.1.0":{"tag":"0.1.0","author":"lebedgor","date":"2026-09-22 08:35:15","revision":3706885}},"upgrade_notice":{"0.1.0":"<p>Initial public release.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3706810,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3706810,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3706810,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.1.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3706810,"resolution":"1","location":"assets","locale":"","width":2626,"height":1892},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3706810,"resolution":"2","location":"assets","locale":"","width":2626,"height":1892},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3706810,"resolution":"3","location":"assets","locale":"","width":2626,"height":1892},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3706810,"resolution":"4","location":"assets","locale":"","width":2626,"height":1892}},"screenshots":{"1":"Dashboard \u2014 30-day summary of AI bot crawls, chat referrals and attributed orders, with a daily activity chart","2":"Dashboard \u2014 which AI bots crawl your store (by category) and which product pages they read most","3":"Dashboard \u2014 per-product agent activity and recent orders attributed to chat-platform visits","4":"Readiness \u2014 a 0\u2013100 audit of how ready your store is for AI agents, with one-click fixes for failed checks"}},"plugin_section":[],"plugin_tags":[2353,232,4866,216196,286],"plugin_category":[36,45],"plugin_contributors":[275459],"plugin_business_model":[],"class_list":["post-372867","plugin","type-plugin","status-publish","hentry","plugin_tags-ai","plugin_tags-analytics","plugin_tags-bots","plugin_tags-chatgpt","plugin_tags-woocommerce","plugin_category-analytics","plugin_category-ecommerce","plugin_contributors-lebedgor","plugin_committers-lebedgor"],"banners":{"banner":"https:\/\/ps.w.org\/atsens-ai-agents-traffic-analytics\/assets\/banner-772x250.png?rev=3706810","banner_2x":"https:\/\/ps.w.org\/atsens-ai-agents-traffic-analytics\/assets\/banner-1544x500.png?rev=3706810","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/atsens-ai-agents-traffic-analytics\/assets\/icon-128x128.png?rev=3706810","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/atsens-ai-agents-traffic-analytics\/assets\/screenshot-1.png?rev=3706810","caption":"Dashboard \u2014 30-day summary of AI bot crawls, chat referrals and attributed orders, with a daily activity chart"},{"src":"https:\/\/ps.w.org\/atsens-ai-agents-traffic-analytics\/assets\/screenshot-2.png?rev=3706810","caption":"Dashboard \u2014 which AI bots crawl your store (by category) and which product pages they read most"},{"src":"https:\/\/ps.w.org\/atsens-ai-agents-traffic-analytics\/assets\/screenshot-3.png?rev=3706810","caption":"Dashboard \u2014 per-product agent activity and recent orders attributed to chat-platform visits"},{"src":"https:\/\/ps.w.org\/atsens-ai-agents-traffic-analytics\/assets\/screenshot-4.png?rev=3706810","caption":"Readiness \u2014 a 0\u2013100 audit of how ready your store is for AI agents, with one-click fixes for failed checks"}],"raw_content":"<!--section=description-->\n<p>Atsens AI Agents Traffic Analytics is a measurement plugin. It records how AI agents already interact with your WooCommerce store and tells you where you stand \u2014 it does not feed your catalog to chatbots, does not run a checkout, and does not talk to any external server.<\/p>\n\n<p><strong>What it measures<\/strong><\/p>\n\n<ul>\n<li><strong>AI bot crawls<\/strong> \u2014 recognizes known AI crawlers (GPTBot, OAI-SearchBot, ChatGPT-User, PerplexityBot, Perplexity-User, ClaudeBot, Claude-User, CCBot, Bytespider, Google-Extended, Amazonbot and others), classifies each visit as search\/citation, on-request fetch, or training crawl, and logs which pages and product categories they hit.<\/li>\n<li><strong>Chat-platform referrals<\/strong> \u2014 visits arriving from chatgpt.com, perplexity.ai, gemini.google.com, copilot.microsoft.com, claude.ai, grok.com, poe.com, you.com and deepseek.com are recorded (by referer or utm_source) and kept in a first-party cookie.<\/li>\n<li><strong>Order attribution<\/strong> \u2014 when a referred visitor places an order, the order is stamped with the chat source and visit date. Works with both classic post storage and HPOS (High-Performance Order Storage). The orders list shows an \"Agent source\" column.<\/li>\n<li><strong>30-day dashboard<\/strong> \u2014 a plain, JavaScript-free overview: top bots by category, top crawled URLs, referral counts per platform, and attributed orders.<\/li>\n<\/ul>\n\n<p><strong>What it audits<\/strong><\/p>\n\n<p>The <strong>Readiness<\/strong> page runs a self-audit of your store and scores it 0\u2013100: robots.txt rules for AI bots, Product JSON-LD schema and meta robots on a sample product, catalog hygiene (titles, short\/missing descriptions), shipping and returns policy pages, and llms.txt. Each check can produce a concrete fix item. The result is cached for 24 hours and can be re-run from the admin.<\/p>\n\n<p><strong>What it probes<\/strong><\/p>\n\n<p>The <strong>Niche Probe<\/strong> page (\"test yourself in ChatGPT\") generates a few shopper-style prompts from your own store data (top categories and best sellers) and sends them to the AI provider of your choice \u2014 using <em>your own<\/em> OpenAI or Perplexity API key. It reports whether the answer mentions your store or your products, and keeps the last 20 results so you can watch progress. The probe only runs when you click \"Run probe\".<\/p>\n\n<p><strong>Privacy: local by design<\/strong><\/p>\n\n<ul>\n<li>All data stays in your own WordPress database. There is no cloud, no account, no telemetry, no phone-home.<\/li>\n<li>No IP addresses are stored \u2014 not even hashed ones you could reverse; the anti-duplicate key is a salted hash of the IP with a per-install random salt, and the raw IP is never written.<\/li>\n<li>The only cookie is a first-party <code>atsen_ref<\/code> cookie (chat source + visit date, 30 days) \u2014 no personal identifiers.<\/li>\n<li>Tracking skips logged-in users, admin pages, AJAX, REST and prefetch requests.<\/li>\n<li>The Readiness audit fetches only your own site; the Probe talks only to the AI provider you configure with your own key.<\/li>\n<li>Uninstalling removes the tables, options, cookie data and cron event completely.<\/li>\n<\/ul>\n\n<p><strong>Requirements<\/strong><\/p>\n\n<p>Bot crawl and referral tracking work on any WordPress 6.0+ site. The Readiness audit and order attribution require WooCommerce (8.0+ recommended, HPOS supported). No JavaScript is added to your storefront; there are no external requests at page-view time.<\/p>\n\n<h3>External services<\/h3>\n\n<p>This plugin contacts two third-party AI services, and only when you explicitly ask it to. The optional \"Niche Probe\" feature (\"test yourself in ChatGPT\") sends a few shopper-style prompts to the AI provider you choose, using <em>your own<\/em> API key, and reports whether the answer mentions your store or products. Nothing is sent on page views, no visitor or customer data is involved, and the probe never runs by itself.<\/p>\n\n<ol>\n<li>OpenAI API \u2014 https:\/\/api.openai.com\/v1\/chat\/completions<\/li>\n<\/ol>\n\n<ul>\n<li>What it is used for: the \"Niche Probe\" admin page (provider \"OpenAI (ChatGPT)\") runs your generated shopper-style prompts through the OpenAI chat API and shows you the answers.<\/li>\n<li>What data is sent, and when: only the prompt text \u2014 generated locally from your own store data (top product categories and best-selling product names) \u2014 is sent, and only when you click the \"Run probe\" button. No customer, order, or visitor data is sent, and no IP addresses are shared.<\/li>\n<li>Under which conditions: the request happens only after you save your own OpenAI API key in the Probe settings and explicitly press \"Run probe\". The key is stored as an option on your own server and is sent only to OpenAI.<\/li>\n<li>Terms of use: https:\/\/openai.com\/policies\/terms-of-use<\/li>\n<li>Privacy policy: https:\/\/openai.com\/policies\/privacy-policy<\/li>\n<\/ul>\n\n<ol>\n<li>Perplexity API \u2014 https:\/\/api.perplexity.ai\/chat\/completions<\/li>\n<\/ol>\n\n<ul>\n<li>What it is used for: the same \"Niche Probe\" admin page (provider \"Perplexity\") runs your generated prompts through the Perplexity chat API instead, if you select Perplexity as the provider.<\/li>\n<li>What data is sent, and when: identical to OpenAI \u2014 only the locally generated prompt text, only on your explicit \"Run probe\" click. No customer, order, or visitor data.<\/li>\n<li>Under which conditions: only after you save your own Perplexity API key in the Probe settings and press \"Run probe\". The key is stored on your own server and sent only to Perplexity.<\/li>\n<li>Terms of use: https:\/\/www.perplexity.ai\/hub\/legal\/perplexity-api-terms-of-service<\/li>\n<li>Privacy policy: https:\/\/www.perplexity.ai\/hub\/legal\/privacy-policy<\/li>\n<\/ul>\n\n<p>Everything else in the plugin \u2014 bot crawl tracking, referral tracking, the Readiness audit, the dashboard \u2014 runs entirely on your own server and contacts no external service (the Readiness audit fetches only your own site's public pages).<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install from the WordPress admin: Plugins \u2192 Add New \u2192 search for \"Atsens AI Agents Traffic Analytics\", then Activate. Or upload the plugin folder to <code>\/wp-content\/plugins\/<\/code> and activate it on the Plugins page.<\/li>\n<li>Open the new <strong>AI Agent Traffic<\/strong> menu in wp-admin. The 30-day Dashboard starts recording immediately \u2014 data accumulates as bots and chat visitors arrive.<\/li>\n<li>Open <strong>Readiness<\/strong> and run the audit to get your 0\u2013100 agent-readiness score and fix list.<\/li>\n<li>(Optional) Open <strong>Probe<\/strong>, paste your own OpenAI or Perplexity API key, and run the \"test yourself in ChatGPT\" probe.<\/li>\n<li>(Optional) Open <strong>Settings<\/strong> to turn individual trackers on\/off or change the data-retention window (30\u2013365 days, default 180).<\/li>\n<li>Order attribution needs WooCommerce active. Check the \"Agent source\" column on the WooCommerce orders list after your first referred order.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"what%20data%20does%20this%20plugin%20store%2C%20and%20where%3F\"><h3>What data does this plugin store, and where?<\/h3><\/dt>\n<dd><p>Everything is stored locally in your own WordPress database \u2014 two custom tables (<code>{prefix}atsen_hits<\/code> for individual events, <code>{prefix}atsen_daily<\/code> for daily rollups) plus a handful of options. Nothing is sent anywhere: no external servers, no accounts, no telemetry. IP addresses are never stored; the anti-duplicate key is a salted one-way hash, and the raw IP is never written to the database or logs.<\/p><\/dd>\n<dt id=\"will%20it%20slow%20down%20my%20site%3F\"><h3>Will it slow down my site?<\/h3><\/dt>\n<dd><p>It is designed to be negligible: no JavaScript is added to the storefront, no external requests happen at page-view time, and a bot or referral hit costs a single indexed INSERT into a small table (plus a daily rollup via WP-Cron). Regular human visits are not logged at all. The Readiness audit runs on admin button presses and caches its result for 24 hours; the Probe only fires when you click \"Run probe\".<\/p><\/dd>\n<dt id=\"does%20this%20plugin%20make%20my%20store%20visible%20in%20chatgpt%3F\"><h3>Does this plugin make my store visible in ChatGPT?<\/h3><\/dt>\n<dd><p>No. Atsens AI Agents Traffic Analytics is a measurement tool only. It does not submit your catalog anywhere, does not create a feed, does not enable checkout inside chat apps, and cannot make ChatGPT (or any AI) mention your store. What it does is tell you how AI agents already interact with your site today, and the Readiness audit shows you what to fix (robots.txt, product schema, catalog hygiene, policies, llms.txt) if you <em>want<\/em> to become visible to them.<\/p><\/dd>\n<dt id=\"which%20woocommerce%20versions%20are%20supported%3F\"><h3>Which WooCommerce versions are supported?<\/h3><\/dt>\n<dd><p>WooCommerce 8.0+ is recommended. Order attribution uses the CRUD-level <code>woocommerce_new_order<\/code> hook and order meta APIs, so it works identically with classic post storage and HPOS (High-Performance Order Storage) \u2014 no direct postmeta writes anywhere.<\/p><\/dd>\n<dt id=\"is%20it%20gdpr%20%2F%20privacy%20friendly%3F\"><h3>Is it GDPR \/ privacy friendly?<\/h3><\/dt>\n<dd><p>Yes, by construction: data never leaves your server, no IP addresses or personal identifiers are stored, and the only cookie is a first-party <code>atsen_ref<\/code> cookie that contains just the chat-platform source and the visit date (30-day lifetime). Human visitors are not tracked; logged-in users, admin, AJAX and REST requests are skipped. You may still need to mention the cookie in your cookie policy depending on your jurisdiction.<\/p><\/dd>\n<dt id=\"will%20it%20work%20without%20woocommerce%3F\"><h3>Will it work without WooCommerce?<\/h3><\/dt>\n<dd><p>Partially. AI-bot crawl tracking and chat-referral tracking work on any WordPress 6.0+ site. The Readiness audit and the WooCommerce order attribution (including the \"Agent source\" orders column) require WooCommerce to be installed and active.<\/p><\/dd>\n<dt id=\"what%20exactly%20does%20the%20readiness%20audit%20check%3F\"><h3>What exactly does the Readiness audit check?<\/h3><\/dt>\n<dd><p>Seven things: robots.txt rules for the major AI bots, Product JSON-LD schema and the meta robots tag on a sample published product, catalog hygiene (titles and description length across your products, via SQL), your shipping and returns policy pages, and the presence of llms.txt. Checks are weighted into a 0\u2013100 score; the full result is cached for 24 hours and each incomplete check can produce a concrete fix item.<\/p><\/dd>\n<dt id=\"is%20the%20chatgpt%20probe%20free%3F%20do%20i%20need%20an%20api%20key%3F\"><h3>Is the ChatGPT probe free? Do I need an API key?<\/h3><\/dt>\n<dd><p>The probe uses your own API key (OpenAI or Perplexity), so its cost \u2014 if any \u2014 is billed by your provider under your account. The key is stored as a plain option on your own server, shown only masked in the admin, never logged, and sent only to the provider you selected. The probe runs only when you click the \"Run probe\" button; nothing happens on page loads.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>0.1.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<li>AI-bot crawl tracking with a versioned bot catalog (search\/citation, on-request fetch, training categories).<\/li>\n<li>Chat-platform referral tracking (ChatGPT, Perplexity, Gemini, Copilot, Claude, Grok, Poe, You, DeepSeek) with a first-party referral cookie.<\/li>\n<li>WooCommerce order attribution (classic storage and HPOS) with an \"Agent source\" orders column.<\/li>\n<li>30-day, JavaScript-free admin dashboard.<\/li>\n<li>Agent-readiness audit with a weighted 0\u2013100 score and a fix list.<\/li>\n<li>Niche Probe: run shopper-style prompts against your own OpenAI or Perplexity API key and track the last 20 results.<\/li>\n<li>Settings: per-tracker toggles and a 30\u2013365 day retention window; daily rollup cron with automatic trimming.<\/li>\n<\/ul>","raw_excerpt":"See which AI bots and chat platforms visit your WooCommerce store, which pages they crawl, and whether chat referrals end in orders, measured locally.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/372867","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=372867"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/lebedgor"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=372867"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=372867"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=372867"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=372867"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=372867"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=372867"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}