amplitude

# 📉 Amplitude

Amplitude product analytics — track events, analyze user behavior, run cohort analysis, manage user properties, and query funnel/retention data via the Amplitude API.

## Features

- **Event tracking** — log user events with properties
- **User analytics** — active users, sessions, engagement
- **Funnel analysis** — conversion through event sequences
- **Retention analysis** — user return rates over time
- **Cohort management** — create and manage user cohorts
- **User properties** — set and query user attributes
- **Revenue analytics** — LTV, ARPU, revenue tracking
- **Segmentation** — query by properties and events
- **Event segmentation** — event counts and breakdowns
- **Dashboard export** — export chart data

## Requirements

| Variable | Required | Description |
|----------|----------|-------------|
| `AMPLITUDE_API_KEY` | ✅ | API key/token for Amplitude |
| `AMPLITUDE_SECRET_KEY` | ✅ | Amplitude secret key for Export/Dashboard APIs |

## Quick Start

```bash
# Track an event
python3 {baseDir}/scripts/amplitude.py track '{"user_id":"user123","event_type":"purchase","event_properties":{"amount":29.99}}'
```

```bash
# Track batch events
python3 {baseDir}/scripts/amplitude.py track-batch events.json
```

```bash
# Set user properties
python3 {baseDir}/scripts/amplitude.py identify '{"user_id":"user123","user_properties":{"plan":"pro","company":"Acme"}}'
```

```bash
# Get active user counts
python3 {baseDir}/scripts/amplitude.py active-users --start 2026-01-01 --end 2026-02-01
```



## Commands

### `track`
Track an event.
```bash
python3 {baseDir}/scripts/amplitude.py track '{"user_id":"user123","event_type":"purchase","event_properties":{"amount":29.99}}'
```

### `track-batch`
Track batch events.
```bash
python3 {baseDir}/scripts/amplitude.py track-batch events.json
```

### `identify`
Set user properties.
```bash
python3 {baseDir}/scripts/amplitude.py identify '{"user_id":"user123","user_properties":{"plan":"pro","company":"Acme"}}'
```

#...