# TraceRank CSV Readiness Pack

TraceRank requires a clean journey export with these columns:

- `user_id`
- `session_id`
- `event_name`
- `stage`
- `occurred_at`

## Required formatting rules

### user_id
Stable identifier for the user.

### session_id
Stable identifier for the session. Multiple events from the same session must reuse the same value.

### event_name
Exact event label from your system, such as:
- `visit`
- `create_account_started`
- `create_account_completed`
- `verify_success`
- `setup_integration_success`
- `first_output`

### stage
Use consistent stage vocabulary. Recommended:
- `Visit`
- `Create Account`
- `Verify`
- `Setup`
- `First Value`

### occurred_at
Use an ISO timestamp, for example:
- `2026-04-09T14:00:00Z`

## Common fixes

### Missing fields
Every row must contain all five required columns.

### Unclear stage mapping
Map every event to one of the defined stages before upload.

### Unclear first value
Choose one event that clearly represents first usable product value.

### Inconsistent timestamps
Use one timestamp format across the file.

## Minimum expectations
- One row per event
- Same session uses same `session_id`
- Same user uses same `user_id`
- First value event is clearly represented
- Stage names are consistent across rows

## Included files
- `tracerank_stage_mapping_template.csv`
- `tracerank_event_taxonomy_template.csv`
- `tracerank_sample_export.csv`