Documentation / Product / Integrations / Dotdigital

Dotdigital: Export Modified Contacts

Use the Export Modified Contacts job type to keep your contacts' data fields up to date in Dotdigital.

Integration Details

This integration utilizes the Dotdigital APIs to send user data. Once the export is started the job will:

  1. Scan user profiles in the selected audience.
  2. Convert user profiles to Dotdigital contacts.
  3. Upload batches of contacts (up to 5000 contacts per batch) to Dotdigital.
  4. Sleep until the next scheduled export.

Fields

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

NOTE: Dotmailer rebranded to Dotdigital in January 2019. Due to backwards compatiblity issues old field and stream names still use dotmailer.

Source FieldLytics User FieldDescriptionType
emailemail unique idEmailstring
account_id, account_statusdm_account_statusStatus by Dotmailer Account IDmap[string]string
account_id, address_book_id, address_book_statusdm_addressbook_statusStatus by Dotmailer Addressbook IDmap[string]string
epochms()dm_addressbook_status_tsDate of Last Dotmailer Addressbook Status Updatedate

Configuration

Follow these steps to set up an export of modified contacts job for Dotdigital. If you are new to creating jobs in Lytics, see the Jobs Dashboard documentation for more information.

  1. Select Dotdigital from the list of providers.
  2. Select the Export Modified Contacts 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. Select the audience to export.
  7. Select the Email Field that contains the contact's email.
  8. Select the ID Field that contains the contact's Dotdigital ID.
  9. Select the Modified Field that contains the last modified time.
  10. Select the Content Collection to include recommendations from Lytics. If not selected, no recommendations are sent to Dotdigital.
  11. (Optional) Toggle Show Advanced Options.
    1. Select the Opt-in Type to configure the opt-in type for the contacts that will be created. See Dotdigital's documentation for details.
    2. Select the Email Type to configure the type of emails these contacts can receive.
    3. Select the Map Fields to map all the fields from Lytics to Dotdigital by selecting the Lytics field on the left, and its Dotdigital destination on the right. NOTE: Non scalar fields such as arrays and maps are not supported by Dotdigital.
    4. Select the Map Recommendation Fields to map all the recommender fields from Lytics to Dotdigital by selecting the Lytics field on the left, and its Dotdigital destination on the right. NOTE: Complex fields such as sets and maps are not supported by Dotdigital. This field is required if a Content Collection is set.
    5. Select Keep Updated to run this export continuously.
    6. Select the File Export Frequency to configure how often a continuous export should export a new file. The default is daily.
    7. Select the Time of Day to configure what time of day a daily, weekly, or monthly export should export. The default is midnight.
    8. Select the Timezone to configure the timezone for the Time of Day.
    9. Enter a Work Tracking Slug to track the work. This slug should be a unique value.
  12. Click Start Export.

Dotdigital Export Modified Contacts Workflow