Amplitude Recommend lets you automatically send behavioral audiences to ad networks, marketing automation tools, and personalization engines so you can better tailor campaigns and product experiences. Use it to automatically send cohorts to your Segment-connected data warehouse and downstream Segment destinations — like ad, email, and experimentation platforms — on an hourly and/or daily basis.
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 are not currently supported.
If you're looking to import your data from Segment rather than exporting cohorts to Segment, here is a separate Help Center article on importing data from Segment into Amplitude.
Set up the integration
To set up the Recommend integration with Segment, you'll need a level of access that allows you to configure sources in Segment and integrations in Amplitude. For Amplitude users, this means you'll need Admin or Manager privileges.
You can easily 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 given user belongs to the cohort that has been synced.
To set up this integration, follow these steps:
- Add Amplitude as a source on your Segment account. Instructions on how to do so can be found in Segment's documentation.
- Copy the Amplitude source's
writeKeyfrom Segment. You will need this key for the setup in Amplitude.
- In Amplitude, click Data Destinations in the left-hand sidebar and choose the project that contains the cohorts that you'd like to export to Segment.
- Under View All Destinations, find the Segment panel and click it.
In the modal that appears, click +Add New Key and click the text box that says Add an API Key to paste the
writeKey(the key you copied in step 2).
Enter a name for the Segment
writeKeyyou 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.
Export behavioral cohorts to Segment
NOTE: Only Members, Managers, and Admins can setup Syncs for Cohorts.
Once you've saved your
writeKey, Segment will be an available option in the Sync to... list when viewing a Cohort in Amplitude. (Refresh your browser if you don't initially see it.)
Amplitude sends cohort data to Segment by triggering an identify call for each user in the cohort being synced with that appears as
<cohort_name> (<cohort_id>) with
False as the value, depending on whether the given user satisfies the cohort's membership criteria at that time.
If you would like to set up a cohort to sync automatically with Segment on a daily or hourly basis, go to the cohort you would like to sync, click Sync to in the menu, and select the Segment destination. This will bring up a dialog where you can enable hourly or daily syncing. You can also use it to disable syncing for a synced cohort.