Statsig
Use GrowthLoop audiences for Statsig ID List segments.
Connect this destination to export audience membership as a Statsig ID List segment, for use in feature gates, experiments, or dynamic configs.
This destination writes to your Statsig account and is a good fit when you want to:
- Make GrowthLoop audiences available in Statsig feature gates, experiments, or dynamic configs
- Match contacts on a user identifier that matches the Statsig ID type
This maps to GrowthLoop Audiences:
| Use it for | Audiences |
|---|---|
| Sending GrowthLoop audiences as Statsig ID List segments | ✓ |
Prerequisites
Make sure you have:
- A Statsig project with permission to create API keys.
- A Console API Key from Statsig Project Settings → Keys & Environments. The key must start with
console-. - User identifiers in your warehouse that match the Statsig ID type you will use. The default is
userID.
WarningDo not use a Server Secret key (
secret-...). Server keys cannot create or update segments. GrowthLoop needs a Console API key to manage ID List membership.
See Statsig's Console API and ID List segments if you need more information on these steps.
Set up Statsig as a destination
- In GrowthLoop, click the Destinations tab on the left sidebar.
- Click New Destination in the top right corner.
- Search for Statsig and click Add Statsig.
- Enter the required information, then click Create.
| Field | Description |
|---|---|
| Destination Name | Name this destination in GrowthLoop. Use a name so your team recognizes its purpose, like "Statsig". |
| Sync Frequency | Set the default export frequency (for example, daily or weekly). You can override this setting for individual exports. |
| Console API Key | The Console API key from Statsig. It must start with console-. |
| ID Type | Optional. Statsig ID type for new ID List segments. Defaults to userID. Change this only if your project uses a different type, such as stableID. |
GrowthLoop validates the connection by listing segments. Statsig then appears in your list of connected destinations.
Export to Statsig
From within GrowthLoop, export from an audience. See Export an audience if you need more information on these steps.
After building or selecting an audience, click Export, then search for Statsig.
Map identifiers
Map one match field. The value must match the ID Type on the destination.
| Match field | Notes |
|---|---|
| User ID | Statsig user ID |
| ID | Alternate Statsig identifier |
This destination does not send additional personalization fields.
Configure the export
This is where you set the campaign type and schedule for audience exports.
- Export Name: Defaults to
{audience name}_GL_Audience_{audience ID}. That is the Statsig segment name unless you change it. - Campaign type: Choose a one-time or ongoing export.
- Export Inclusion Criteria: All audience members for a full refresh, or Newly added audience members for additions and removals since the last export.
- Schedule: Set frequency, start date, end date, and days of the week for ongoing exports.
Export behavior
This is what GrowthLoop writes when you export an audience.
| Behavior | What happens |
|---|---|
| What GrowthLoop writes | A Statsig ID List segment. Direction is GrowthLoop → Statsig. |
| When it runs | GrowthLoop sends the export as a batch on the next successful run. An export that starts Now runs within about 15 minutes. |
| Segment | GrowthLoop creates an ID List named after Export Name, or reuses that segment when the name or ID already exists. New segments use the ID Type from destination setup. |
| Match field | User ID or ID. |
| Add | GrowthLoop adds IDs for contacts who enter the audience. |
| Remove | GrowthLoop removes IDs for contacts who leave the audience. |
| One-time exports | GrowthLoop sends current membership once. |
| Ongoing adds and removals | Ongoing exports add contacts who enter the audience and remove contacts who leave the segment. |
| Deletes | GrowthLoop does not delete the Statsig segment. |
Confirm the export was successful
When the run finishes, confirm you can use the data in Statsig.
- Audience export: Open Segments in the Statsig console and look up the ID List. Look for the
_GL_Audience_name unless you changed Export Name. Confirm the expected IDs appear, then add that segment to a feature gate, experiment, or dynamic config.
In GrowthLoop, review counts on the audience Exports tab. See Export an audience for more information.
Congrats on successfully exporting to Statsig!
Troubleshooting
These are the issues we see most often. You can always email us at [email protected] for help.
| Problem | Cause | Resolution |
|---|---|---|
| Connection fails to validate | The key is a Server Secret (secret-...), or the Console key is wrong | Paste a Console API key that starts with console- from Project Settings → Keys & Environments |
| Rows fail to export | User ID and ID are both unmapped or blank | Map User ID or ID |
| Users are missing from the segment | The mapped values do not match the destination ID Type | Use identifiers for that ID type, such as userID or stableID |
| You cannot find the segment | You are searching for the unsuffixed audience name | Search Statsig Segments for the _GL_Audience_ export name |
| Contacts who left the audience are still in the segment | The export is one-time, or inclusion criteria did not include removals | Use an ongoing export and Newly added audience members or All audience members so removals run |
Updated 2 days ago