Skip to content

Commit 9f95361

Browse files
bre-fitzgeraldbre-fitzgerald
authored
Merge pull request #4933 from braze-inc/kh/rudderstack1
2 parents a1bf180 + 0f080bc commit 9f95361

File tree

3 files changed

+164
-98
lines changed

3 files changed

+164
-98
lines changed

‎_docs/_partners/data_and_infrastructure_agility/customer_data_platform/rudderstack.md

Lines changed: 15 additions & 98 deletions
Original file line numberDiff line numberDiff line change
@@ -1,105 +1,22 @@
11
---
22
nav_title: RudderStack
3-
article_title: RudderStack
3+
noindex: true
4+
alias: /partners/RudderStack/
45
page_order: 3
5-
description: "This article outlines the partnership between Braze and RudderStack, an open-source customer data infrastructure that offers a seamless Braze integration for your Android, iOS, and web applications. With RudderStack, you can now send your in-app customer event data directly to Braze for contextual analysis."
6-
alias: /partners/rudderstack/
7-
page_type: partner
8-
search_tag: Partner
6+
layout: featured
7+
guide_top_header: "RudderStack"
8+
guide_top_text: "RudderStack makes it simple for data engineers to empower every part of their organization with rich customer data. With RudderStack you can turn your own data warehouse into fully-featured customer data without having to worry about plumbing the pipeline, security, or sudden spikes in cost due to volume. Supercharge marketing, sales, and product teams by sending data to every type of tool, from email to product analytics."
99

