# Segment

Source: https://amplitude.com/docs/data/destination-catalog/segment

---

On this page

- [Considerations](#considerations)
- [Set up the integration](#set-up-the-integration)
- [Segment setup](#segment-setup)
- [Amplitude setup](#amplitude-setup)
- [Send a cohort](#send-a-cohort)

# 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.](https://segment.com/docs/sources/cloud-apps/amplitude-cohorts/)
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?

<!--$-->

<!--/$-->
