Documentation / Product / Integrations / Drift

Drift: Import Activity Data

Importing user and activity data from Drift results in new users or existing user profiles supplemented with Drift conversation data. You can use this data to build and refine your existing Lytics audiences to power better, cross-channel campaigns.

Integration Details

This integration uses Drift's Conversation API to import conversations. Once the job is started, it will:

  1. Retrieve conversations from Drift
  2. Retrieve contacts assocatied with each conversation.
  3. Retrieve messages associated with each conversation.


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

Source FieldLytics User FieldDescriptionType
contact_iddr_contact_id unique idDrift Contact IDstring
email(email)email unique idEmailstring
emaildomain(email)emaildomainEmail Domainstring
epochms(start_date)dr_start_dateDrift Start Dateint
first_namefirst_nameFirst Namestring
full_namenameFull Namestring
last_namelast_nameLast Namestring
set(split(tags, ","))dr_tagsContact Tags[]string

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

Source FieldLytics User FieldDescriptionType
contact_iddr_contact_id unique idDrift Contact IDstring
conversation_iddr_conversation_id unique idDrift Conversation IDstring
count(msg_author_type)dr_contact_msg_ctDrift Contact Message Countint
count(msg_id)dr_msg_ctTotal Drift Message Countint
max(epochms())dr_last_msg_tsTime of Last Drift Messagedate
min(epochms())dr_first_msb_tsTime of First Drift Messagedate
msg_postal_codezipPostal Codestring
valuect(hourofday())dr_hourlyDrift Active Hour of daymap[string]intsum
valuect(hourofweek())dr_hourofweekDrift Active Hour of Weekmap[string]intsum
valuect(yymm())dr_yymmDrift Active Monthsmap[string]intsum


Follow these steps to set up and configure an import job for Drift in the Lytics platform. If you are new to creating jobs in Lytics, see the Jobs Dashboard documentation for more information.

  1. Select Drift from the list of providers.
  2. Select the import 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. (optional) Select the Keep Updated checkbox to import continuously.
  7. (optional) In the Start Date text box, enter a date to begin importing data from. Please use the format yyyy-mm-dd, e.g. 2021-11-19.
  8. (optional) Select the Skip Messages checkbox to skipping importing message details.
  9. (optional) Select the Skip Contact Details checkbox to skip importing contact details.

Drift Import Config

  1. Click the Start job button to start the job