10-
---
11-
12-
# RudderStack
13-
14-
> [RudderStack][1] 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.
15-
16-
The Braze and RudderStack integration offers a native SDK integration for your Android, iOS, and web applications, as well as a server-to-server integration from your backend services.
17-
18-
## Prerequisites
19-
20-
| Requirement | Description |
21-
| --- | --- |
22-
| RudderStack account | A [RudderStack account](https://app.rudderstack.com/) is required to take advantage of this partnership. |
23-
| Configured source | A [source][3] 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. |
24-
| Braze REST API key | A Braze REST API key with `users.track`, `users.identify`, and `users.alias.new` permissions.<br><br>This can be created within the **Braze Dashboard > Developer Console > REST API Key > Create New API Key**. |
25-
| Braze app key | To get your app key, navigate to **Braze Dashboard > Developer Console > Identification** and find your app name. Save the associated identifier string.
26-
| Data center | Your data center aligns with your Braze dashboard [instance][15]. |
27-
{: .reset-td-br-1 .reset-td-br-2 .reset-td-br-3 .reset-td-br-4}
28-
29-
## Integration
30-
31-
### Step 1: Add a source
32-
33-
To start sending data to Braze, you first need to make sure a source is set up in your RudderStack app. Visit [RudderStack][22] to learn how to set up your data source.
34-
35-
### Step 2: Configure destination
36-
37-
Now that you have your data source set up, in the RudderStack dashboard, select **ADD DESTINATION** under **Destinations**. From the list of available destinations, select **Braze**and click **Next**.
38-
39-
In the Braze destination, provide the app key, Braze REST API key, data cluster, and native SDK option (device mode only). The native SDK option will use the Braze native SDK to send events if toggled on.
40-
41-
![][0]{: style="max-width:40%;margin-bottom:15px;"}
42-
43-
## Step 3: Choose the type of integration
44-
45-
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.
46-
47-
- Integration type
48-
- [Side-by-Side / Device Mode](#device-mode): RudderStack will send the event data to Braze directly from your client (browser or mobile application).
49-
- [Server-to-Server / Cloud Mode](#cloud-mode): The Braze SDK sends the event data directly to RudderStack, which is then transformed and routed to Braze.
50-
51-
{% alert note %}
52-
Learn more about RudderStack's [connection modes](https://rudderstack.com/docs/connections/rudderstack-connection-modes/) and the benefits of each.
53-
{% endalert %}
54-
55-
### Step 3a: Side-by-side integration (device mode) {#device-mode}
10+
description: "RudderStack makes it simple for data engineers to empower every part of their organization with rich customer data. With RudderStack, you can turn your own data warehouse into fully-featured customer data without having to worry about plumbing the pipeline, security, or sudden spikes in cost due to volume."
5611

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

59-
Set up the mappings to the RudderStack SDK for [Android](https://github.com/rudderlabs/rudder-integration-braze-android), [iOS](https://github.com/rudderlabs/rudder-integration-braze-ios), or [React Native] on Braze's GitHub repository, as described in step 4.
60-
61-
To complete the device mode integration, refer to the detailed RudderStack instructions for [adding Braze to your project](https://rudderstack.com/docs/destinations/marketing/braze/#adding-device-mode-integration).
62-
63-
### Step 3b: Server-to-server integration (cloud mode) {#cloud-mode}
64-
65-
In this mode, the SDK sends the event data directly to the RudderStack server. RudderStack then transforms this data and routes it to the desired destination. This transformation is done in the RudderStack backend, using RudderStack's Transformer module.
66-
67-
To enable the integration, you will need to map the RudderStack methods to Braze, as described in step 4.
68-
69-
{% alert note %}
70-
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.
71-
{% endalert %}
72-
73-
{% alert important %} 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.
74-
{% endalert %}
75-
76-
## Step 4: SDK methods
77-
78-
Braze supports the RudderStack methods identify, track, page, and group.
79-
80-
### Identify
81-
82-
The RudderStack [`identify` method](https://rudderstack.com/docs/destinations/marketing/braze/#identify) associates a user to their actions. RudderStack captures a unique user ID and optional traits associated with that user, such as name, email, IP address, etc.
83-
84-
### Track
85-
86-
RudderStack's [`track` method](https://rudderstack.com/docs/destinations/marketing/braze/#track) captures all the user activities, along with the properties associated with those activities.
87-
88-
**Order completed**<br>
89-
On using the [RudderStack eCommerce API][20] 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`][21].
90-
91-
### Page
92-
93-
RudderStack's [`page` method](https://rudderstack.com/docs/destinations/marketing/braze/#page) allows you to record your website's page views. It also captures any other relevant information about that page.
94-
95-
### Group
96-
97-
RudderStack's [`group` method](https://rudderstack.com/docs/destinations/marketing/braze/#group) allows you to associate a user with a group.
13+
guide_featured_list:
14+
- name: RudderStack
15+
link: /docs/partners/data_and_infrastructure_agility/customer_data_platform/rudderstack/rudderstack
16+
fa_icon: fas fa-user-circle
17+
- name: RudderStack for Currents
18+
link: /docs/partners/data_and_infrastructure_agility/customer_data_platform/rudderstack/rudderstack_for_currents/
19+
fa_icon: fas fa-warehouse
20+
---
9821

99-
[0]: {% image_buster /assets/img/RudderStack/braze_settings.png %}
100-
[1]: https://rudderstack.com/
101-
[3]: https://docs.rudderstack.com/how-to-guides/adding-source-and-destination-rudderstack
102-
[15]: {{site.baseurl}}/user_guide/administrative/access_braze/braze_instances/
103-
[20]: https://docs.rudderstack.com/rudderstack-api-spec/rudderstack-ecommerce-events-specification
104-
[21]: {{site.baseurl}}/user_guide/data_and_analytics/export_braze_data/exporting_revenue_data/#revenue-data
105-
[22]: https://www.rudderstack.com/docs/destinations/streaming-destinations/braze/#getting-started
22+
<br>

‎_docs/_partners/data_and_infrastructure_agility/customer_data_platform/rudderstack/rudderstack.md

Lines changed: 103 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,103 @@
1+
---
2+
nav_title: RudderStack
3+
article_title: RudderStack
4+
description: "This article outlines the partnership between Braze and RudderStack, an open-source customer data infrastructure that offers a seamless Braze integration for your Android, iOS, and web applications. With RudderStack, you can now send your in-app customer event data directly to Braze for contextual analysis."
5+
page_type: partner
6+
search_tag: Partner
7+
8+
---
9+
10+
# RudderStack
11+
12+
> [RudderStack][1] 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.
13+
14+
The Braze and RudderStack integration offers a native SDK integration for your Android, iOS, and web applications, as well as a server-to-server integration from your backend services.
15+
16+
## Prerequisites
17+
18+
| Requirement | Description |
19+
| --- | --- |
20+
| RudderStack account | A [RudderStack account](https://app.rudderstack.com/) is required to take advantage of this partnership. |
21+
| Configured source | A [source][3] 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. |
22+
| Braze REST API key | A Braze REST API key with `users.track`, `users.identify`, and `users.alias.new` permissions.<br><br>This can be created within the **Braze Dashboard > Developer Console > REST API Key > Create New API Key**. |
23+
| Braze app key | To get your app key, navigate to **Braze Dashboard > Developer Console > Identification** and find your app name. Save the associated identifier string.
24+
| Data center | Your data center aligns with your Braze dashboard [instance][15]. |
25+
{: .reset-td-br-1 .reset-td-br-2 .reset-td-br-3 .reset-td-br-4}
26+
27+
## Integration
28+
29+
### Step 1: Add a source
30+
31+
To start sending data to Braze, you first need to make sure a source is set up in your RudderStack app. Visit [RudderStack][22] to learn how to set up your data source.
32+
33+
### Step 2: Configure destination
34+
35+
Now that you have your data source set up, in the RudderStack dashboard, select **ADD DESTINATION** under **Destinations**. From the list of available destinations, select **Braze** and click **Next**.
36+
37+
In the Braze destination, provide the app key, Braze REST API key, data cluster, and native SDK option (device mode only). The native SDK option will use the Braze native SDK to send events if toggled on.
38+
39+
![][0]{: style="max-width:40%;margin-bottom:15px;"}
40+
41+
## Step 3: Choose the type of integration
42+
43+
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.
44+
45+
- Integration type
46+
- [Side-by-side / device mode](#device-mode): RudderStack will send the event data to Braze directly from your client (browser or mobile application).
47+
- [Server-to-server / cloud mode](#cloud-mode): The Braze SDK sends the event data directly to RudderStack, which is then transformed and routed to Braze.
48+
49+
{% alert note %}
50+
Learn more about RudderStack's [connection modes](https://www.rudderstack.com/docs/destinations/rudderstack-connection-modes/) and the benefits of each.
51+
{% endalert %}
52+
53+
### Step 3a: Side-by-side integration (device mode) {#device-mode}
54+
55+
With this mode, you can send your events to Braze using the Braze SDK set up on your website or mobile app.
56+
57+
Set up the mappings to the RudderStack SDK for [Android](https://github.com/rudderlabs/rudder-integration-braze-android), [iOS](https://github.com/rudderlabs/rudder-integration-braze-ios), or [React Native] on Braze's GitHub repository, as described in step 4.
58+
59+
To complete the device mode integration, refer to the detailed RudderStack instructions for [adding Braze to your project](https://rudderstack.com/docs/destinations/marketing/braze/#adding-device-mode-integration).
60+
61+
### Step 3b: Server-to-server integration (cloud mode) {#cloud-mode}
62+
63+
In this mode, the SDK sends the event data directly to the RudderStack server. RudderStack then transforms this data and routes it to the desired destination. This transformation is done in the RudderStack backend, using RudderStack's Transformer module.
64+
65+
To enable the integration, you will need to map the RudderStack methods to Braze, as described in step 4.
66+
67+
{% alert note %}
68+
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.
69+
{% endalert %}
70+
71+
{% alert important %} 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.
72+
{% endalert %}
73+
74+
## Step 4: SDK methods
75+
76+
Braze supports the RudderStack methods identify, track, page, and group.
77+
78+
### Identify
79+
80+
The RudderStack [`identify` method](https://rudderstack.com/docs/destinations/marketing/braze/#identify) associates a user to their actions. RudderStack captures a unique user ID and optional traits associated with that user, such as name, email, IP address, etc.
81+
82+
### Track
83+
84+
RudderStack's [`track` method](https://rudderstack.com/docs/destinations/marketing/braze/#track) captures all the user activities, along with the properties associated with those activities.
85+
86+
**Order completed**<br>
87+
On using the [RudderStack eCommerce API][20] 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`][21].
88+
89+
### Page
90+
91+
RudderStack's [`page` method](https://rudderstack.com/docs/destinations/marketing/braze/#page) allows you to record your website's page views. It also captures any other relevant information about that page.
92+
93+
### Group
94+
95+
RudderStack's [`group` method](https://rudderstack.com/docs/destinations/marketing/braze/#group) allows you to associate a user with a group.
96+
97+
[0]: {% image_buster /assets/img/RudderStack/braze_settings.png %}
98+
[1]: https://rudderstack.com/
99+
[3]: https://docs.rudderstack.com/how-to-guides/adding-source-and-destination-rudderstack
100+
[15]: {{site.baseurl}}/user_guide/administrative/access_braze/braze_instances/
101+
[20]: https://docs.rudderstack.com/rudderstack-api-spec/rudderstack-ecommerce-events-specification
102+
[21]: {{site.baseurl}}/user_guide/data_and_analytics/export_braze_data/exporting_revenue_data/#revenue-data
103+
[22]: https://www.rudderstack.com/docs/destinations/streaming-destinations/braze/#getting-started

‎_docs/_partners/data_and_infrastructure_agility/customer_data_platform/rudderstack/rudderstack_for_currents.md

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
---
2+
nav_title: RudderStack for Currents
3+
article_title: RudderStack for Currents
4+
description: "This article outlines the partnership between Braze Currents and RudderStack, an open-source customer data infrastructure that offers a seamless Braze integration for your Android, iOS, and web applications."
5+
page_type: partner
6+
tool: Currents
7+
search_tag: Partner
8+
9+
---
10+
11+
# RudderStack for Currents
12+
13+
> [RudderStack](https://www.rudderstack.com/) enables you to collect, transform, and activate your customer data across your stack, leveraging your cloud data warehouse as the central source of truth. This article gives an overview of how to set up a connection between Braze Currents and RudderStack.
14+
15+
The Braze and RudderStack integration allows you to leverage Braze Currents to export your Braze events to RudderStack to drive deeper analytics.
16+
17+
## Prerequisites
18+
19+
| Requirement | Description |
20+
| --- | --- |
21+
| RudderStack account | A [RudderStack account](https://app.rudderstack.com/login) is required to take advantage of this partnership. |
22+
| Braze destination | We suggest having [set up Braze as a destination]({{site.baseurl}}/partners/data_and_infrastructure_agility/customer_data_platform/rudderstack/rudderstack/#integration) in RudderStack. |
23+
| Currents | To export data back into mParticle, you need to have [Braze Currents]({{site.baseurl}}/user_guide/data_and_analytics/braze_currents/#access-currents) set up for your account. |
24+
{: .reset-td-br-1 .reset-td-br-2}
25+
26+
## Integration
27+
28+
### Step 1: Create a data source for Braze within RudderStack
29+
30+
First, you must create a Braze source on the RudderStack web app. Instructions for creating a data source can be found on the [RudderStack](https://www.rudderstack.com/docs/sources/event-streams/cloud-apps/braze-currents/) site.
31+
32+
Once completed, RudderStack will provide a webhook URL, including the write key, which you will need to use in the next step. You can find the webhook URL in the **Settings** tab of your Braze source.
33+
34+
### Step 2: Create Current
35+
36+
In Braze, navigate to **Currents > + Create Current > RudderStack Export**. Provide an integration name, contact email, RudderStack webhook URL (which goes in the key field), and RudderStack region.
37+
38+
### Step 3: Export events
39+
40+
Next, select the events you would like to export. Lastly, click **Launch Current**
41+
42+
All events sent to RudderStack will include the user’s `external_user_id`. At this time, Braze does not send event data to RudderStack for users who do not have their `external_user_id` set.
43+
44+
## Integration details
45+
46+
Braze supports exporting all data listed in the [Currents event glossaries]({{site.baseurl}}/user_guide/data_and_analytics/braze_currents) to RudderStack.

0 commit comments

Comments
 (0)