How to Configure the Events Queue System in PixelYourSite
The Queue System improves performance by sending events in batches instead of sending each event immediately. It’s useful for high-traffic stores, heavy setups (multiple tags), or sites where AJAX events slow down the page.
What changes when you enable it: events may be delivered with a small delay (based on the processing interval), but your pages can feel faster and your server does less work per request.
Queue System Status
Enable Queue System
Turns on queue processing. PixelYourSite stores events temporarily, then processes them in batches.
Use it when
- your site is busy (lots of traffic/events)
- you see slowdowns from tracking/AJAX
- you want more stable delivery under load
Use Queue for AJAX Events
If enabled, AJAX events (like AddToCart) are also queued instead of being sent right away.
Trade-off
- ✅ faster page responsiveness
- ⚠️ events can arrive slightly later
Processing Configuration
Max Events Per Batch
How many events PixelYourSite processes in one run (1–1000).
- Higher = fewer runs, potentially better performance, more memory used
- Lower = lighter runs, but more frequent processing
Good default: 50–200 for most sites.
Processing Interval
How often the queue is processed (example shown: 5 minutes).
- More frequent = faster delivery, more server work
- Less frequent = more delay, less server work
Good default: 1–5 minutes.
Queue Limits
Max Queue Size
Maximum number of events stored before new ones are dropped (range shown: 100–100000).
This protects your server during traffic spikes or if something gets stuck.
Good default: 10,000 (raise for very high traffic).
Max Retries
How many times failed events are retried before being marked permanently failed (0–10).
Good default: 3.
Auto Cleanup Settings
Pending Events Cleanup Days
Deletes “pending/stuck” events older than X days (0–30).
Set to 0 to disable.
Why it matters: prevents queue growth if processing stops for some reason.
Good default: 1 day.
Retention Days
How long to keep processed/failed events in the database (1–30). Older records are removed automatically.
Good default: 7 days (long enough for debugging, keeps DB small).
Drop Queue Table on Plugin Deactivation
Deletes the queue database table when the plugin is deactivated.
⚠️ Use with caution: it permanently removes all queued data.
Queue Statistics
A quick dashboard showing:
- Pending Events
- Processed Today
- Failed Events
- Total Events
Plus status indicators like last processed time, processing rate, and success rate.
Click Refresh to update the numbers.
Manual actions
Process Queue Now
Runs the queue immediately (useful for testing or if you changed settings).
Clear Old Records
Removes processed events older than the retention period.
Reset Failed Events
Marks failed events for retry (use after fixing the cause of failures).
Recommended setup (most sites)
- Enable Queue System: OPTIONAL
- Use Queue for AJAX Events: ON if you care about speed (or have heavy AJAX tracking)
- Max Events Per Batch: 50–200
- Processing Interval: 1–5 minutes
- Max Retries: 3
- Pending Cleanup: 1 day
- Retention: 7 days