Alytica Docs
GuidesImport

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 event
  • time – 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

  1. Go to your Alytica dashboard.

  2. Navigate to:
    Project SettingsAnalyticsImport Data

  3. Click Upload CSV and select your custom file.

  4. 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 ColumnDescriptionRequired
event_nameThe name of the event
timeEvent timestamp (automatically converted)
user_idUnique identifier for the user
device_idDevice identifier
session_idSession identifier
urlFull URL and parsed parts⛔️
page_titlePage title of the event⛔️
referrerReferrer URL and source classification⛔️
user_agentUser agent string parsed into browser, OS, device, etc.⛔️
countryCountry of the user⛔️
cityCity of the user⛔️
regionRegion or state⛔️
regionCodeRegion code (e.g., "CA")⛔️
ISPInternet Service Provider⛔️
screen_widthScreen width in pixels⛔️
screen_heightScreen 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)

event_name,time,user_id,url,page_title
Button Click,2025-04-10T12:34:56Z,12345,https://example.com/page,Landing Page
event_name,time,user_id,product_id,cart_value
Add to Cart,2025-04-10T12:45:00Z,12345,P987,49.99

If you have any issues with the import, reach out to us at support@alytica.tech. We're happy to help!

On this page