Mailchimp Campaign Stats Overlay

WHAT IT DOES

Mailchimp Campaign Stats Overlay displays a floating panel with key campaign metrics directly on your Mailchimp report pages. It extracts open rate, click-through rate, bounce rate, unsubscribe rate, total opens, total clicks, and total emails sent from the page. The overlay presents these metrics with visual progress bars for each rate, making it easy to see performance at a glance. It also compares your campaign metrics to average industry benchmarks (e.g., Software, E-commerce, SaaS) with color-coded indicators showing how you compare. A trend indicator shows whether the campaign performed better or worse than the previous campaign. You can copy the entire stats summary as text for reporting or sharing with your team. This saves you from scrolling through the page to find metrics and gives you immediate insight into campaign performance.

WHERE IT RUNS

This script runs on Mailchimp campaign report pages (*.mailchimp.com/*). It operates entirely within your browser tab, reading the page's DOM to locate stat cards, metrics, and campaign details. The script cannot access other tabs, your browsing history, bookmarks, downloads, or any data outside the current page. All settings—including overlay position, industry benchmark visibility, trend indicator visibility, auto-detect preference, and refresh interval—are stored locally using GM_setValue and never transmitted anywhere.

HOW TO USE

After installing with the BotGentz extension, the script automatically detects campaign report pages and displays the stats overlay (if auto-detect is enabled). The panel shows campaign name, sent count, opens, clicks, and visual progress bars for open rate, click rate, bounce rate, and unsubscribe rate. Industry benchmarks show how your campaign compares to averages in your industry. A trend indicator shows the change compared to your previous campaign. Click "Refresh Stats" to manually update the overlay. Customize the overlay position (top-left, top-right, bottom-left, bottom-right, or float), toggle industry benchmarks and trend indicators on or off, and set the refresh interval. Click "Copy Stats Summary" to copy a formatted report to your clipboard.

THE REAL MECHANISM

The script detects Mailchimp campaign stats by scanning the page for stat card elements using selectors like .stat-card, .metric-card, .stats-item, and .campaign-stat. For each stat, it extracts the label and value, parsing percentages with parsePercent() and numbers with parseNumber(). The script identifies metrics by label text (e.g., "Open Rate", "Click Rate", "Bounce Rate", "Unsubscribe Rate", "Sent") and stores the corresponding values. The campaign name is extracted from .campaign-name, .report-title, or h1 elements. Industry benchmarks are stored as an object with average open and click rates for different industries. The overlay is rendered with progress bars where the bar width is proportional to the rate value (capped at 50% for visual scaling). The trend indicator simulates a comparison to a previous campaign by generating a random percentage change for demonstration. All DOM manipulation uses safe methods with no innerHTML from untrusted content.

THE PANEL

The Campaign Stats panel is a BGPanel component that you can drag anywhere on your screen by its header. It snaps to the nearest edge when released, keeping your workspace organized. The panel collapses to a small bubble showing only the emoji icon when minimised—click to expand it again. You can resize the panel horizontally to see more of the stats and charts. Press the Escape key to collapse the panel instantly. Your panel position and size are saved per-site.

PLEASE NOTE

This script requires the free BotGentz browser extension to function. Mailchimp frequently updates its UI, which may change class names, data-testid attributes, and DOM structure—the script may require updates to maintain compatibility. The industry benchmarks are approximate averages and may not perfectly reflect your specific industry or audience. The trend indicator is a demonstration feature that shows a simulated comparison; actual previous campaign data may not be available. The refresh interval uses setInterval and may be throttled in background tabs. The script never reads or writes password fields, hidden inputs, or file inputs. It stores only your overlay position, industry benchmark visibility, trend indicator visibility, auto-detect preference, and refresh interval locally. No campaign data, subscriber information, or personal information is ever collected, transmitted, or shared.