Loading

Use Journey Data or Contact Data in a Journey Builder Update Contact Activity

Date de publication: Jan 27, 2025
Description
The Update Contact Activity within Journey Builder can be a powerful tool for updating Data Extensions with specific data when a contact reaches the particular activity. Common scenarios can be found in our Help Documentation. In addition to static values provided within the Update Contact configuration wizard, users can extend their data to use Journey Data or Contact Data using Data Binding.
Résolution

Journey Data

Journey Data is a snapshot of a contact's data from the Entry Event's Data Extension at the time of entry into the Journey. This data never changes and persists with a contact for the duration of a contact's existence through a journey. This data can be used in the Update Contact activity and follows the below format.
 
{{Event.EventKey.FieldName}}


For API Events, the Event Key is specified on the Entry Event's Overview page.

Sample/Example Binding Expression for API Event Journey:

"{{Event.APIEvent-645f4e45-e4b7-379d-8ccc-e44551c315f4."Email"}}"

For any other event, you will need to find the Event Key using other means.


NOTE: Data Binding Expressions are case-sensitive. Be mindful of space in the field of the Data extension, as Data Binding may fail due to the presence of space. 

Obtain Event Key

One of the two methods to obtain the Event Key below are required in order to configure the Update Contact Activity with Journey Data values.

 

Journey Settings UI Method

  1. Configure an Entry Event within a Journey to Completion
  2. Save the Journey
  3. Navigate to the Journey Settings page (gear icon)
  4. If the Default Email Address or Default Mobile Number populates with a value, meaning your entry source Data Extension contains a proper field type, right-click on the value and "Inspect"
  5. In your browser's developer tools, you should see an unordered list, abbreviated "ul"
  6. Open this list and you should see an entry that contains something similar to "{{Event.DEAudience-645f4e45-e4b7-379d-8ccc-e44551c315f4."Email"}}". Use Ctrl + F to search for "Event.DE" if you have issues finding the relevant details.
  7. Copy this value, this is the EventKey you will use for the Update Contact Activity Configuration.

Journey Builder API Method

  1. Configure an Entry Event within a Journey to Completion
  2. Give the Journey a Unique Name
  3. Save the Journey
  4. Make a GET call to the /interaction/v1/eventDefinitions route with a query string parameter for "name"
  5. E.G GET  /interaction/v1/eventDefinitions?name=JourneyBuilderTest
  6. In the results, look for the specific Journey you created
  7. Find the eventDefinitionKey value and note it for later use for the Update Contact Activity Configuration.


 

Now that you have obtained the Event Key for the Journey in question, follow the steps below to use it within an Update Contact Activity. 

Configure Update Contact Activity

  1. Drag Update Contact Activity onto the canvas
  2. Select the Data Extension you want to log the data to
  3. Select the Attribute you want to update
  4. In the Value field enter the Data Binding Expression, e.g. {{Event.DEAudience-645f4e45-e4b7-379d-8ccc-e44551c315f4."Email"}}
  5. Click Summary, Done
  6. Configure the rest of the Journey and Activate it. When a contact reaches this activity, the data extension should be updated with the value from the entry event data extension.

 

 

Contact Data

Contact Data is point-in-time data related to a particular Contact. This data is configured within Contact Builder's Data Designer feature. To use this data in an Update Contact Activity, use the format below.
 
{{Contact.Attribute.DataExtension.FieldName}}
Example: I have a Data Extension named "ContactInfo" linked in the Attribute Group called "Contact Info Attribute Group". In this Data Extension, I want to use a field named "FavoriteColor" to update another Data Extension. I would follow the below steps to accomplish this task.
  1. Drag Update Contact Activity onto the canvas
  2. Select the Data Extension you want to log the data to
  3. Select the Attribute you want to update
  4. In the value field, enter {{Contact.Attribute.ContactInfo.FavoriteColor}}
  5. Click Summary, Done
  6. Configure the rest of the Journey and Activate it. When a contact reaches this activity, the target data extension should be updated with the value from the Data Extension at the time the contact reached this activity.


Note: If multiple paths exist to the Data Extension within Data Designer, the shortest path will be chosen. If multiple shortest paths exist, the system will arbitrarily choose one. A contact must exist in all linked data extensions in order for the attribute to be successfully retrieved. To simplify this process, only use data extensions linked directly to ContactKey. If no contact key can be found, the activity will update the field value with an empty string. 
Numéro d’article de la base de connaissances

000390236

 
Chargement
Salesforce Help | Article