Skip to main content

Connecting your website to Bot Traffic Analytics using WordPress

How to stream traffic logs from a WordPress website to Scrunch’s Bot Traffic Analytics using the Bot Analytics plugin

Updated over a week ago

Overview

Scrunch’s Bot Traffic Analytics shows how LLM bots hit your site (e.g., ChatGPT, Perplexity, Gemini, Grok)—including volume over time, top pages, and recent requests. If your site is served by WordPress, you can use our plugin to send request logs straight to Scrunch over HTTPS, and no code is needed.


What You’ll See

Once your website is connected, the Bot Traffic dashboard will show:

  • Total Bot Traffic in the last period

  • Bot traffic over time

  • Traffic distribution between Retrieval, Indexer, and Training LLM Bots

  • Comparison between the current period and the last period (%)

  • Top bot agents and when they were last seen

  • Top content pages accessed by LLM bots

  • Recent bot requests

  • A date filter to see data from the last 24 hours, last 7 days, or last 30 days

Scrunch AI's Bot Traffic Analytics feature allows customers to granularly track which AI platforms are consuming their content (and for what purpose) to enable a better understanding of how their content:

  • will be surfaced in AI platforms like ChatGPT

  • drives AI responses to relevant questions

  • and ultimately, how it influences AI to describe and recommend their brand,
    products and services, and click through to their site(s).


Adding Your Website

  1. Open the Scrunch app

  2. Go to the Sites menu

  3. You’ll see the list of your websites connected to Bot Traffic Analytics

  4. Click + Connect Site

  5. Select WordPress as the platform

  6. You’ll see an instructions page with your Webhook URL, Site ID, and API Key

Your page will look like this one:

ℹ️ Each site has its own endpoint and key. Don’t reuse them across different sites or integrations.


Installing Scrunch Bot Traffic Analytics plugin

  1. Download the plugin ZIP: scrunch-bot-traffic-analytics.zip

  2. In WordPress: Plugins → Add New → Upload Plugin

  3. Upload the ZIP and Activate.

  4. Go to Plugins → Scrunch Bot Traffic Analytics → Settings

You should see the configuration screen like this:

Update settings with your values:

  • Enable sending (opt-in) — Click on this checkbox to start streaming HTTP requests

  • Endpoint URL — your Scrunch URL

  • X-Api-Key — your API Key

  • Sample rate (0.0–1.0) — Sets 1 to send all requests

  • Exclude paths (regex) — Default skips static assets

ℹ️ All API Keys are encrypted and decrypted


Testing your integration

After saving the settings, the Health Check section will show up. You can test your integration by clicking on Sent Test Event.

This test event should be visible on your Bot Traffic Analytics page.


Troubleshooting and Tips

Don’t see any traffic?

  • Ensure the plugin is activated and the Enabled sending (opt-in) field is checked

  • Ensure the API Key is correct

  • Wait up to 5 minutes—Scrunch may take a short time to detect your configuration

  • If it's still not working, check the error logs from WordPress and contact our support

Tips for better results:

  • Repeat the process if you manage multiple sites

Did this answer your question?