Documentation / Product / Integrations / Amplitude

Amplitude: Import Cohorts

Importing cohorts from Amplitude results in new and/or updates to existing user profiles in your Lytics account containing fields from Amplitude. Once imported, Lytics can use this Amplitude data to inform its ML-based enrichments, and this data enables you to target your multi-channel campaigns orchestrated by Lytics.

Integration Details

  • Implementation Type: Server-side.
  • Implementation Technique: REST API.
  • Frequency: One-time batch, or daily continuous updates where the time of day can be configured.
  • Resulting Data: Full user profiles from Amplitude for selected Cohorts.

This integration utilizes the Amplitude Behavioral Cohorts API to retrieve data. On each run of the workflow, it will request a list of cohorts, and for each cohort selected by the user during the configuration step, it will:

  1. Request a single cohort for download.
  2. Poll the request status for completion.
  3. Once completed, download the cohort file.
  4. Ingest the data from the cohort file into the Lytics data stream amplitude_cohorts.


The following fields are included in the default mapping of the amplitude_cohorts stream:

Source FieldLytics User FieldDescriptionType
citycityAmplitude Citystring
regionregion, stateAmplitude Region/Statestring
countrycountryAmplitude Countrystring
deviceamplitude_deviceAmplitude Devicestring
device_typeamplitude_device_typeAmplitude Device Typestring
languageamplitude_languageAmplitude Languagestring
carrieramplitude_carrierAmplitude Carrierstring
platformamplitude_platformAmplitude Platformstring
last_computedamplitude_last_computedAmplitude Cohort Last Computeddate
dmaamplitude_dmaAmplitude DMAstring
libraryamplitude_libraryAmplitude Libratystring
start_versionamplitude_start_versionAmplitude Start Versionstring
versionamplitude_versionAmplitude Versionstring
osamplitude_osAmplitude OSstring
cohort_idamplitude_cohort_idsAmplitude Cohort IDsmap[string]bool
cohort_nameamplitude_cohort_namesAmplitude Cohort Namesmap[string]bool
user_idamplitude_user_id unique idAmplitude User IDstring
amplitude_idamplitude_id unique idAmplitude IDstring


Follow these steps to set up and configure an import of Amplitude Cohorts in the Lytics platform.

  1. Navigate to the Integrations page and select the Amplitude tile. Amplitude
  2. Select Workflows from the menu on the left.
  3. Select Import Cohorts from the list of workflows.
  4. Select the Authorization you would like to use.
  5. (Optional) Use the Cohorts input to select the cohorts you want to import. Cohorts available to be imported from Amplitude are located in the left column. Cohorts added to the right column will be imported into Lytics. If no cohorts are selected, all available cohorts will be imported.
  6. (Optional) Select the Keep Updated checkbox to run this import daily.
  7. (Optional) From the Time of Day drop-down, select the time you would like the import to run. If left blank, the next run will be 24 hours after the work completes. Note: the import will run once immediately after you select Start Import, but will run at the selected time thereafter.
  8. (Optional) From the Timezone drop-down select the timezone for the next run. If left blank the Time of Day will use the UTC timezone.
  9. Click the Start Import button to begin importing your selected cohorts. Amplitude_cohorts_config