altis/analytics-demo-tools

dev-master 2026-03-19 00:25 UTC

GPL-2.0-or-later

• Human Made

README

This plugin provides tools for importing historical demo data and generating realistic demo analytics for Accelerate/Altis Analytics. It is designed for screenshots, demos, and personalization previews.

The plugin should be considered to be in Beta state and is not intended for use in production anywhere.

Installation & Usage

1. Install the plugin to wp-content/plugins or wherever your plugin directory is located.
2. Activate the plugin
3. In the admin area under "Tools" go to the "Analytics Demo" page
4. Use either the Historical Import tab or the Traffic Generator tab.

Historical Import

The importer can be run multiple times, new session IDs will be created each time and there is a 40% chance of a new endpoint ID being generated. This means when looking for recurring visitors vs new you should see roughly a 60/40 split.

Traffic Generator

The Traffic Generator creates targeted analytics data for specific blocks and posts/pages with smooth trends and realistic attributes. This is ideal for A/B tests, personalization demos, and polished screenshots.

Features:

• Block selection (A/B test, personalization, broadcast, and standard blocks)
• Post/page selection (generates pageView events for chosen posts and pages)
• Days of data (7–90)
• Traffic volume slider (up to 100k events per content item over 31 days)
• Traffic shape presets (Steady, Growth, Daily-swing, Weekly-swing)
• Realism presets (Balanced, US-heavy, Referral-heavy)
• Variant winner lift (optional, blocks only)
• Preview estimates for events, conversions, and runtime

Generated attributes include:

• country, region, city
• referrer + UTM source/medium/campaign
• device type + browser
• returning vs new visitor flag
• search terms + query strings
• top URLs (home + recent posts/pages)
• broadcast analytics (when broadcast blocks exist)

Autopilot (Demo Templates)

Autopilot keeps demo instances alive by continuously generating sitewide, block, and post/page analytics data. Enable it from Tools → Analytics Demo → Traffic Generator.

Highlights:

• Runs on a schedule (15/30/60 minutes)
• Generates data for selected blocks + posts/pages + sitewide events
• Real-time bursts when analytics screens are open
• Burst caps prevent unnatural spikes
• Maintains a realtime “tail” for 30‑minute charts

Delivery Performance

Events are sent to the Accelerate log endpoint in batches of up to 10 visitors per HTTP request. This is the maximum the endpoint accepts — larger payloads are silently dropped.

• Traffic Generator and Autopilot runs complete ~10x faster than versions prior to the batched delivery change.
• No artificial sleep delays between batches — the HTTP round-trip provides natural throttling.
• Historical Import uses a 100ms pause between batches instead of the previous 5-second delay.

Notes

• Demo data is synthetic and intended for non-production use only.
• Higher volumes and many blocks can take longer to process.
• On remote/cloud sites, events are sent via the Accelerate log endpoint (not direct ClickHouse writes). Credentials are read from the site's altis_config option.
• A/B test "Probability to Be Best" is calculated by a separate hourly cron (altis_post_ab_test_cron). It may take up to an hour to appear after generating data.
• Requires PHP 8.1+. All timestamp arithmetic uses explicit (int) casts to avoid deprecation warnings.