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 job, 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 job for Amplitude in the Lytics platform. If you are new to creating jobs in Lytics, see the Jobs Dashboard documentation for more information.

  1. Select Amplitude from the list of providers.
  2. Select the Import Cohorts job type from the list.
  3. Select the Authorization you would like to use or create a new one.
  4. Enter a Label to identify this job you are creating in Lytics.
  5. (Optional) Enter a Description for further context on your job.
  6. Complete the configuration steps for your job. Amplitude Cohort Import Config

  7. (Optional) From the Amplitude ID Field input, select the field name that contains the user's Amplitude ID. If left blank, cohorts will only be added to profiles.

  8. (Optional) From the Amplitude Cohort Names Field input, select the field name that contains the user's cohort membership. If left blank, cohorts will only be added to profiles.
  9. (Optional) From the Cohorts input, select select the cohorts you want to import. If left blank, all cohorts will be imported.
  10. (Optional) Select the Keep Updated checkbox, to import cohorts daily.
  11. (Optional) From the Time of Day input, select time of day to start import.
  12. (Optional) From the Timezone input, select timezone for time of day.
  13. Click Start Import.