> ## Documentation Index
> Fetch the complete documentation index at: https://docs.datalyr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Customer Journeys

> View complete customer journeys from first touch to conversion

Customer Journeys shows the complete path each visitor takes through your site, including every touchpoint, event, and conversion across all sessions and devices.

## What It Does

**Tracks Individual Users:**

* All events and pageviews chronologically
* Sessions grouped automatically (30-minute timeout)
* Cross-device attribution via email identification
* Complete attribution from first touch to conversion

**Shows Per User:**

* Email, visitor ID, user ID
* Sessions, events, total value
* Location and device information
* First touch attribution
* Complete event timeline

## Key Features

### Users Table

Browse all visitors with key metrics:

**Columns:**

* Email / ID
* Sessions count
* Events count
* Total value
* Location
* Last seen timestamp

**Filters:**

* Date range (Today, 7D, 30D, 3M, 12M)
* Search by email, visitor ID, or user ID
* Load more (paginated for performance)

### Journey Timeline

Click any user to view their complete journey:

**User Summary Card:**

* Profile information (email, IDs)
* Activity stats (sessions, pageviews, events, value)
* Location and device
* First touch attribution (source, medium, campaign)

**Event Timeline:**

* All events in reverse chronological order (newest first)
* Pageviews, custom events, conversions
* Parameters for each event (UTM tags, custom properties)
* Session grouping

**Event Types:**

* Pageview (with referrer)
* Identify (user signup/login)
* Custom events
* Conversion events (with value)

### Cross-Device Tracking

Links visitors across devices using email identification:

**Example:**

```
Day 1 (Mobile): Clicks Facebook ad, browses pricing
Day 3 (Desktop): Signs up with email
Day 7 (Desktop): Purchases $99

Result: Purchase attributed to Facebook ad from mobile
```

When `identify()` is called with email, DATALYR links all sessions for that user.

## Use Cases

**Debugging Conversions**

```
User didn't convert - why?
View their journey
See drop-off points
Identify friction in funnel
```

**Attribution Research**

```
Which ads drive quality users?
Filter high-value customers
Check first touch attribution
Analyze successful paths
```

**Support Investigations**

```
User reports signup issue
Search by email
View events around problem time
See error events
```

**Understanding Behavior**

```
How do users discover features?
Track navigation patterns
See path to upgrade
Identify common journeys
```

**Cross-Device Analysis**

```
Do users switch devices?
See mobile vs desktop behavior
Verify attribution works
Understand user habits
```

## How It Works

### Identity Resolution

**Step 1:** Anonymous visitor browses (visitor\_id: anon\_abc123)
**Step 2:** User signs up and you call identify():

```javascript theme={null}
datalyr.identify('user_xyz789', {
  email: 'user@example.com'
});
```

**Step 3:** DATALYR links all past and future events to this user
**Step 4:** Cross-device purchases attributed correctly

### Event Parameters

Journey shows relevant parameters only:

**Shown:**

* UTM tags (source, medium, campaign)
* Click IDs (fbclid, gclid, ttclid)
* Custom properties (plan, order\_id, etc.)
* User traits (name, email)

**Hidden (Technical):**

* visitor\_id, session\_id, timestamps
* user\_agent, IP, device fingerprints
* Screen dimensions, viewport size

## Best Practices

**Identify Users Early:**

```javascript theme={null}
// Call immediately after signup
datalyr.identify(user.id, {
  email: user.email,
  name: user.name
});
```

**Add Meaningful Parameters:**

```javascript theme={null}
datalyr.track('purchase', {
  order_id: 'ch_123',
  plan: 'pro_monthly',
  value: 99.00
});
```

**Track Key Milestones:**

```javascript theme={null}
datalyr.track('signup');
datalyr.track('first_project_created');
datalyr.track('team_invited');
datalyr.track('purchase');
```

**Monitor High-Value Users:**

* Filter by Value > \$500
* Review their journeys
* Identify common patterns

## Next Steps

<CardGroup cols={2}>
  <Card title="Dashboard" icon="gauge" href="/features/dashboard">
    View aggregated metrics
  </Card>

  <Card title="Reports" icon="chart-bar" href="/features/reports">
    Analyze attribution by source
  </Card>

  <Card title="Event Stream" icon="list" href="/features/event-stream">
    See real-time events
  </Card>

  <Card title="Identity Calls" icon="user" href="/understanding-data/identity-calls">
    Learn about identify() method
  </Card>
</CardGroup>