Integrate Amplitude Audience Sync

  • Updated

Import your Amplitude behavioral cohorts into Optimizely Data Platform (ODP) as ODP real-time segments. You can then use your ODP real-time segments in other Optimizely products, including Optimizely Web Experimentation, Optimizely Feature Experimentation, and Optimizely Content Management System.

Prerequisites

Enable the integration in ODP

  1. Go to the App Directory in ODP.
  2. Select the Amplitude Audience Sync app.
  3. Click Install App.
  4. Go to Settings > Get Token and copy the result for later use.

Add the Optimizely destination in Amplitude

In Amplitude:

  1. Go to Data > Connections > Catalog > Destinations.
  2. Select Optimizely.
  3. Complete the following fields:
    • Name – Enter your desired name for the integration. For example, Optimizely Real-Time Segments.
    • Bearer Token – Paste the token that you copied in step 4 of the Enable the integration in ODP section.
    • User ID Mapping – Select the same user identifier that you are using in Real-Time Segments for Optimizely Experimentation or CMS Visitor Groups.
    • Region – Select your region.
  4. Click Save.

Sync Amplitude behavioral cohorts to ODP

Repeat the following steps for each Amplitude behavioral cohort that you want to sync to ODP:

  1. Go to Cohorts & Audiences > Cohorts.
  2. Select the behavioral cohort and click Sync.
  3. Select Optimizely on the Select Destination window.
  4. Ensure Select an API target to sync to is set to the name you defined in step 3 of the Add the Optimizely destination in Amplitude section.
  5. Click Next.
  6. Select your desired sync cadence and click Sync. This syncs the behavioral cohort to ODP as a real-time segment.

Behavioral cohorts that you sync from Amplitude to ODP display in ODP with the prefix "Amplitude." For example, if the behavioral cohort name in Amplitude is New users in the last 30 days, it displays on the ODP Customers > Real-Time Segments page as Amplitude - New users in the last 30 days.

Use your Amplitude behavioral cohorts in Optimizely Experimentation

You must configure the Real-Time Segments in Optimizely Web Experimentation or Optimizely Feature Experimentation integration before you can access your Amplitude behavioral cohorts in Optimizely Experimentation.
  1. In Optimizely Experimentation, go to the Audiences page.
  2. Edit an audience or click Create New Audience.
  3. Expand Real-Time Segments, then drag and drop the Custom Segments condition into the Audience Conditions section.
  4. Expand the Custom Segments drop-down list and select the audience you connected from Amplitude.
  5. Click Save Audience.

Now you can add this audience to an experiment.