Braze is a customer engagement platform that helps you better understand your customers' in-app behavior and use the insights to improve your users' app experience.

Find the open-source transformer code for this destination in the GitHub repository.

Getting started

RudderStack supports sending event data to Braze via the following connection modes:

Once you have confirmed that the source platform supports sending events to Braze, follow these steps:

1. From your RudderStack dashboard, add a source. Then, from the list of destinations, select Braze.
2. Assign a name to the destination and click Continue.

Connection settings

To successfully configure Braze as a destination, you need to configure the following settings:

• App Key: Enter your Braze app key. For more information on obtaining your Braze app key, refer to the FAQ section below.
• REST API Key: Enter the REST API key associated with your project. For more information on obtaining this key, refer to the FAQ section below.

• Data Center: Specify the data center associated with your Braze account. The easiest way to get your data center details is to log in to your Braze account and observing your URL. Some examples are shown below:

• Track events for anonymous users: Enable this setting to track anonymous user activity and send this information to Braze.
• Enable subscription groups in group call: Enable this setting to send the subscription group status in your group events. For more information, refer to the Group section below.
• Use Nested Array Operations: Enable this setting to use the nested array operations in your track calls.

Device mode settings

The following settings are applicable only if you're sending events to Braze via the device mode:

• Client-side Events Filtering: This setting lets you specify which events should be blocked or allowed to flow through to Braze. For more information on this setting, refer to the Client-side Events Filtering guide.
• Use device mode to send events: Enable this setting to send events to Braze via the device mode.
• Deduplicate Traits: Enable this setting to deduplicate the user traits in the identify call.
• Show Braze logs: Enable this setting to show the Braze logs to your users.
• OneTrust Cookie Categories: This setting lets you associate the OneTrust cookie consent groups to Braze.

Adding device mode integration

Depending on your platform of integration, follow the steps below to add Braze to your project:

Identify

You can use the identify call to identify a user in Braze in any of the following cases:

• When the user registers to the app for the first time.
• When they log into their app.
• When they update their information.

A sample identify call is shown below:

Copy
rudderanalytics.identify(
  "1hKOmRA4GRlm", {
    email: "alex@example.com",
    name: "Alex Keener"
  }
);

Deleting a user

You can delete a user in Braze using the Suppression with Delete regulation of the RudderStack Data Regulation API.

A sample regulation request body for deleting a user in Braze is shown below:

Copy
{
  "regulationType": "suppress_with_delete",
  "destinationIds": [
    "2FIKkByqn37FhzczP23eZmURciA"
  ],
  "users": [{
    "userId": "1hKOmRA4GRlm",
    "<customKey>": "<customValue>"
  }]
}

Delta management for identify calls

If you are sending events to Braze via the device mode, you can save on costs by deduplicating your identify calls. To do so, enable the Deduplicate Traits dashboard setting. RudderStack then sends only the changed or modified attributes (traits) to Braze.

It is highly recommended to review Braze's data points policy to fully understand how this functionality can help you avoid data overages.

Track

The track call lets you record the customer events, that is, the actions that they perform, along with any properties associated with them.

A sample track call is shown below:

Copy
rudderanalytics.track("Product Added", {
  numberOfRatings: "12",
  name: "item 1",
});

Order Completed

When you call the track method for an Order Completed event, RudderStack sends the product information present in the event to Braze as purchases.

A sample Order Completed event is shown below:

Copy
rudderanalytics.track("Order Completed", {
  userId: "1hKOmRA4GRlm",
  currency: "USD",
  products: [{
      product_id: "123454387",
      name: "Game",
      price: 15.99
    }
  ],
});

Nested array operations

You can also send the track properties as nested arrays and perform create, add, update, and remove operations on them. To do so, you must first enable the Nested Array Operations dashboard setting. Then, include the field nestedOperationType in the track event, as shown:

