On this page

Segment

Send Amplitude behavioral cohorts to Segment to use with your ad networks, marketing automation tools, and personalization engines, so you can tailor campaigns and product experiences.

Considerations

  • To configure this integration, you need a level of access that allows you to configure sources in Segment and integrations in Amplitude. For Amplitude users, you need Admin or Manager privileges.
  • This integration sends user_id values from behavioral cohorts to Segment, along with an attribute that flags the cohort each user belongs to.
  • Anonymous users aren't supported.
  • You can sync behavioral cohorts to your Segment-connected raw data warehouses and downstream destinations that accept Segment identify events. Amplitude sets cohorts as unique user traits in Segment with True/False values to reflect whether the user belongs to the synced cohort.

Set up the integration

Segment setup

  1. Add Amplitude as a source on your Segment account. Follow the directions in Segment's documentation.
  2. Copy the Amplitude source's writeKey from Segment. You need this key for setup in Amplitude.

Amplitude setup

  1. In Amplitude Data, click Catalog and select the Destinations tab.
  2. In the Cohort section, click Segment.
  3. Click Add New Key and paste the writeKey (the key you copied in step 2).
  4. Enter a name for the Segment writeKey you pasted. (You can use the same name you used for the Amplitude source in Segment). When you add multiple Segment destinations to receive cohorts, the name helps you identify which destination you're sending to.
  5. Save when finished.

Send a cohort

Amplitude sends cohort data to Segment by triggering an identify call for each user in the syncing cohort. The data appears as <cohort_name> (<cohort_id>) with True or False as the value, depending on whether the user satisfies the cohort's membership criteria at that time.

  1. In Amplitude, open the cohort you want to export. Click Sync, and choose Segment.
  2. Choose the API target. This is the name you gave the integration in Amplitude.
  3. Select the sync cadence. If you're not sure which selection is best, try automated, recurring syncs for strategically essential cohorts, and one-time syncs for project work.
  4. Save your work.

Was this helpful?