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 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
writeKeyfrom Segment. You will need this key for the setup on Amplitude's end. - On Amplitude's side, click on "Sources & Destinations" in the bottom left panel and choose the project you would like this integration to be set up for.
- Navigate to the "Destinations" tab and click on "+Add Destination" in the top right corner.
- Select "Segment" and add the
writeKeyfrom 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 to get this set up is by adding 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 Sources and Destinations.
Once you have the writeKey from Segment, you'll be ready to set up the integration on Amplitude's side.
Within the "Sources & Destinations" view, select the Project where you want to send Cohorts to Segment. Next, select the "Destinations" tab and click the "+Add Destination" at the top right of your screen.
Alternatively, you can get to this Destinations setup page for a given Project by selecting the "+ Add or Manage Destinations" 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 Cohorts" 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, click "Sync to" in the menu, and select the Segment destination. 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 the Engage add-on, visit this page or reach out to your customer success manager.