On this page

Amplitude

Connect Amplitude with Statsig to import events and metrics for experiment analysis or export Statsig data into Amplitude dashboards and notebooks.

How the Amplitude integration works

Statsig supports both incoming and outgoing events for Amplitude, and also supports adding Amplitude Cohorts to Statsig ID Lists.

Incoming: receiving events from Amplitude

This integration supports ingestion for Statsig Cloud only. For Warehouse Native, create a metrics source that references this data in your warehouse.

The following steps outline how to forward events from Amplitude into Statsig.

  1. Get a Statsig "Server Secret Key" from the API keys page in Project Settings.

  2. Go to Amplitude and navigate to the Data Destinations page. Click the "Add Destination" button in the top right.

    Amplitude Data Destinations page showing Add Destination button

  3. From the Destinations Catalog, search for and select the Statsig Event Streaming destination.

    Destinations catalog highlighting Statsig event streaming option

  4. Give this destination a name and click "Create Sync".

    Create Sync form for Statsig destination

  5. Enter the "Server Secret Key" you copied in Step 1 into the provided field. Select the events you wish to send to Statsig. Ensure that the Status is set to "Enabled" and then click "Save".

    Statsig destination settings entering server secret key and event selection

  6. Enable the integration - On the Integrations page for your Statsig project, enable the Amplitude Incoming integration.

    Statsig integration panel confirming Amplitude connection

Outgoing: sending Statsig events to Amplitude

  1. Navigate to Amplitude and click on the Settings button in the bottom-left corner.

    Amplitude settings menu accessed from bottom-left

  2. Click on the Projects tab and choose the Project you wish to send data to.

    Amplitude Projects tab listing available workspaces

  3. Copy the API Key and paste it in the Statsig integration panel.

    Amplitude project API key display

    Statsig integration panel fields for Amplitude API key

  4. Select Enable on the integration panel. Any data logged to Statsig appears in your Amplitude project.

    Amplitude event stream showing Statsig exposure events

First exposures

First exposures are an enterprise-tier feature that simplifies your project insights.
This feature requires an Enterprise contract. Reach out to the support team, your sales contact, or through the Slack community to enable it.

How first exposures work

The Amplitude integration can forward first exposures instead of every exposure, reducing the total number of events forwarded. Statsig calculates first exposures daily and forwards them to integrations at approximately 7pm UTC.

How to enable

First, confirm that Statsig has enabled the "first exposure" feature for your account by reaching out to the support team, your sales contact, or through the Slack community. After that, go to the event filtering tab of the integration and enable the "First Exposure" setting.

Example events in Amplitude

Example of a get_experiment First Exposure in Amplitude.

Example first exposure event in Amplitude log

Accessing raw data

To access raw first exposure data in CSV format, make a request to the console/v1/reports endpoint to receive a download link.

Cohort sync: syncing Amplitude cohorts to Statsig segments

For current configuration information on syncing Cohorts (also called Segments) from Amplitude to Statsig, refer to Amplitude's documentation.
Ensure you create and use a console API key from your Statsig project settings

Filtering events

You can customize which events Statsig sends and receives through Amplitude using Event Filtering.

Was this helpful?