Documentation / Product / Integrations / Cordial

Cordial: Import Activity

Import contact activity data from Cordial to build targeted audiences in Lytics.

Integration Details

This integration utilizes the Cordial Activity Export API to import contact activity data to Lytics. On each run of the job, it will:

  1. Create the Contact Activity export job in Cordial to export activity (message-, open, click, opt-out, bounce, complaint, custom) data to a file in SFTP server.
  2. Import the data from the exported file to Lytics in the cordial_activity stream.
  3. Repeats step 1 and 2 every 6 hours.


The following fields are included in the default mapping for the cordial_activity stream.

Source FieldLytics User FieldDescriptionType
cIDcr_contact_id unique idCordial Contact IDstring
firstcr_firstCordial Unique Eventboolean
_idcr_system_event_idCordial System Event IDstring
mcIDcr_message_contact_idCordial Message Contact IDstring
message_namecr_message_nameCordial Unique Eventstring
message_sentcr_message_sent_timestampCordial Message Sent Timestampdate
actioncr_event_actionCordial Event Actionstring
timecr_event_timestampCordial Event Timestampdate


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

  1. Select Cordial from the list of providers.
  2. Select Import Activity 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) In the Import Since text box, enter events after this date will be imported. The date format should be yyyy-mm-dd, for example, 2019-03-27. If left empty, activity data from the last 7 days will be imported.
  7. Click Start Import. cordial-import