Profound Agent Analytics
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 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 The plugin captures essential HTTP request metadata (method, path, status, timing) Data is immediately queued in a local database table with minimal overhead A background process sends batched logs to Profound’s API endpoint Failures are automatically retried with exponential backoff 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. This requires Docker (or OrbStack) and Node.js. Running Compatibility Tests Start the environment: npx @wordpress/env start 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 Verify all classes instantiate and core functionality works: npx @wordpress/env run cli wp eval ‘new AgentAnalytics\Settings(); new AgentAnalytics\Queue(); echo “OK”;’ 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. 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
Search Analytics for WP
Search Analytics for WP will keep history of the search terms used by your users and group them in a set of statistics including the number of posts resulted from that search term. It can easily aid you in finding what your users are really searching for on your website and make sure you provide exactly what they need. Help and/or ideas are greatly appreciated! You can contribute to the GitHub repository: Search Analytics for WP NOTE: Search Analytics for WP stores all the statistics in your WordPress database. No info is sent to third-party services! Features Record all the search queries made using the standard WordPress search form. Exclude searches made by users with certain user roles or with certain IP addresses Exclude duplicate searches made in certain conditions Choose which user roles are allowed to see the statistics Filter statistics by time periods, with/without results, strings/substrings View each term individual statistics Export data in the current view to CSV Easily delete certain search terms from history Easily erase all history from the database in case a reset is needed Easily erase history older than in case a general cleanup is needed Dashboard widget for a quick glance over your last week’s search stats Multisite compatible Country Geolocation Display search statistics on the front of your website using shortcodes
