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.


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 SettingsGet 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 Audience Targeting.
    • 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 Optimizely Experimentation Advanced Audience Targeting or CMS visitor groups.
  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 Configure 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 Optimizely Data Platform Audience Targeting integration in Optimizely Web Experimentation or Optimizely Feature Experimentation 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 Optimizely Data Platform Audience Targeting, 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.