Skip to main content
The wordpress plugin is currently in closed beta. Please check back later for updates.

​
Overview

The Agent Analytics WordPress plugin enables automatic log collection from your WordPress site, forwarding visitor traffic data to the Profound Agent Analytics platform. The plugin operates transparently in the background, capturing only public traffic while excluding all administrative and system activity.

​
Prerequisites

Before beginning the installation, ensure you have:
  • A WordPress site running version 6.0 or higher
  • Administrative access to your WordPress dashboard
  • A Profound account with API credentials
  • PHP 7.4 or higher on your hosting environment

​
Installation

Wordpress Detected
1

Step 1

Download the latest agent-analytics.zip file from [PLACEHOLDER].
Keep the file as a ZIP archive - do not extract it. WordPress will handle the extraction automatically.
2

Step 2

Log into your WordPress admin dashboard and navigate to Plugins in the left sidebar. Click Add New at the top of the Plugins page, then click Upload Plugin. Choose the agent-analytics.zip file you downloaded and click Install Now.WordPress Plugins Navigation
3

Step 3

After installation completes, confirm the plugin was uploaded successfully, then Activate Plugin on the success page.Alternatively, navigate to Plugins → Installed Plugins, find “Agent Analytics” in the list, and click Activate.Activate Plugin
4

Step 4

Once activated, navigate to Settings → Agent Analytics in your WordPress admin menu.
5

Step 5

In the General settings tab:
  1. Check the Enable Logging checkbox to activate log collection
  2. Enter your Profound API key (starts with bot_) in the API Key field
  3. Leave the API Endpoint at its default value unless instructed otherwise
  4. Optionally adjust the Batch Size and Send Interval settings. API Configuration
Your API key is sensitive information. For production sites, consider using environment variables instead of database storage. See the security documentation for details.
6

Step 6 (Optional)

Navigate to the Privacy tab to adjust filtering options:
  • Query Parameter Redaction: Add any additional sensitive parameters to redact (default includes passwords, tokens, cards)
  • Path Filtering: Add custom paths to exclude from logging
  • Skip Options: Toggle exclusion of admin, cron, AJAX, or REST API requests Privacy Settings
The plugin automatically excludes all WordPress admin activity and system paths. These settings allow additional customization beyond the defaults.
7

Step 7

Click Save Changes at the bottom of the settings page.Navigate to the Status tab to verify your configuration:
  1. Check that the Queue Status shows as “Active”
  2. Click Send Test Event to verify connectivity
  3. Confirm you see “Test event sent successfully” Status Verification
If the test fails, double-check your API key and ensure your server can make outbound HTTPS requests to artemis.api.tryprofound.com.
8

Step 8

After configuration:
  1. Visit a few pages on your public website (not logged into WordPress admin)
  2. Return to Settings → Agent Analytics → Status
  3. Check that the Next automatic send shows a time within the next minute
  4. Verify the Queue size increases as you browse, then decreases after automatic sending
That’s it! You have successfully configured Agent Analytics for your WordPress site. Data should begin appearing in your Profound dashboard within minutes.

​
Post-Installation Verification

To confirm everything is working correctly:
  1. Check the Status Tab: The queue should periodically drain (every 60 seconds by default)
  2. Monitor Your Dashboard: Log into your Profound account and verify data is appearing
  3. Review Processing Schedule: Ensure “Next automatic send” updates regularly

​
Troubleshooting

​
Logs Not Sending

  • Verify your API key is correct and starts with bot_
  • Check that Enable Logging is checked in General settings
  • Ensure WordPress Cron is running (visit your site frontend to trigger it)
  • Look for any error messages in the Status tab

​
Test Event Fails

  • Confirm your server allows outbound HTTPS connections
  • Check if a firewall is blocking connections to artemis.api.tryprofound.com
  • Verify your API key has no extra spaces or characters

​
Queue Growing But Not Sending

  • The automatic sending requires site visits to trigger WordPress Cron
  • Consider setting up a real cron job for consistent processing
  • Click Re-schedule Automatic Sending if the schedule appears missing

​
Wrong IP Addresses

  • The plugin automatically detects proxy headers from CDNs and managed hosts
  • If IPs appear incorrect, your host may use non-standard headers
  • Contact support for assistance with custom IP detection

​
Additional Resources