[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 ۶Ƶ Experience Platform in the UI.
Prerequisites
In order to complete the steps in this guide, you will need:
- A login to and permission to create a new streaming source connection.
- A login to your , an unused , and permissions to create a connector. For more information, read the .
Getting started
This tutorial requires a working understanding of the following components of ۶Ƶ Experience Platform:
-
Experience Data Model (XDM) System: The standardized framework by which Experience Platform organizes customer experience data.
- Basics of schema composition: Learn about the basic building blocks of XDM schemas, including key principles and best practices in schema composition.
- Schema Editor tutorial: Learn how to create custom schemas using the Schema Editor UI.
-
Real-Time Customer Profile: Provides a unified, real-time consumer profile based on aggregated data from multiple sources.
This tutorial also requires a working understanding of .
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 . 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.
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 .
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.