About this plugin
PingAura Telemetry connects a WordPress site to PingAura, which shows how AI assistants find, read and recommend your content.
With the plugin active, the AI Traffic section of PingAura shows:
- Visits referred by AI assistants such as ChatGPT, Perplexity and Gemini, by page.
- Requests from AI crawlers such as GPTBot, ClaudeBot and PerplexityBot (optional).
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.
* Human visits, countries and top pages alongside them.
How it works
- 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.
- 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.
- AI crawlers do not run scripts, so they are recorded on the server when the request reaches WordPress.
- Query strings are removed from page addresses, except utm_ campaign tags, and from referrers. Fragments are always removed.
- Logged-in users are not tracked in Live mode.
- The plugin sets no cookies for visitors. Without a browser key it stores nothing in their browser.
- If PingAura cannot be reached, sending pauses for two minutes, so an outage never slows your site.
Contact clicks (optional)
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.
Create the key in PingAura under Settings, API & 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.
Test mode
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.
Requirements
- A PingAura account with the domain added and PingAura Telemetry enabled.
- An ingest key, created in PingAura under Settings → API keys.
External services
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.
Nothing is sent until you save an ingest key or a browser key and choose Test or Live mode. From then on:
- 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.
- 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.
- 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.
ai/v1/events with your ingest key.
Contact clicks (optional, off until you save a browser key). js. ai/v1/browser: 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.
IndexNow (optional, off by default). org/indexnow, 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. txt on your site so search engines can verify it. org/terms
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 → Privacy, and the pingaura_telemetry_should_track filter lets a consent tool turn tracking off for a visitor.
- Terms of service: https://www.pingaura.ai/terms-of-service
- Privacy policy: https://www.pingaura.ai/privacy-policy