Migrate your analytics data from Amplitude

Migrate your product analytics from Amplitude to Statsig in three steps: export your raw events, transform them into Statsig's event format, then import them into your Statsig project. After your data lands in Statsig, you work in a single platform that combines analytics, experimentation, and feature flagging. This guide covers the essentials; for anything beyond these basics, contact Statsig.

Step 1. Export your data from Amplitude

Amplitude offers a few different export methods. Pick the one that matches your data size and setup:

1. S3 Export

For high volume backfills, export your Amplitude data to an S3 bucket.

2. Warehouse Export

If your Amplitude data is already in Snowflake, BigQuery, or Redshift, you can skip file downloads. Statsig ingests directly from these warehouses (refer to Step 2.1).

3. Export API

Use Amplitude's Export API to pull gzipped JSON.

• Limit: 4 GB per request so use hourly windows for large ranges
• Example:

curl --location --request GET 'https://amplitude.com/api/2/export?start=<starttime>&end=<endtime>' \
-u '{api_key}:{secret_key}'

4. UI Download (CSV/JSON)

Go to Organization Settings → Project → Export Data.

• Best for small datasets or initial testing

Step 2. Transform your data

Amplitude and Statsig store events in slightly different formats. Map your Amplitude data to Statsig's format before importing, regardless of which import method you use in Step 3.

Before transform

// Amplitude event
{
  "event_type": "purchase",
  "user_id": "123",
  "device_id": "device_abc",
  "event_time": "2023-08-17T00:00:00Z",
  "event_properties": {
    "amount": 25,
    "currency": "USD"
  },
  "user_properties": {
    "plan": "premium"
  }
}

After transform

// Statsig event
{
  "event": "purchase",
  "user": {
    "userID": "123",
    "stableID": "device_abc",
    "plan": "premium"
  },
  "timestamp": 1692230400000,
  "metadata": {
    "amount": 25,
    "currency": "USD"
  }
}

Step 3. Import into Statsig

After your data is in Statsig event format, choose an import path based on how you exported:

S3 ingestion

• Transform files to the Statsig schema in Parquet, JSON, or CSV format, then follow the Statsig S3 ingestion steps.
• Shard your Amplitude raw data into one day per directory before ingesting into Statsig.

Warehouse ingestion

• Connect your warehouse to Statsig.
• Point Statsig at a query that outputs events in the expected schema.
• Statsig ingests on a recurring schedule.

UI download or Export API

This approach is best for test runs or initial migrations, not for millions of events.

curl -X POST https://api.statsig.com/v1/webhooks/event_webhook \
-H "Content-Type: application/json" \
-H "STATSIG-API-KEY: $STATSIG_SERVER_SECRET" \
-d '{
  "event": "signup",
  "user": { "userID": "abc" },
  "timestamp": 1692230400000
}'

Get migration help

If you're unsure how to approach this migration, contact the Statsig team. Statsig has worked closely with customers migrating from Amplitude and can provide hands-on support.