=== Siteline Agent Analytics ===
Contributors: sitelineai
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.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Track how AI agents like ChatGPT, Claude, Gemini, and Perplexity access your WordPress site with real-time insights to improve AI visibility.

== Description ==

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

This is the official Siteline plugin.

= Features =

* **Real-time monitoring**: Monitor real-time visits to your website by AI bots and agents from ChatGPT, Gemini, Perplexity, Claude, and more.
* **Server-side tracking**: Works even when bots do not execute JavaScript.
* **Identify technical blockers**: Identify where bots and agents are 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 Siteline account. No credit card required.
* **Simple setup**: Just create an account, generate a Website ID, and start tracking.
* **Lightweight and privacy-focused**: No frontend JavaScript and minimal performance impact. Non-blocking async tracking that respects user privacy.

= Why Track AI Agents? =

AI platforms are increasingly important traffic sources for organic growth. However, content ingestion by AI platforms differs significantly from traditional search engines:

* AI bots and agents regularly visit websites to collect, update, and verify information not only for training large language models, 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 traditional search crawlers. Most do not run JavaScript or maintain cookies or session state. If your site relies heavily on JavaScript or is not server-side rendered, your content may not be ingested correctly.

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

* Identify technical blockers, such as JavaScript-heavy pages limiting content ingestion.
* Discover what topics AI agents and user-initiated fetches access most frequently.
* Understand the full AI discovery journey, from bot content ingestion to human visits and conversions.

= How It Works =

1. Sign up for a free [Siteline](https://siteline.ai) 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 "Siteline 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 > Siteline in your WordPress admin
2. Check "Enable Tracking"
3. Enter your Website ID from [siteline.ai](https://siteline.ai)
4. Click "Save Changes"

If you have not authorized your website yet, follow the authorization guide:
https://docs.siteline.ai/authorization

== External Services ==

This plugin connects to the Siteline service to track AI agent and bot visits.

Service: Siteline
Service URL: https://siteline.ai
API endpoint: https://api.siteline.ai

Data transmitted:
• Page URL
• User agent
• Referrer URL
• IP address
• Website ID

Purpose:
This data is used to identify AI agents and analyze how they access your website.

Privacy policy:
https://siteline.ai/privacy

Terms of service:
https://siteline.ai/terms

== Frequently Asked Questions ==

= Do I need a Siteline account? =

Yes. You need a free Siteline account to generate a Website ID and view analytics.

= Does this affect my site's performance? =

No. The plugin uses non-blocking async requests that do not 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? =

The plugin is designed to track bot and agent activity. Site owners are responsible for ensuring compliance with applicable privacy laws.

= Does this work with caching plugins? =

Yes. The plugin is compatible with all major caching plugins.

= Can I use this with other analytics plugins? =

Yes. Siteline works alongside Google Analytics, Matomo, and other analytics tools.

== Support ==

Need help? Visit our documentation:
https://docs.siteline.ai/integrations/wordpress

Or contact:
team@siteline.ai