=== GPTrends Agent Analytics ===
Contributors: gptrends
Tags: analytics, bot tracking, SEO, GEO, AI agents
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.0
Stable tag: 1.0.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Track AI bot visits to your WordPress site. Monitor how ChatGPT, Claude, and Perplexity crawl your content.

== Description ==

[Agent Analytics](https://gptrends.io) from GPTrends helps you understand how AI agents and bots crawl, ingest, and interact your website content in real-time. Turn AI visibility optimization from a black box into data-driven action.

= Features =

* **Real-time monitoring**: Monitor real-time visits to your website by AI bots & agents from ChatGPT, Gemini, Perplexity, Claude and more.
* **Identify tech blockers**: Identify where bots and agents getting stuck when trying to learn about your brand and products.
* **Find trending topics**: Optimize your content strategy based on what AI agents and real ChatGPT users are looking for.
* **No plan required**: All you need is a free GPTrends account, no credit card required.
* **Simple set up**: Just create an account, generate a Website ID and start tracking.
* **Lightweight & privacy-focused**: No impact on your site's performance. Non-blocking, async tracking that respects user privacy.
* **No frontend code**: Zero JavaScript loaded on your site.

= Why Track AI Agents? =

AI platforms are increasingly important traffic sources for organic growth, however content ingestion by AI platforms differs signficantly from Google search:

* AI bots & agents regularly visit websites to collect, update, and verify information **not only for the training of LLMs, but also to power real-time AI search and live answers.**
* This crawling behavior determines **which content is available and ingested into AI chat assistants and how your brand and products are represented** in AI-generated responses.
* Importantly, **AI bots behave differently than the Google web crawler.** Most do not run JavaScript or maintain cookies or session state. If your site is JS heavy or not server-side rendered then there's a risk that your content is not being ingested correctly.


Understanding which AI agents, bots & crawlers visit your site helps you:

* **Identify technical blockers** e.g. Javascript heavy pages limiting the ingestion of your content into AI models and apps.
* **Discover what topics real ChatGPT users are prompting** for in real time via "User Initiated" agents.
* **Understand the whole AI discovery journey:** from bot content ingestion to human visits and conversions.

= How It Works =

1. Sign up for a free [GPTrends](https://gptrends.io) account
2. Generate a unique Website ID
3. Enter the Website ID in the plugin settings
4. Enable tracking and you're done!

== Installation ==

= Automatic Installation =

1. Log in to your WordPress admin panel
2. Go to Plugins > Add New
3. Search for "GPTrends Agent Analytics"
4. Click "Install Now" and then "Activate"

= Manual Installation =

1. Download the plugin ZIP file
2. Log in to your WordPress admin panel
3. Go to Plugins > Add New > Upload Plugin
4. Choose the ZIP file and click "Install Now"
5. Activate the plugin

= Configuration =

1. Go to Settings > GPTrends in your WordPress admin
2. Check "Enable Tracking"
3. Enter your Website ID from [gptrends.io](https://gptrends.io)
4. Click "Save Changes"

== External Services ==

This plugin sends pageview data to the GPTrends API to track AI agent and bot visits to your website.

**Service:** GPTrends API (https://api.gptrends.io)

**Data sent:** Page URL, user agent, referrer, IP address, and your Website ID

**When:** On each pageview when tracking is enabled (excludes admin pages and static files)

**Privacy Policy:** https://gptrends.io/privacy

**Terms of Service:** https://gptrends.io/terms

== Frequently Asked Questions ==

= Do I need a GPTrends account? =

Yes, you need a free account with GPTrends to generate a Website ID and view analytics.

= Does this affect my site's performance? =

No. The plugin uses non-blocking async requests that don't impact page load times.

= What AI platforms do you track? =

We track all major AI platforms including ChatGPT, Gemini, Perplexity, Claude, Google AI Mode / AI Overviews and many others.

= Is this GDPR compliant? =

Yes. The plugin tracks bot behavior, not personal user data. It's designed with privacy in mind.

= Does this work with caching plugins? =

Yes, the plugin is compatible with all major caching plugins.

= Can I use this with other analytics plugins? =

Absolutely! GPTrends works alongside Google Analytics, Matomo, and other analytics tools.

== Support ==

Need help? Visit our [documentation](https://docs.gptrends.io/agent-analytics) or reach out to team@gptrends.io.
