[Beta]{class="badge informative"}

Create a Braze Currents source connection in the UI

Braze powers customer-centric interactions between consumers and brands in real-time. Braze Currents is a real-time data stream of engagement events from the Braze platform that is the most robust yet granular export out of the Braze platform.

Read the following tutorial to learn how to bring engagement events data from your Braze account to Adobe Experience Platform in the UI.

Prerequisites

In order to complete the steps in this guide, you will need:

Getting started

This tutorial requires a working understanding of the following components of Adobe Experience Platform:

This tutorial also requires a working understanding of Braze Currents.

If you already have a Braze connection, you may skip the remainder of this document and proceed to the tutorial on configuring a dataflow.

Create an XDM schema

In the Platform UI, use the left navigation and then select Schemas to access the Schemas workspace. Next, select Create schema, and then select Experience Event. To proceed, select Next.

Provide a name and description for your schema. Then, use the Composition panel to configure your schema attributes. Under Field groups, select Add and add the Braze Currents User Event field group. When finished, select Save.

For more information on schemas, read the guide to creating schemas in the UI.

Connect your Braze account to Experience Platform connect

In the Platform UI, select Sources from the left navigation to access the Sources workspace. You can select the appropriate category from the catalog on the left-hand side of your screen. Alternatively, you can find the specific source you wish to work with using the search option.

Under the Marketing Automation category, select Braze Currents, and then select Add data.

Next, upload the provided Braze Currents sample file. This file contains all possible the fields that Braze might send as part of an event.

Once your file is uploaded, you must provide your dataflow details, including information on your dataset and the schema that you are mapping to. If this is your first time connecting a Braze Currents source, then create a new dataset. Otherwise you can use any existing dataset that references the Braze schema. If creating a new dataset, use the schema that we created in the previous section.

Then, configure mapping for your data using the mapping interface.

The mapping will have the following issues that need to be resolved.

In the source data, id will be incorrectly mapped to _braze.appID. You must change the target mapping field to _id at the root level of the schema. Next, ensure that properties.is_amp is mapped to _braze.messaging.email.isAMP.

Next, delete the time to timestamp mapping, then select the add (+) icon and then select Add calculated field. In the provided box, input time * 1000 and select Save.

Once the new calculated field is added, select Map target field next to the new source field and map it to timestamp at the root level of the schema. You should then select Validate to ensure that you have no more errors.

IMPORTANT

Braze timestamps are not expressed in milliseconds, but rather in seconds. In order for the timestamps in Experience Platform to be accurately reflected, you need to create calculated fields in milliseconds. A calculation of “time * 1000” will properly convert to milliseconds, suitable for mapping to a timestamp field within Experience Platform.

When finished, select Next. Use the review page to confirm the details of your dataflow and then select Finish.

Gather required credentials

Once your connection is created, you must collect the following credential values, which you will then provide in the Braze Dashboard to send data to Experience Platform. For more information, read the Braze guide on navigating to Currents.

Configure Braze Currents to stream data to your data source

Within the Braze Dashboard, navigate to Partner Integrations -> Data Export, then select Create New Current. You will be prompted to provide a name for the connector, contact information for notifications about the connector, and the credentials listed above. Select the events you wish to receive, optionally configure any desired field exclusions/transformations, and then select Launch Current.

Next steps

By following this tutorial, you have established a connection to your Braze account. You can now continue on to the next tutorial and configure a dataflow to bring marketing automation system data into Platform.