Skip to main content

Hightouch

Overview​

Enabling the Hightouch integration allows you to send events and keep segments up-to-date in Statsig via Hightouch. You can ingest data into Statsig from any source that Hightouch supports.

You can find all events that Statsig receives from Hightouch in the Metrics tab in the Statsig console, if you’re on a Pro plan. Statsig automatically includes these events in Pulse and Experiment results for your feature gates and experiments respectively. You can view your updated segment lists on the Segments page.

Event configuration​

  1. From the API Keys tab in the Statsig console, copy the Statsig Client-SDK API key.
  2. Go to the Hightouch Destinations overview page and click the Add destination button. Select Statsig and click Continue. Enter the Client-SDK API key and click Continue.
  3. Give your destination a descriptive name, for example, "Statsig prod."
  4. Once you've set up your Statsig destination and have a model to pull data from, you can set up your sync configuration to begin syncing data. Go to the Syncs overview page and click the Add sync button to begin. Then, select the relevant model and the Statsig destination you previously set-up.
  5. Select Events as the sync type.
  6. Enter either a static value or select a column that contains Event names.
  7. Optionally, select a column that contains the event timestamp. If empty, Statsig uses the time the event arrives at the server.
  8. Choose source columns to sync as event metadata and user attributes, such as the User ID.
  9. Finally, select whether you want the first sync to backfill event data or not. For more information about configuration options see Hightouch’s Statsig docs.
  10. Run the sync and check that events appear in your Statsig Metrics tab.

Segment configuration​

The Hightouch integration lets you keep your segments up-to-date by adding or removing members based on changes in your source dataset.

  1. From the API Keys tab in the Statsig console, copy the Statsig Console API key.
  2. Go to the Hightouch Destinations overview page and click the Add destination button. Select Statsig and click Continue. Enter the Client-SDK API key and click Continue.
  3. Give your destination a descriptive name, for example, "Statsig prod."
  4. Once you've set up your Statsig destination and have a model to pull data from, you can set up your sync configuration to begin syncing data. Go to the Syncs overview page and click the Add sync button to begin. Then, select the relevant model and the Statsig destination you previously set-up.
  5. Select Segment as the sync type.
  6. Select whether you would like to create a new audience or use an existing audience to sync data to. If creating a new audience, you can give it a name. If you leave this input blank, Hightouch uses the name of your model for the audience.
  7. Select the audience's ID type: either userID or stableID.
  8. Select the source column and Statsig field to match records on. For more information see Hightouch's docs on record matching.
  9. Schedule your sync to run as frequently as you need. You can view your updated segment lists on the Segments page.

Troubleshooting​

If you have any questions, don’t hesitate to contact Hightouch support for assistance.