Documentation / Product / Integrations / Salesforce / Salesforce Marketing Cloud

Salesforce Marketing Cloud: Export Lists

This workflow allows you to sync Lytics audiences and profile data in real-time to Salesforce Marketing Cloud for targeting your email communications.

Integration Details

This integration utilizes the Marketing Cloud SOAP API to send user data. Once the export is started the workflow will:

  1. If the Existing Users option is selected (see below), the workflow will generate enter events for every user in the Lytics audience. After these are processed via steps 2-4 below, the workflow will listen for enter/exit events and process them accordingly.
  2. Ensure the user has an email field.
  3. Package the user as a Marketing Cloud Subscriber. If fields are mapped (see step 8 of Configuration), they are added to the subscriber as attributes.
  4. If it's an enter event, the user is added to the list using a SOAP "CREATE" method. If the user already exists, it will be added to the list and updated with the mapped fields.
  5. If it's an exit event, one of the following will occur:

    • If the Unsubscribe on Exit option is NOT selected, the event will be ignored.
    • If the Unsubscribe on Exit option is selected, the user will be unsubscribed from the list via the process described here.

Fields

By default, Lytics exports the following field to Salesforce Marketing Cloud for the Export Lists workflow.

Lytics User FieldDescriptionSFMC FieldType
emailEmail AddressEmailstring

Configuration

Follow these steps to set up and configure an export of lists to Salesforce Marketing Cloud from the Lytics platform.

  1. Navigate to the Integrations section and select Salesforce Marketing Cloud. sfmc-logo
  2. Select Workflows from the menu on the left.
  3. Select Export Lists from the list of Workflows.
  4. Select the authorization you would like to use.
  5. From the Audience dropdown, choose the Lytics audience to send to Marketing Cloud.
  6. From the Email Field dropdown, select the field that has the user's email.
  7. From the List to Update input, select the Marketing Cloud list to update. If none is selected, a new list will be created with the form lytics_{audience_name}.
  8. From the Map Fields, select all the fields to send to Marketing Cloud by mapping the Lytics user profile field on the left to the Marketing Cloud field on the right.
  9. (Optional) From the Subscriber Key Field input, select the Lytics field containing the subscriber key for the exported list. It allows multiple Marketing Cloud subscribers to have the same email address.
  10. (Optional) Select the Existing Users checkbox to immediately push users who currently exist in the selected Lytics audience. Deselecting will only push users as they enter or exit the audience.
  11. (Optional) Select the Unsubscribe on Exit checkbox to unsubscribe a user from the list when they exit the Lytics audience. Deselecting will ignore exit events
  12. Click Start Export. sfmc export lists configuration