Simple Analytics Importer — Import your Simple Analytics history

Pro Plan

If you're migrating from Simple Analytics to Zenovay, the Simple Analytics Importer brings your historical daily aggregates into Zenovay so you keep full context on the day you switch. You have three import paths depending on your Simple Analytics plan and privacy settings:

Public domain stats — no credentials needed; works if your Simple Analytics dashboard is set to public.
CSV export — download from Simple Analytics and upload to Zenovay.
API key — pull data directly if your site is on a paid Simple Analytics plan.

What it imports

Daily pageviews and unique visitors (full export date range, per day)
Top pages, top referrers, top countries (totals for the imported window — Simple Analytics returns these as window aggregates, not per-day, so the same breakdown is applied across the imported days)
Browser and device type breakdowns (if available in your export, also as window totals)

What it doesn't import

Individual visitor sessions or raw event logs
Custom events (daily aggregate totals only, where available)
Ecommerce / revenue data
Real-time data (only completed days; today is always excluded)

Option A — Public domain (no credentials)

If your Simple Analytics dashboard is public, Zenovay can pull your stats directly — no API key or CSV needed.

Open the domain's settings in Zenovay → Import tab.
Click the Simple Analytics tile and choose the Public mode.
Enter your site's domain as it appears in Simple Analytics (e.g. example.com).
Click Fetch stats. The import runs in the background — you can navigate away and come back; the status and history wait for you on the Import tab.

Option B — CSV export

Step 1: Export from Simple Analytics

Log in to simpleanalytics.com and open your website.
Click Export in the top navigation.
Choose CSV and select the date range you want to export.
Download the file.

Step 2: Import in Zenovay

Open the domain's settings → Import tab.
Click the Simple Analytics tile and choose the Upload mode.
Drop your .csv file onto the upload area or click to browse (max 50 MB).
Click Import and wait. The import runs in the background; progress and history appear on the Import tab.

Option C — API key

What you need

A Simple Analytics API key — generate one in Simple Analytics under Account → API keys → Add API key with Stats read permission only.
Your Simple Analytics website hostname (e.g. example.com).

Steps

Open the domain's settings → Import tab.
Click the Simple Analytics tile and choose the API mode.
Enter your website hostname and your Simple Analytics API key.
Click Connect. The import runs in the background; progress and history appear on the Import tab.

After the import is complete, revoke the API key in Simple Analytics — Zenovay does not need it after the import, and limiting the key's lifetime reduces exposure.

Verify your import

After the import completes, run through this short checklist to confirm the data landed correctly.

Check the Import tab's history — each completed import shows its status and the date range it covered.
Open any analytics view in your dashboard (for example, pageviews for the last 90 days). Imported data appears immediately. Each day is stored as a single daily row, so imported days fill in your history alongside the days Zenovay already tracks. For days where you already have native Zenovay data, the imported figures replace that day (see the FAQ below), so the typical use is importing the history from before you switched to Zenovay.
Spot-check 3 random days against your Simple Analytics dashboard. Expect ±5% on pageviews and ±3% on unique visitors — Simple Analytics and Zenovay dedupe visitors differently, so a small gap is normal.
Re-import the same period to confirm idempotency. The row count should stay the same — duplicates are impossible because imported rows are upserted on a unique key.
When you're satisfied, revoke the API key you created in Simple Analytics (if you used Option C).

If any of these checks look off, email support@zenovay.com with the date you imported and which days look wrong. We can spot-fix individual days.

Troubleshooting

"Available on Pro" message

The Simple Analytics importer requires a paid plan. Upgrade your plan →

"Domain not public"

If you chose the public domain path but get this error, your Simple Analytics dashboard is set to private. Switch to the CSV or API key method, or temporarily make your dashboard public in Simple Analytics settings, import, then set it back to private.

"Invalid CSV format"

Zenovay expects the standard Simple Analytics CSV export format. Do not modify column headers or the date format. If you exported from the Simple Analytics data export page (not the stats export), the column format differs — use the Export → CSV option from the stats dashboard instead.

"Authentication failed" (API key)

Verify that the API key was created with Stats read permission. Keys with only Data export or Account permissions will not work. Generate a new key in Simple Analytics under Account → API keys and try again.

"No data for this period"

Simple Analytics only retains data according to your plan's retention window. If you're trying to import a date range older than your plan allows, the API returns empty results. Try a more recent date range or upgrade your Simple Analytics plan before exporting.

"Import timed out"

Very large date ranges can take time. Try splitting into smaller date ranges and reimporting — the idempotency constraint means overlapping ranges are safe.

FAQ

Will it overwrite my native Zenovay data? Zenovay stores one daily-totals row per day, so an import only affects the days it covers. For days you have not yet tracked with Zenovay, the imported day simply fills in the gap. For days you have already tracked natively, the imported figures replace that day's totals (and the day is tagged imported_from='simpleanalytics'). Because the usual case is importing the history from before you started tracking with Zenovay, there is normally no overlap. If you do need to keep native data for a given day, import a date range that ends before your Zenovay tracking began. The Import tab's history shows each completed import and the date range it covered.

Can I re-import? Yes, anytime. Re-importing overwrites the same date range cleanly — no duplicates, no orphan rows.

Does Zenovay store my Simple Analytics API key? No. The key is used only as the Api-Key header on the import requests to Simple Analytics and is not saved to the database. As a precaution you can still revoke it in Simple Analytics once the import is complete.

What time zone are the daily totals in? Simple Analytics stores data in UTC. Imported rows use UTC dates, which matches Simple Analytics' own dashboard.

Will Zenovay see my visitors' personal data? No. Simple Analytics' API returns only aggregate statistics. No individual visitor records, IPs, or user IDs are transferred to Zenovay.

Does this affect my Simple Analytics data? No. The importer is read-only. Zenovay never writes to your Simple Analytics account.

My site is on a free Simple Analytics plan — can I still import? Yes, via the CSV export (Option B) or the public domain path (Option A) if your dashboard is public. The API key path (Option C) requires a paid Simple Analytics plan that provides API access.