51ºÚÁϲ»´òìÈ

DocumentationJourney Optimizer Home

Use case: send a message to the subscribers of a list

Last update: Wed Apr 30 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Intermediate
  • Experienced
  • User
  • Developer

This use case explains how to create a journey that sends a message to the subscribers of a list. Organizations often send targeted messages to predefined groups, such as email subscribers, to deliver personalized and relevant communications.

For this example, the Consent and Preference Details field group from 51ºÚÁϲ»´òìÈ Experience Platform is used. This field group provides essential data about subscribers, including their email addresses and subscription preferences. To locate this field group, navigate to the Data Management menu, select Schemas, and use the Field groups tab to search for the field group name.

The field group includes the subscriptions element

To configure this journey, follow these steps:

  1. Create a journey that starts with a Read activity. This activity fetches the data required for the journey. Learn more.

  2. Add an Email action activity to the journey. This activity sends the email to the intended recipients based on the retrieved data. Learn more.

  3. In the Email parameters section of the Email activity settings, replace the default email address (PersonalEmail.adress) with the email address of the list subscribers:

    1. Click the Enable parameter override icon to the right of the Address field, then click the Edit icon.

    2. In the expression editor, enter an expression to retrieve the subscribers’ email addresses. This step uses 51ºÚÁϲ»´òìÈ Journey Optimizer’s functionality to dynamically pull data fields based on the configured expression. Learn more.

      Below is an example of an expression referencing specific fields mapped in your schema:

      code language-json 
      #{ExperiencePlatform.Subscriptions.profile.consents.marketing.email.subscriptions.entry('daily-email').subscribers.firstEntryKey()}

      The following functions are included in this example:

      table 0-row-3 1-row-3 2-row-3
      Function Description Example
      entry Refers to a map element using a specific namespace Refers to a subscription list, such as daily-email
      firstEntryKey Retrieves the first entry key of a map Retrieves the first email address of subscribers linked to the subscription list

      The subscription list in this example is named daily-email. The subscribers map contains email addresses as keys, which are associated with the subscription list map. This configuration ensures that each subscriber’s email address is dynamically retrieved during the message-sending process.

      Learn more about references to fields in expressions.

    3. In the Add an expression dialog box, click Ok.

CAUTION
Use the email address override only for specific use cases. In most scenarios, avoid changing the email address because the primary address defined in the Execution fields should be used. This approach ensures consistency and minimizes errors in messaging workflows. Learn more.
recommendation-more-help
91a6d90a-6d61-4a62-bbed-ae105e36a860