Copy
rudderanalytics.track("Product Viewed", {
  "nestedOperationType": "update",
  "pets": [{
      "identifier_key": "id",
      "identifier_value": 4,
      "new_object": {
        "breed": "fish"
      }
    },
    {
      "identifier_key": "id",
      "identifier_value": 5,
      "new_object": {
        "name": "alex"
      }
    }
  ]
});

Note that nestedOperationType is a required field for this feature and must take one of the create, update, add, or remove values.

For more information on sending nested custom attributes to Braze, refer to the Braze documentation.

Page

The page call allows you to record your website's page views, with the additional relevant information about the viewed page.

A sample page call is as shown below:

Copy
rudderanalytics.page("Cart", "Cart Viewed", {
  path: "/cart",
  referrer: "test.com",
  search: "term",
  title: "test_item",
  url: "http://test.in",
})

Group

You can use the group call to link an identified user with a group, such as a company, organization, or an account.

Copy
rudderanalytics.group("12345", {
  name: "MyGroup",
  industry: "IT",
  employees: 450,
  plan: "basic"
})

Once you send a group event, RudderStack sends a custom attribute to Braze with the name as ab_rudder_group_<groupId> and the value as true. For example, if the groupId is 123456, then RudderStack creates a custom attribute with the name ab_rudder_group_123456 and sends it to Braze with its value to true.

While using the Braze destination in cloud mode, you can also update the subscription group status. To do so, enable the Enable subscription groups in group call setting in the RudderStack dashboard and send the subscription group status in the group call, as shown:

Copy
rudderanalytics.group("12345", {
  subscriptionState: "subscribed",
  email: "alex@example.com"
})

Sending push notification events

For sending the push notification events, add the following code to your AppDelegate file under the didFinishLaunchingWithOptions method:

Copy
if #available(iOS 10, *) {
    let center = UNUserNotificationCenter.current()
    center.delegate = self
    var options: UNAuthorizationOptions = [.alert, .sound, .badge]
    if #available(iOS 12.0, *) {
        options = UNAuthorizationOptions(rawValue: options.rawValue | UNAuthorizationOptions.provisional.rawValue)
        }
        center.requestAuthorization(options: options) { (granted, error) in
            RSClient.sharedInstance().pushAuthorizationFromUserNotificationCenter(granted)
    }
    UIApplication.shared.registerForRemoteNotifications()
} else {
    let types: UIUserNotificationType = [.alert, .badge, .sound]
    let setting: UIUserNotificationSettings = UIUserNotificationSettings(types: types, categories: nil)
    UIApplication.shared.registerUserNotificationSettings(setting)
    UIApplication.shared.registerForRemoteNotifications()
}

Copy
if (floor(NSFoundationVersionNumber) > NSFoundationVersionNumber_iOS_9_x_Max) {
  UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
  center.delegate = self;
  UNAuthorizationOptions options = UNAuthorizationOptionAlert | UNAuthorizationOptionSound | UNAuthorizationOptionBadge;
  if (@available(iOS 12.0, *)) {
  options = options | UNAuthorizationOptionProvisional;
  }
  [center requestAuthorizationWithOptions:options
                        completionHandler:^(BOOL granted, NSError * _Nullable error) {
      [[RSClient sharedInstance] pushAuthorizationFromUserNotificationCenter:granted];
  }];
  [[UIApplication sharedApplication] registerForRemoteNotifications];
} else {
  UIUserNotificationSettings *settings = [UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeBadge | UIUserNotificationTypeAlert | UIUserNotificationTypeSound) categories:nil];
  [[UIApplication sharedApplication] registerForRemoteNotifications];
  [[UIApplication sharedApplication] registerUserNotificationSettings:settings];
}

FAQ

Where can I find the Braze App Key and REST API Key?

To obtain your Braze App Key and REST API Key, follow these steps:

1. Log into your Braze dashboard.
2. Go to Settings > Developer Console.
3. You can find the REST API key for your app under the Identifier column, as shown:

4. You can find your Braze App Key in the Identification section, as shown: