Skip to main content

​
Installation

1

Download the Plugin

Download the wordpress-plugin.zip file from the Siftly dashboard under Settings → Integrations → WordPress Plugin.Unzip the file — you’ll see a folder called wordpress-plugin containing the plugin files.
2

Upload to WordPress

  1. Log in to your WordPress admin panel.
  2. Go to Plugins → Add New → Upload Plugin.
  3. Click Choose File, select the wordpress-plugin.zip file, and click Install Now.
  4. After installation completes, click Activate Plugin.
3

Configure the Plugin

Go to Settings → Request Tracker in your WordPress admin panel.Fill in the two fields:
FieldValue
API Endpoint URLhttps://<your-traffic-ingest-service-url>/log/wordpress
Organisation IDYour Siftly Organisation ID (UUID from the dashboard)
Your Organisation ID is sent as a Bearer token in the Authorization header on every request.
Click Save Changes.
4

Test the Connection

Scroll down to the Test Event section and click Send Test Event.You’ll see an immediate response showing whether the service received the event. A green success banner confirms everything is working.

​
How It Works

The plugin:
  1. Captures every public page visit and checks the User-Agent against the AI bot list.
  2. Queues bot events in a lightweight local database table.
  3. Sends queued events to the traffic-ingest-service in batches every 5 minutes via WP-Cron.
This means the plugin never slows down your page loads — tracking happens entirely in the background.

​
Troubleshooting

The plugin automatically pauses sending after 5 consecutive failures to avoid hammering a temporarily unavailable endpoint. It resumes after 5 minutes.To reset immediately, go to Settings → Request Tracker and click Reset Circuit Breaker.
  1. Confirm the Organisation ID is correct (copy it directly from the Siftly dashboard).
  2. Confirm the API Endpoint URL ends with /log/wordpress (not the old backend URL).
  3. Check WP-Cron is running — some hosts disable WP-Cron. You may need to trigger it with a real cron job: 
    */5 * * * * curl https://yoursite.com/wp-cron.php?doing_wp_cron > /dev/null 2>&1
  4. Use Send Test Event to test the connection interactively.
Go to Settings → Request Tracker, clear the Organisation ID field, paste the correct UUID from the Siftly dashboard, and click Save Changes.