۶Ƶ

[Beta]{class="badge informative"}

Create a Braze Currents source connection in the UI

NOTE
The Braze Currents source is in beta. Please read the sources overview for more information on using beta-labeled sources.

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:

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

TIP
You must create an Experience Data Model (XDM) schema if this is your first time creating a Braze Currents connection. If you have already created a schema for Braze Currents, then you may skip this step and proceed to connecting your account to Experience Platform.

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.

A completed schema.

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.

The sources catalog on the Experience Platform UI with the Braze Currents source selected.

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

The "Add Data" screen.

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.
The "Dataflow Details" screen highlighting "Dataset details."

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

The "Mapping" screen.

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.
Creating a calculated field for timestamp

The mapping with no 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 .

Field
Description
Client ID
The client ID associated with your Experience Platform source.
Client Secret
The client secret associated with your Experience Platform source.
Tenant ID
The tenant ID associated with your Experience Platform source.
Sandbox Name
The sandbox associated with your Experience Platform source.
Dataflow ID
The dataflow ID associated with your Experience Platform source.
Streaming Endpoint
The streaming endpoint associated with your Experience Platform source. Note: Braze automatically converts this to the batch streaming endpoint.

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.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089