Title: Profound Agent Analytics Author: Profound Published: ഡിസംബർ 2, 2025 Last modified: മാർച്ച്‌ 31, 2026 --- Search plugins ![](https://ps.w.org/profound-agent-analytics/assets/banner-772x250.png?rev=3408504) ![](https://ps.w.org/profound-agent-analytics/assets/icon-256x256.png?rev=3408410) # Profound Agent Analytics By [Profound](https://profiles.wordpress.org/enarm4/) [Download](https://downloads.wordpress.org/plugin/profound-agent-analytics.1.0.4.zip) * [Details](https://ml.wordpress.org/plugins/profound-agent-analytics/#description) * [Reviews](https://ml.wordpress.org/plugins/profound-agent-analytics/#reviews) * [Installation](https://ml.wordpress.org/plugins/profound-agent-analytics/#installation) * [Development](https://ml.wordpress.org/plugins/profound-agent-analytics/#developers) [Support](https://wordpress.org/support/plugin/profound-agent-analytics/) ## Description Profound Agent Analytics is a powerful WordPress plugin that integrates with Profound’s edge log analysis service to identify, classify, and provide reporting on bot and human traffic to your website. The plugin works by efficiently collecting and sending request data from public pages to Profound’s analytics platform. Read more [here](https://docs.tryprofound.com/agent-analytics/wordpress/introduction) #### Key Features * **Non-blocking Performance**: Uses an asynchronous queue system to ensure zero impact on page load times * **Privacy-Focused**: Query parameter redaction to protect sensitive data * **Smart Batching**: Efficiently sends logs in batches to minimize network overhead * **Circuit Breaker**: Automatic protection against API failures to prevent cascading issues * **Flexible Configuration**: Extensive settings for customizing what data is collected and sent * **Enterprise Ready**: Supports environment variables and constants for API key configuration #### How It Works 1. The plugin captures essential HTTP request metadata (method, path, status, timing) 2. Data is immediately queued in a local database table with minimal overhead 3. A background process sends batched logs to Profound’s API endpoint 4. Failures are automatically retried with exponential backoff 5. Your Profound dashboard provides real-time insights into your traffic #### Privacy & Security Profound Agent Analytics is designed with privacy and security at its core: * **Complete IP Tracking**: Captures full IP addresses for accurate traffic analysis and reverse DNS lookups (required for bot detection) * **Sensitive Data Protection**: Automatically redacts passwords, tokens, and credit card information from query parameters * **Public Traffic Only**: Excludes all WordPress admin, REST API, and system paths– only tracks public visitor traffic * **Encrypted Storage**: API keys are encrypted using WordPress salts when Sodium extension is available * **No Cookie Tracking**: Server-side only – does not use cookies or client-side tracking #### Performance Optimized * Adds less than 1ms to request processing time * Efficient database operations with proper indexing * Automatic cleanup of old log entries * Memory-aware batching to prevent large payloads * Configurable queue size limits ### Privacy Policy This plugin sends data to Profound’s analytics service (https://artemis.api.tryprofound. com). The data sent includes: – Full IP addresses (required for bot detection and traffic analysis) – Request URLs from public pages only (admin and system paths are excluded) – HTTP headers (user agent, referer) – Response metadata (status code, size, duration) – Query parameters (with sensitive values redacted) The plugin only tracks public visitor traffic. WordPress admin activity, user actions, and system operations are not collected. All data is processed in accordance with Profound’s privacy policy available at https://tryprofound.com/privacy-policy ### System Requirements * WordPress 6.0 or higher * PHP 7.4 or higher * MySQL 5.7+ or MariaDB 10.2+ * Ability to make outbound HTTPS requests * WP-Cron enabled (or real cron configured) * Sodium PHP extension (recommended for encryption) ### Development & Testing This plugin includes a `.wp-env.json` configuration for local testing using [wp-env](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-env/). This requires Docker (or OrbStack) and Node.js. #### Running Compatibility Tests 1. Start the environment: npx @wordpress/env start 2. Verify the plugin activates without errors: npx @wordpress/env run cli wp plugin deactivate agent-analytics-wp-plugin npx @wordpress/env run cli wp plugin activate agent-analytics-wp-plugin 3. Verify all classes instantiate and core functionality works: npx @wordpress/env run cli wp eval ‘new AgentAnalytics\Settings(); new AgentAnalytics\Queue(); echo“ OK”;’ 4. Check for PHP errors, warnings, or deprecation notices (WP_DEBUG is enabled): npx @wordpress/env run cli cat /var/www/html/wp-content/debug.log If the file does not exist, there are no errors. 5. Stop the environment: npx @wordpress/env stop To test against a different WordPress version, edit the `core` value in `.wp-env. json` (e.g. `"WordPress/WordPress#7.0"`) and restart. #### Deploying to WordPress.org See `DEPLOY.md` for instructions on publishing releases and updating the “Tested up to” value via SVN. ### Support For support, please contact support@tryprofound.com ## Installation See a complete guide with screenshots [here](https://docs.tryprofound.com/agent-analytics/wordpress/installation) 1. Upload the `profound-agent-analytics` folder to the `/wp-content/plugins/` directory 2. Activate the plugin through the ‘Plugins’ menu in WordPress 3. Go to Settings Profound Agent Analytics to configure the plugin 4. Enter your Profound API key (obtain from your Profound dashboard) 5. Enable logging and configure privacy settings as needed 6. Click “Send Test Event” to verify connectivity #### Configuration Options **Via WordPress Admin:** – Navigate to Settings Profound Agent Analytics – Configure your API key and endpoint – Adjust privacy settings and path filters **Via Environment Variables (Recommended for production):** Add to your `wp-config. php`: ``` define('AGENT_ANALYTICS_API_KEY', 'your-api-key-here'); define('WP_ENV_AGENT_ANALYTICS_API_KEY', 'your-api-key-here'); // Alternative ``` ## FAQ ### Will this plugin slow down my website? No. Profound Agent Analytics is designed with performance as a top priority. It adds less than 1 millisecond to request processing and uses an asynchronous queue system to ensure that log sending never blocks page delivery. ### What data is collected? The plugin collects standard HTTP request metadata from public pages only: request method, URL path, status code, full IP address, user agent, query parameters (with sensitive data redacted), referrer, response size, and request duration. No page content or WordPress user data is collected. ### How is my API key protected? API keys are encrypted using WordPress salts when the Sodium extension is available. For maximum security, we recommend using environment variables or constants in wp- config.php instead of database storage. ### Can I exclude certain pages or areas? Yes. The plugin automatically excludes: – All WordPress admin areas and admin-initiated requests – WordPress REST API calls (/wp/v2/*) – Login pages, cron jobs, and AJAX requests – Any request with a wp-admin referer – Custom path patterns you define ### What happens if the Profound API is unavailable? The plugin includes a circuit breaker that automatically pauses sending after consecutive failures. Logs are queued locally and will be sent once connectivity is restored. Your website will continue to function normally. ### How do I troubleshoot connection issues? 1. Check the Status tab for error messages 2. Verify your API key is correct 3. Use the “Send Test Event” button to test connectivity 4. Ensure your server can make outbound HTTPS requests 5. Check that WordPress cron is running properly ### Is this plugin GDPR compliant? The plugin is designed for analytics while respecting user privacy: – No cookies or client-side tracking – Automatic redaction of sensitive query parameters (passwords, tokens, credit cards) – Full IP addresses are collected (required for accurate bot detection and geographic analytics) – Only public page traffic is tracked – no admin or user activity – Data is processed according to Profound’s privacy policy ## Reviews ഈ പ്ലഗിന് റിവ്യൂകൾ ഒന്നുമില്ല. ## Contributors & Developers “Profound Agent Analytics” is open source software. The following people have contributed to this plugin. Contributors * [ Profound ](https://profiles.wordpress.org/enarm4/) [Translate “Profound Agent Analytics” into your language.](https://translate.wordpress.org/projects/wp-plugins/profound-agent-analytics) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/profound-agent-analytics/), check out the [SVN repository](https://plugins.svn.wordpress.org/profound-agent-analytics/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/profound-agent-analytics/) by [RSS](https://plugins.trac.wordpress.org/log/profound-agent-analytics/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.4 * Verified compatibility with WordPress 6.9 #### 1.0.3 * Fixes default selections in privacy settings #### 1.0.2 * Public release #### 1.0.1 * Initial release * Core logging functionality * Queue-based architecture * Circuit breaker implementation * Privacy controls (query parameter redaction, path filtering) * Admin interface with status monitoring * Test event functionality * Automatic retry with exponential backoff * WordPress 6.0+ compatibility * PHP 7.4+ support ## Meta * Version **1.0.4** * Last updated **4 ദിവസങ്ങൾ ago** * Active installations **100+** * WordPress version ** 6.0 അല്ലെങ്കില്‍ അതിലും ഉയര്‍ന്നത് ** * Tested up to **6.9.4** * PHP version ** 7.4 അല്ലെങ്കില്‍ അതിലും ഉയര്‍ന്നത് ** * Language * [English (US)](https://wordpress.org/plugins/profound-agent-analytics/) * Tags * [analytics](https://ml.wordpress.org/plugins/tags/analytics/)[bot detection](https://ml.wordpress.org/plugins/tags/bot-detection/) [performance](https://ml.wordpress.org/plugins/tags/performance/)[security](https://ml.wordpress.org/plugins/tags/security/) [traffic analysis](https://ml.wordpress.org/plugins/tags/traffic-analysis/) * [Advanced View](https://ml.wordpress.org/plugins/profound-agent-analytics/advanced/) ## Ratings No reviews have been submitted yet. [എന്റെ അവലോകനം ചേർക്കുക](https://wordpress.org/support/plugin/profound-agent-analytics/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/profound-agent-analytics/reviews/) ## Contributors * [ Profound ](https://profiles.wordpress.org/enarm4/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/profound-agent-analytics/)