Importing Custom CSV Event Data into Alytica
A guide to formatting and importing your own custom event CSVs into Alytica with automatic mapping and enrichment.
Importing Custom CSV Event Data into Alytica
Alytica supports importing event data from your own tools, tracking scripts, or exports — as long as it's in a standard CSV format. This guide explains how to structure your CSV file and what fields are automatically detected and enriched during import.
Step 1: Prepare Your CSV File
Your CSV should include one row per event. At a minimum, we recommend including:
event_name
– the name of the eventtime
– a timestamp for when the event occurred
All other fields are optional. Alytica will automatically parse, enrich, and map the data on import.
✅ No manual column mapping required — Alytica handles everything automatically.
Step 2: Import Your File
-
Go to your Alytica dashboard.
-
Navigate to:
Project Settings → Analytics → Import Data -
Click Upload CSV and select your custom file.
-
Alytica will automatically process your file and show your imported data in the Analytics dashboard.
How Your Data Is Transformed
Here’s how Alytica processes each known field. Everything else is stored as a custom property.
CSV Column | Description | Required |
---|---|---|
event_name | The name of the event | ✅ |
time | Event timestamp (automatically converted) | ✅ |
user_id | Unique identifier for the user | ✅ |
device_id | Device identifier | ✅ |
session_id | Session identifier | ✅ |
url | Full URL and parsed parts | ⛔️ |
page_title | Page title of the event | ⛔️ |
referrer | Referrer URL and source classification | ⛔️ |
user_agent | User agent string parsed into browser, OS, device, etc. | ⛔️ |
country | Country of the user | ⛔️ |
city | City of the user | ⛔️ |
region | Region or state | ⛔️ |
regionCode | Region code (e.g., "CA") | ⛔️ |
ISP | Internet Service Provider | ⛔️ |
screen_width | Screen width in pixels | ⛔️ |
screen_height | Screen height in pixels | ⛔️ |
Additional Fields
Any other columns in your CSV will be added to the event as custom properties and will be available in the analytics dashboard for filtering, segmentation, and querying.
Example CSV (Minimal)
If you have any issues with the import, reach out to us at support@alytica.tech. We're happy to help!