Skip to content

From Umami

Importing an Umami event dump, and mapping its vocabulary onto this one.

Get the export

Umami exports events. Take the event dump rather than a report: it is one row per event, which is the shape that imports cleanly and keeps the hour-of-day detail.

Import it

Upload on the site’s Imports screen, or point the importer at a URL. The importer resolves columns through a table of aliases, so Umami’s naming is read without reshaping.

Like every import, it is idempotent by replacement: every row carries an import_id, so re-running replaces rather than duplicates and undoing is a delete, and resumable through a staging table, so a job that died at row 400,000 resumes at 400,001.

Vocabulary

Umami Micaforge
Event An event with kind custom and an event_name.
Event data props, filterable as props.<key>
Session A session, with the same 30-minute inactivity rule.
Visit A session.
Referrer referrer, resolved into referrer_host, channel and source.

Umami’s per-event data becomes props verbatim, so a property you were filtering on there is filterable here under the same name.

What changes

Bots. Umami filters them. Micaforge names them and counts them separately, so nothing disappears and nothing is folded into the human numbers.

Answer engines. A top-level channel here, rather than a referrer among referrers.

Web Vitals and performance. Collected by the tracker from the first pageview after install. Nothing to import; it starts from the day you install.

After the import

Recreate your goals (they are not in an event dump) and check a week where both tools have data. Pageviews and sessions should agree closely, because both count the same things the same way. Where they differ, it is almost always bot filtering, and Micaforge can now show you exactly which agents made the difference.

Then turn on the server log feed, which is the half neither tool had.