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.
Integrating RudderStack with Braze is very quick and easy. All you need to do is follow these steps:
- Make sure all the integration prerequisites are followed and adhered to.
- Choose your preferred type of integration and configure Braze as a destination in RudderStack.
- Set up the required mappings for your integration.
Step 1: Prerequisites
|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.
|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.|
Learn more about RudderStack’s connection modes and the benefits of each here.
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.
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).
All of RudderStack’s server-side SDKs (Java, Python, Node.js, Go, Ruby) support only Cloud Mode. This is because their server-side SDKs operate in the RudderStack backend, and cannot load any Braze-specific SDK.
The server-to-server integration does not support Braze’s UI features, such as push notifications or in-app messaging. These features are, however, supported by the Device Mode integration.
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:
|App Key||Can be found in the Developer Console under App Settings - Manage App Group|
|REST API Key||This needs to be created in the Braze dashboard under App 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
|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
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|
All other traits will be recorded as custom attributes.
You can read more about RudderStack’s identify method in their documentation.
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.
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.