{"id":396268,"date":"2026-11-02T05:03:01","date_gmt":"2026-11-02T05:03:01","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/pingaura-telemetry\/"},"modified":"2026-11-02T05:02:45","modified_gmt":"2026-11-02T05:02:45","slug":"pingaura-telemetry","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/pingaura-telemetry\/","author":23596645,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.2.0","stable_tag":"1.2.0","tested":"7.1.4","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"PingAura Telemetry","header_author":"PingAura AI","header_description":"See the visits AI assistants send to your site and the AI crawlers that read it, in PingAura.","assets_banners_color":"ffffff","last_updated":"2026-11-02 05:02:45","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/www.pingaura.ai\/docs\/ai-traffic\/wordpress-setup","header_author_uri":"https:\/\/www.pingaura.ai","rating":0,"author_block_rating":0,"active_installs":0,"downloads":42,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.2.0":{"tag":"1.2.0","author":"pingauraai","date":"2026-11-02 05:02:45","revision":3778929}},"upgrade_notice":{"1.2.0":"<p>Adds optional contact-click tracking. Off until you save a browser key.<\/p>","1.1.0":"<p>Adds optional IndexNow submission. Off until you turn it on.<\/p>","1.0.1":"<p>No functional changes.<\/p>","1.0.0":"<p>First release.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3778929,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3778929,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3778929,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3778929,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.2.0"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[246479,256047,232,216196,233352],"plugin_category":[36],"plugin_contributors":[290148],"plugin_business_model":[],"class_list":["post-396268","plugin","type-plugin","status-publish","hentry","plugin_tags-ai-crawlers","plugin_tags-ai-traffic","plugin_tags-analytics","plugin_tags-chatgpt","plugin_tags-perplexity","plugin_category-analytics","plugin_contributors-pingauraai","plugin_committers-pingauraai"],"banners":{"banner":"https:\/\/ps.w.org\/pingaura-telemetry\/assets\/banner-772x250.png?rev=3778929","banner_2x":"https:\/\/ps.w.org\/pingaura-telemetry\/assets\/banner-1544x500.png?rev=3778929","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/pingaura-telemetry\/assets\/icon-128x128.png?rev=3778929","icon_2x":"https:\/\/ps.w.org\/pingaura-telemetry\/assets\/icon-256x256.png?rev=3778929","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>PingAura Telemetry connects a WordPress site to <a href=\"https:\/\/www.pingaura.ai\">PingAura<\/a>, which shows how AI assistants find, read and recommend your content.<\/p>\n\n<p>With the plugin active, the AI Traffic section of PingAura shows:<\/p>\n\n<ul>\n<li>Visits referred by AI assistants such as ChatGPT, Perplexity and Gemini, by page.<\/li>\n<li>Requests from AI crawlers such as GPTBot, ClaudeBot and PerplexityBot (optional).<\/li>\n<\/ul>\n\n<p>It can also tell Bing and other IndexNow search engines about new and updated pages as soon as they are published (optional). Bing powers the web results in ChatGPT search and Copilot, so this helps new pages reach AI answers sooner.\n* Human visits, countries and top pages alongside them.<\/p>\n\n<h4>How it works<\/h4>\n\n<ul>\n<li>A short script runs after each page has loaded and reports the page, its referrer and its title to your own site. It works on cached pages and is skipped for automated browsers.<\/li>\n<li>Your site adds the visitor's IP address and user agent and forwards the visit to PingAura after its response has been sent. Your ingest key stays on the server and is never sent to the browser.<\/li>\n<li>AI crawlers do not run scripts, so they are recorded on the server when the request reaches WordPress.<\/li>\n<li>Query strings are removed from page addresses, except utm_ campaign tags, and from referrers. Fragments are always removed.<\/li>\n<li>Logged-in users are not tracked in Live mode.<\/li>\n<li>The plugin sets no cookies for visitors. Without a browser key it stores nothing in their browser.<\/li>\n<li>If PingAura cannot be reached, sending pauses for two minutes, so an outage never slows your site.<\/li>\n<\/ul>\n\n<h4>Contact clicks (optional)<\/h4>\n\n<p>Add a browser key to also record clicks on phone, email and WhatsApp links, including the Joinchat button, by page and by the AI assistant or other source that brought the visitor. A click shows interest; it is not a confirmed lead.<\/p>\n\n<p>Create the key in PingAura under Settings, API &amp; MCP, Create key, Browser, and paste it into the Browser key field. The key is public and safe to show in your page's HTML. The plugin then loads PingAura's browser script on your pages, following the same Off, Test and Live modes as visits. It asks LiteSpeed Cache and WP Rocket not to delay the script, so the first tap is counted.<\/p>\n\n<h4>Test mode<\/h4>\n\n<p>New installs start in Test mode: nothing is sent for real visitors until you switch to Live. In Test mode you can turn on test visits for your own browser and send sample events from the settings page to check the connection.<\/p>\n\n<h4>Requirements<\/h4>\n\n<ul>\n<li>A PingAura account with the domain added and PingAura Telemetry enabled.<\/li>\n<li>An ingest key, created in PingAura under Settings \u2192 API keys.<\/li>\n<\/ul>\n\n<h3>External services<\/h3>\n\n<p>This plugin sends data to PingAura, an AI visibility and analytics service operated by PingAura AI. It is needed to show your AI referral and crawler traffic in PingAura.<\/p>\n\n<p>Nothing is sent until you save an ingest key or a browser key and choose Test or Live mode. From then on:<\/p>\n\n<ul>\n<li>In Live mode, for each page view by a visitor who is not logged in: the page URL without query parameters other than utm_ tags, its title, the referring URL without its query string, the visitor's IP address and user agent, and the plugin's name and version. The IP address is used to determine the country and to recognise verified crawlers.<\/li>\n<li>If AI crawler reporting is on, for each request from a known AI crawler: the requested URL, the response status, and the crawler's IP address and user agent.<\/li>\n<li>In Test mode, the same data, but only for browsers where test visits are turned on, and for test events you send from the settings page.<\/li>\n<\/ul>\n\n<p>Data is sent to <code>https:\/\/telemetry.pingaura.ai\/v1\/events<\/code> with your ingest key.<\/p>\n\n<p><strong>Contact clicks (optional, off until you save a browser key).<\/strong> The visitor's browser loads a script from <code>https:\/\/telemetry.pingaura.ai\/t.js<\/code>. When the visitor clicks a phone, email or WhatsApp link, the browser sends to <code>https:\/\/telemetry.pingaura.ai\/v1\/browser<\/code>: that a click happened and its type (phone, email or WhatsApp), the page URL without its query string, the site or AI assistant that brought the visitor (the referring site's address and the utm_source tag), and your browser key and domain. The phone number, email address and message are not sent. As with any web request, PingAura's server also receives the visitor's IP address and user agent. The script sets no cookies; it stores the landing source in the visitor's browser (local storage) for 30 minutes so a click on a later page is credited to it. The same modes apply: nothing in Off mode, only browsers with test visits turned on in Test mode, and visitors who are not logged in in Live mode.<\/p>\n\n<p><strong>IndexNow (optional, off by default).<\/strong> When you turn on IndexNow, the plugin sends the addresses of published pages, your site's host name and an IndexNow key to <code>https:\/\/api.indexnow.org\/indexnow<\/code>, which shares them with participating search engines such as Bing, Yandex, Naver and Seznam. This happens when a page is published or updated, and when you click \"Submit all published pages\". No visitor data is sent. The key is generated by the plugin and served at <code>\/{key}.txt<\/code> on your site so search engines can verify it. IndexNow terms: https:\/\/www.indexnow.org\/terms<\/p>\n\n<p>You are responsible for having a lawful basis, or your visitors' consent where it is required, to send this data. The plugin adds suggested text to Settings \u2192 Privacy, and the <code>pingaura_telemetry_should_track<\/code> filter lets a consent tool turn tracking off for a visitor.<\/p>\n\n<ul>\n<li>Terms of service: https:\/\/www.pingaura.ai\/terms-of-service<\/li>\n<li>Privacy policy: https:\/\/www.pingaura.ai\/privacy-policy<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate the plugin.<\/li>\n<li>In PingAura, create an ingest key under Settings \u2192 API keys.<\/li>\n<li>In WordPress, open Settings \u2192 PingAura Telemetry, paste the key and save. Check that Domain matches the domain registered in PingAura.<\/li>\n<li>Click \"Send a ChatGPT visit\". A reply starting with 202 means the connection works.<\/li>\n<li>Switch Mode to Live and save.<\/li>\n<\/ol>\n\n<p>The full guide is at https:\/\/www.pingaura.ai\/docs\/ai-traffic\/wordpress-setup.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20it%20slow%20my%20site%20down%3F\"><h3>Does it slow my site down?<\/h3><\/dt>\n<dd><p>It does not delay page rendering. The script is a few hundred bytes, runs after the page has loaded, and sends one small background request to your own site, which answers straight away and forwards the visit afterwards. Each tracked visit is one extra, uncached request to WordPress, similar to other self-hosted analytics plugins.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20page%20caching%20plugins%3F\"><h3>Does it work with page caching plugins?<\/h3><\/dt>\n<dd><p>Yes. Visits are recorded by the script, so cached pages are counted. Saving the settings clears LiteSpeed Cache, WP Rocket and WP Super Cache so the script appears straight away. Other caches may need clearing by hand.<\/p><\/dd>\n<dt id=\"why%20are%20ai%20crawler%20requests%20not%20showing%20up%3F\"><h3>Why are AI crawler requests not showing up?<\/h3><\/dt>\n<dd><p>A page cache usually answers crawler requests before WordPress runs. Add the crawler user agents (GPTBot, ClaudeBot, PerplexityBot and others) to your cache plugin's list of user agents that are never cached, and turn on AI crawler reporting.<\/p><\/dd>\n<dt id=\"can%20i%20keep%20the%20ingest%20key%20out%20of%20the%20database%3F\"><h3>Can I keep the ingest key out of the database?<\/h3><\/dt>\n<dd><p>Yes. Add <code>define( 'PINGAURA_TELEMETRY_KEY', 'pa_...' );<\/code> to wp-config.php. It takes precedence over the key saved on the settings page.<\/p><\/dd>\n<dt id=\"my%20site%20is%20behind%20cloudflare.%20are%20countries%20correct%3F\"><h3>My site is behind Cloudflare. Are countries correct?<\/h3><\/dt>\n<dd><p>Behind a CDN, WordPress sees the CDN's address unless your server restores the visitor's. If countries look wrong, read the CDN's header with the <code>pingaura_telemetry_client_ip<\/code> filter. See the plugin's README for an example.<\/p><\/dd>\n<dt id=\"can%20visit%20data%20be%20faked%3F\"><h3>Can visit data be faked?<\/h3><\/dt>\n<dd><p>Like any analytics that relies on the visitor's browser, anyone can send fake visits to your site. PingAura limits how many events a workspace can send, and the plugin ignores requests from other sites and malformed data.<\/p><\/dd>\n<dt id=\"what%20does%20indexnow%20do%3F\"><h3>What does IndexNow do?<\/h3><\/dt>\n<dd><p>IndexNow is an open protocol for telling search engines a page has changed. With it turned on, Bing and other participating search engines hear about a new or updated page within seconds instead of waiting to recrawl. Click \"Submit all published pages\" once after turning it on to send your existing pages. It works without a PingAura account. Google does not support IndexNow; for Google, submit your sitemap in Search Console.<\/p>\n\n<p>Right after you turn it on, the first submission can be refused with 403 while the search engine verifies the key file. Wait a few minutes and click the button again.<\/p><\/dd>\n<dt id=\"what%20does%20contact-click%20tracking%20record%3F\"><h3>What does contact-click tracking record?<\/h3><\/dt>\n<dd><p>Only that a click on a phone, email or WhatsApp link happened, on which page, and which AI assistant or other source brought the visitor. It does not record the phone number, email address or message. It sets no cookies. It stores the landing source in the visitor's browser for 30 minutes, so a click a few pages later is still credited to the AI assistant that sent the visitor.<\/p><\/dd>\n<dt id=\"does%20it%20set%20cookies%3F\"><h3>Does it set cookies?<\/h3><\/dt>\n<dd><p>Not for visitors. An administrator who turns on test visits gets a cookie in their own browser for 24 hours.<\/p><\/dd>\n<dt id=\"what%20does%20the%20reply%20on%20the%20settings%20page%20mean%3F\"><h3>What does the reply on the settings page mean?<\/h3><\/dt>\n<dd><p>202 means PingAura accepted the event. 401 means the key is wrong or revoked. 403 means the domain is not registered on the key's account, or PingAura Telemetry is not enabled for it.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.2.0<\/h4>\n\n<ul>\n<li>Optional contact-click tracking with a PingAura browser key.<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Add optional IndexNow submission for new and updated pages, with a one-click submission of all published pages.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Tested up to WordPress 7.1.<\/li>\n<li>Pass the WordPress.org Plugin Check.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>First release.<\/li>\n<\/ul>","raw_excerpt":"See the visits ChatGPT, Perplexity, Gemini and other AI assistants send to your site, and the AI crawlers that read it, in PingAura.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/396268","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=396268"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/pingauraai"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=396268"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=396268"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=396268"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=396268"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=396268"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=396268"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}