RudderStack

RudderStack is an open-source Customer Data Infrastructure for collecting and routing customer event data to your preferred data warehouse and dozens of other analytics providers, such as Braze. It is enterprise-ready and offers a robust transformation framework to process your event data on the fly.

RudderStack offers a native SDK integration for your Android, iOS, and web applications, as well as a server-to-server integration for your backend services. This way, you can send your in-app customer event data to Braze directly for contextual analysis.

Setup Overview

Integrating RudderStack with Braze is very quick and easy. All you need to do is follow these steps:

  1. Make sure all the integration prerequisites are followed and adhered to.
  2. Choose your preferred type of integration and configure Braze as a destination in RudderStack.
  3. Set up the required mappings for your integration.

Step 1: Prerequisites

Requirement Origin Access Description
RudderStack Account RudderStack https://app.rudderstack.com/ A RudderStack account is required to set up the RudderStack-Braze integration.
Configured Source RudderStack RudderStack Documentation A source is essentially the origin of any data sent to RudderStack, such as websites, mobile apps, or backend servers. You are required to configure the source before setting up Braze as a destination in RudderStack.
Braze SDK Integration with your device Braze To know more about using the Braze SDKs, refer to our documentation on the web, iOS, and Android platforms. Braze must be set up on your website or app for the integration to be successful.

Step 2: Choose the Type of Integration

You can choose to integrate RudderStack’s web and native client-side libraries with Braze using either a side-by-side (“Device Mode”) integration or a server-to-server (“Cloud Mode”) integration.

Integration Type Description
Side-by-Side / Device Mode RudderStack will send the event data to Braze directly from your client (browser or mobile application).
Server-to-Server / Cloud Mode The Braze SDK sends the event data directly to RudderStack, which is then transformed and routed to Braze.

Step 2.1a: Side-by-Side Integration (Device Mode)

With this mode, you can send your events to Braze using the Braze SDK set up on your website or mobile app.

Set up the mappings to the RudderStack SDK for Android on Braze’s GitHub repository, as described in Step 3.
To complete the Device Mode integration, please refer to the detailed RudderStack instructions for adding Braze to your Android project.

Set up the mappings to the RudderStack SDK for iOS on Braze’s GitHub repository, as described in Step 3.
To complete the Device Mode integration, please refer to the detailed RudderStack instructions for adding Braze to your iOS project.

Set up the mappings to the RudderStack SDK for JavaScript on Braze’s GitHub repository, as described in Step 3.
To learn more about how the web SDK works, please refer to the detailed RudderStack instructions on the JavaScript SDK.

Step 2.1b: Server-to-Server Integration (Cloud Mode)

With this mode, the Braze SDK sends the event data directly to RudderStack. RudderStack then transforms this data and routes it to Braze in the expected format. The transformation is done in the RudderStack backend.

To enable the integration, set up your App Group’s REST API Key and Braze’s REST API endpoint in your Connection Settings (Refer to Step 2.2) on the RudderStack dashboard. You will also need to map the RudderStack methods to Braze (Refer to Step 3).

Step 2.2: Configure Braze Settings in RudderStack

Once you’ve decided on the integration mode and successfully set up the source and the Braze SDK on your device, you will need to configure Braze as a destination in RudderStack. The setup is quite straightforward - you will need to enter the following required fields:

Braze Settings

Name Description
App Key Can be found in the Dashboard under Settings - Manage Settings
REST API Key This needs to be created in the Braze dashboard under Settings - Developer Console - API Settings. You can find the detailed instructions here.
Data Center You will need to enter the Data Center details as provided by Braze. It is of the format INSTANCE, as explained in the Braze Instances guide.
Native SDK You can enable or disable this option to use the Braze native SDK to send the events (use the Device Mode).

Step 3: Using the Integration - Set Up the Mappings

Braze supports the RudderStack methods identify, track, and page.

Identify

The RudderStack identify method associates a user to their actions. RudderStack captures a unique user ID and the optional traits associated with that user, such as name, email, IP address, etc.

The field mapping is done as per the table below:

RudderStack Field Braze Field
firstName first_name
lastName last_name
birthday dob
avatar image_url
address.city home_city
address.country country
gender gender

You can read more about RudderStack’s identify method in their documentation.

Track

RudderStack’s track method captures all the user activities, along with the properties associated with those activities.

You can read more about RudderStack’s track method in their documentation.

Order Completed

On using the RudderStack eCommerce API to call the track method for an event with the name Order Completed, RudderStack sends the products listed in that event to Braze as purchases.

Page

RudderStack’s page method allows you to record your website’s page views. It also captures any other relevant information about that page.

You can read more about RudderStack’s page method in their documentation.

WAS THIS PAGE HELPFUL?
New Stuff!