Documentation / Product / Integrations / Dotdigital

Dotdigital: Export Contacts

Export Lytics audiences to a Dotdigital Engagement Cloud address book, which can then be used for campaigns using any of Dotdigital's supported channels.

Integration Details

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

  1. Request the Dotdigital account information.
  2. Get all address books in the account.
  3. Verify the selected address book exists, or create a new address book if configured to do so.
  4. For each user entering the Lytics audience, or existing member of the audience, (depending on Trigger Join Actions setting) either:
  5. If the user is unsubscribed, try to resubscribe them to the address book, or resubscribe with no challenge, if configured to resubscribe.
  6. For each user exiting the Lytics audience, one of three actions can be selected:
  7. Update the user's Dotdigital status via the dotmailer_export_status stream if Sync Status is selected.

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 and configure an export of contacts to Dotdigital from Lytics.

  1. Navigate to the Integrations page and select the Dotdigital tile. Dotdigital Logo
  2. Select Workflows from the menu on the left.
  3. Select Export Contacts from the list of workflows.
  4. Select the Authorization you would like to use.
  5. From the Audience drop-down, select the audience of users to export to Dotdigital.
  6. From the Existing Address Book drop-down, select the address book to add contacts to. If you want to create a new address book enter the name in the New Address Book Name field below.
  7. From the New Address Book Name box, enter a new address book name to be created in Dotdigital. If left blank, it will default to 'Lytics + audience name'. NOTE: this will only be used if the 'Existing Address Book' is left blank.
  8. From the Email Field drop-down, select the field that contains the contact's email.
  9. From the ID Field drop-down, select the field that contains the contact's Dotdigital ID. This may be a map field if importing users from multiple accounts.
  10. If the One Time checkbox is selected, the export will do a one time export of the audience.
  11. Click on the Show Advanced Options tab to expand the advanced configuration.
  12. From the Address Book Status Field drop-down, select the field that contains the address book status. This will also sync address book status in Lytics. Any address books with a status of 'syncing' will be added to Dotdigital. Note: This will ignore both the 'New Address Book Name' and the 'Existing Address Book' fields.
  13. From the Opt-in Type drop-down, select the opt-in type for the contacts that will be created. See Dotdigital's documentation for details.
  14. From the Email Type drop-down, select the type of emails these contacts can receive.
  15. From the Map Fields input, 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.
  16. From the Exit Action drop-down, select the action to take when an entity exits the segment. Note: unsubscribing will significantly increase API usage.
  17. If the Trigger Join Actions checkbox is selected, contacts will trigger join actions when added to the address book. Note: this will significantly increase API usage.
  18. If the Resubscribe checkbox is selected, contacts will be resubscribed to address books. Address-book level resubscribes are only supported for exports triggering join actions. Bulk exports will only resubscribe contacts if they have been suppressed at the account level.
  19. If the Resubscribe With No Challenge checkbox is selected, then contacts will be resubscribed to address books without triggering a confirmation email. Address-book level resubscribes are only supported for exports triggering join actions. Bulk exports will only resubscribe contacts if they have been suppressed at the account level.
  20. If the Sync Status checkbox is selected, then the contact's address book status will be updated in Lytics.
  21. From the Disable Deduplication checkbox, selecting this will disable deduplication of events.
  22. In the Work Tracking Slug box, enter a slug to use to track the work. This slug should be unique.
  23. Click the Start Export button to start the work.

Dotdigital Export Contact Workflow