Documentation / Product / Integrations / Dotdigital

Dotdigital: Export Contacts Multi Segment

Export multiple Lytics audiences to existing Dotdigital address books, 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:

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 in multiple segments from Dotdigital into Lytics.

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

  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 Multi Segment from the list of workflows.
  4. Select the Authorization you would like to use.
  5. From the Audience input, select which Lytics Audience(s) to export to Dotdigital.
  6. From the Map Audiences input, map all Lytics Audiences to Dotdigital address books by selecting the Lytics audience on the left, and its Dotdigital destination on the right.
  7. From the Email Field input, select the field that contains the contact's email.
  8. From the ID Field input, select the field that contains the contact's Dotdigital ID. This may be a map field if importing users from multiple accounts.
  9. Select the One Time checkbox to do a one time export of the selected audiences.
  10. Click on the Show Advanced Options tab to expand the advanced configuration.
  11. From the Opt-in Type drop-down, select the opt-in type for the contacts that will be created. See the Dotdigital documentation for details.
  12. From the Email Type input, select the type of emails these contacts can receive.
  13. From the Map Fields , 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.
  14. From the Exit Action drop-down, select the action to take when an entity exits the segment. Note: unsubscribing will significantly increase API usage.
  15. 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.
  16. 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.
  17. 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.
  18. If the Sync Status checkbox is selected, then contact's address book status will be updated in Lytics.
  19. In the Work Tracking Slug box, enter a slug to use to track the work. This slug should be unique.
  20. Click the Start Export button to start the work.

Dotdigital Export Multi Segment Workflow