Table of Contents
This article focuses on the Amplitude --> Segment integration, which takes users from Behavioral Cohorts and forwards user_id's from Amplitude cohorts to Segment. For details on the Segment --> Amplitude integration, please visit this article.
Intro to Amplitude Engage
The Amplitude Engage product add-on (formerly known as Advanced Cohort Sync) lets you automatically send behavioral audiences to ad networks, marketing automation tools, and personalization engines so you can better tailor campaigns and product experiences.
With the Amplitude Engage, you can automatically send Amplitude’s behavioral cohorts to your Segment-connected data warehouse and downstream Segment destinations — like ad, email, and experimentation platforms — on an hourly and/or daily basis.
Please note that this integration will only send user_id values to Segment, along with an attribute that flags the cohort this user belongs to. Anonymous users are not supported yet.
Setting up the Integration
To set up the Engage integration with Segment, you'll need access to configure sources on Segment and integrations on Amplitude. For Amplitude users, you'll need Admin/Manager privileges in order to make changes to integrations.
Summarized steps are below with detailed steps following after.
- Add Amplitude as a source on your Segment account. Instructions on how to do so found here.
- Copy the Amplitude source's
writeKey
from Segment. You will need this key for the setup on Amplitude's end. - On Amplitude's side, click on "Manage Data" from the bottom left panel and choose the project you would like this integration to be set up for.
- On the left panel of the selected project, click on "Advanced" and then the "Integrations" tab at the top.
- Once you're on the integrations page, click on "Segment" and add the
writeKey
from Segment as the "API Key" for this integration.
Setting up Amplitude as a Segment Source
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.
The first step is to set up this up is by add Amplitude as a source on Segment. Instructions on how to do so can be found on Segment's documentation.
Setting up the Integration on Amplitude
Please note that only Amplitude Admins and Managers may setup or change Project integrations.
Once you have the writeKey
from Segment, you'll be ready to set up the integration on Amplitude's side.
Within the "Manage Data" view, select the Project where you want to send Cohorts to Segment. Next, select the "Advanced" section on the left-hand menu, and click the "Integrations" tab at the top of your screen.
Alternatively, you can get to this Integration setup page for a given Project by selecting the "+ Add Integration" option from the "Sync to" dropdown menu on a Cohort.
Finally, select "Segment" and paste the writeKey
, found within the Segment Source you created for "Amplitude Cohort ETL" from the Sources Catalog.
Exporting Behavioral Cohorts to Segment
Please note that 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..." option list on the Cohort screen. (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 "[Amplitude] <cohort_name> (<cohort_id>)" with True or False as the value depending on whether the given user has satisfies the Cohort membership criteria at the given time.
If you would like to set up a cohort to sync automatically with Segment on a daily/hourly basis, go to the cohort you would like to sync and click "Advanced Preferences." This will bring up a dialog that allows you to enable hourly or daily syncing, and also to disable syncing for a synced cohort.
If you’re interested in learning more about this add-on, visit this page or reach out to your customer success manager.