HitKeep imports Simple Analytics history from the raw datapoints CSV. Open Simple Analytics’ current export page, choose the website and export the pageviews and events you want to migrate as CSV. In HitKeep, use Integration → Import & Export for the destination site. Simple Analytics’ export guide links to its current export interface and API helper.
Start Tracking Before Moving History
Section titled “Start Tracking Before Moving History”New to HitKeep? Create a workspace, add the destination site, copy its generated snippet from Site Settings, and install the tracker. Keep Simple Analytics running while you verify new pageviews. A historical export is optional: you can start using HitKeep even if your source account cannot export raw data.
Before You Export
Section titled “Before You Export”Check your source account’s export entitlement before planning a historical migration. Simple Analytics documents plan restrictions for Export API access; a Free account should not be assumed to include it. See its export guide and current plans.
If you have a missing-badge notice, resolve it or save an available export before access is restricted. Simple Analytics can lock exports after the 14-day warning period while tracking continues. Restoring badge compliance restores access, but does not change your plan’s export entitlement.
Choose the destination’s retention window before importing: HitKeep Free Cloud keeps 60 days of history and removes older data. Keep an untouched copy of your CSV separately; do not use the Free dashboard as your only historical archive.
You need access to the Simple Analytics website you are moving and site.manage_data access for the destination HitKeep site.
HitKeep accepts any .csv file whose header matches the Simple Analytics raw datapoints schema. The filename is only used for display, validation warnings, and import history.
Export From Simple Analytics
Section titled “Export From Simple Analytics”- Open the export page and sign in to Simple Analytics.
- Select the website and date range you want to migrate.
- Include pageviews and events, along with the raw datapoint fields required below.
- Choose CSV and download the export.
Simple Analytics’ guide notes that its older video is outdated. Use the current export page or Generate export URL helper if the navigation differs. API export availability depends on your Simple Analytics plan.
Use a raw datapoints export rather than an aggregated report. HitKeep expects the raw datapoints CSV with fields such as added_iso, datapoint, path, document_referrer, device_type, country_code, is_unique, and duration_seconds. If the export includes optional fields such as browser_name, browser_version, lang_language, and lang_region, HitKeep imports those into browser and language reports too.
Import Into HitKeep
Section titled “Import Into HitKeep”- In HitKeep, select the destination site.
- Open Integration → Import & Export from the left navigation.
- Choose Simple Analytics as the importer.
- Upload the downloaded datapoints CSV.
- Run validation and review the date range, row counts, accepted rows, skipped rows, and warnings.
- Start the import after the validation summary matches what you expect.
The import writes to the currently selected HitKeep site. If you manage multiple sites, check the site switcher before uploading the CSV. HitKeep uses that selected site’s domain to suppress self-referrers from the imported source breakdown.
CLI Import
Section titled “CLI Import”The CLI reuses HITKEEP_PUBLIC_URL when it is already set, and otherwise talks to http://localhost:8080. Pass --url only when running the command from a different machine.
You can validate the same file from the command line:
hitkeep import validate simpleanalytics --site <site-id> --file simple-analytics-export.csvStart the import after reviewing the manifest:
hitkeep import simpleanalytics --site <site-id> --file simple-analytics-export.csv --waitWhat HitKeep Imports
Section titled “What HitKeep Imports”HitKeep imports Simple Analytics pageview history into compatible aggregate reports:
| Simple Analytics field | HitKeep report data |
|---|---|
added_iso | Daily traffic date |
is_unique | Visitors and visits |
datapoint=pageview | Pageviews |
duration_seconds | Visit duration totals |
path | Top pages |
document_referrer | Top sources |
device_type | Device breakdown |
country_code | Country breakdown |
browser_name / browser_version | Browser breakdown when present |
lang_language / lang_region | Language breakdown when present |
utm_source | UTM source breakdown |
Simple Analytics datapoints exports do not include everything HitKeep can track natively. Bounce counts and native HitKeep event relationships are not invented during import. Browser and language dimensions are imported only when the CSV includes the relevant fields. If the CSV contains unsupported datapoint types, validation reports them as skipped rows so you can review the coverage before importing.
After Import
Section titled “After Import”Open the destination site’s dashboard and select the imported date range. The imported pageviews, visitors, pages, sources, devices, countries, browser names, language codes, and UTM source data appear in compatible historical reports when those fields exist in the CSV.
For API automation, use the import endpoints under the Imports API reference.