Amplitude Engage Event Source


Good to know: Event Cloud source

The Amplitude Engage Event Source is an event source. This means that it sends data as events, which are behaviors or occurrences tied to a user and a point in time. Data from these sources can be loaded into your Segment warehouses, and also sent to Segment streaming destinations. Learn more about cloud sources.

This source is supported in US data processing regions.

The Amplitude Engage Event source is only supported in workspaces configured to process data in the US region. Workspaces configured with data processing regions outside of the US cannot connect to this source. For more information, see Regional Segment.

This source combines Amplitude’s analytics with Segment’s rich connections ecosystem. This allows you to export Behavioral Cohorts from Amplitude to Segment so that you can better target users across their many downstream connections. You can easily sync Behavioral Cohorts to your Segment-connected raw data warehouses and downstream destinations that accept Segment identify events.

Good to know: This page is about the Amplitude Engage Segment source, which sends data into Segment. There’s also a page about the Amplitude Segment destination, which receives data from Segment!

Getting Started

  1. From your Sources page in Segment, click Add source.
  2. Choose Amplitude Engage, then click Connect.
  3. Give the Source a nickname. The nickname is a label used in the Segment interface.
  4. From the new Source’s Overview page, copy the Segment writeKey.
  5. To export users from Amplitude to Segment, first, in Amplitude, create the cohort of users you wish to export. You can read more about the different types of cohorts you can create in Amplitude’s documentation.
  6. In your Amplitude account, navigate to your Behavioral Cohort and paste the Segment writeKey under “Sync to” -> “Add Integration” if the Segment integration is not already set up for your project. NOTE: If you have just added the integration and do not see Segment in the list, you will need to refresh your page in order to see it in the list.

Enable syncing to Segment

Select Segment

Add your Segment writeKey

  1. If you would like to set up automated export on an hourly or daily basis, you can use Amplitude’s Cohort Sync feature. Click “Advanced Preferences” and select “Segment” as the integration.
  2. From your Segment account, click into your Amplitude Engage Source, and you’ll be able to add other downstream destinations where you want to see your Behavioral Cohort data.

you’re all set! Behavioral Cohorts will now sync to Segment based on the sync schedule you defined in Amplitude.

How Amplitude Syncs Cohorts

Amplitude sends cohort data to Segment by triggering an identify call for each user in the cohort being synced, for example:

analytics.identify({
  userId: <amplitude_user_id>,
  traits: {
    '[Amplitude] <some_cohort_name> (<cohort_id>)': true
  },
  context: {
    integration: {
      name: 'Amplitude Cohort Sync',
      version: '1.0.0'
    }
  }
})

Upon subsequent cohort syncs (manual or scheduled), Amplitude syncs only new users and users whose cohort status has changed (e.g. a user has left a cohort). When a user has left a cohort, Amplitude sends false as the cohort trait value, for example:

analytics.identify({
  userId: <amplitude_user_id>,
  traits: {
    '[Amplitude] <some_cohort_name> (<cohort_id>)': false
  },
  context: {
    integration: {
      name: 'Amplitude Cohort Sync',
      version: '1.0.0'
    }
  }
})

This page was last modified: 27 Oct 2023



Get started with Segment

Segment is the easiest way to integrate your websites & mobile apps data to over 300 analytics and growth tools.
or
Create free account