Skip to main content
Skip table of contents

Braze

This page delineates how to connect to Braze. The steps below will help you configure your Braze channel within Redpoint Interaction (RPI). Once you’ve completed these steps, you will then be able to process records out of RPI through to Braze.

Prerequisites

Requirement

Description

Braze REST API key

A Braze REST API key with users.track permissions.

Create this in the Braze dashboard from Settings > API Keys.

If you are using older navigation, you can create an API key at Developer Console > API Settings.

Braze REST endpoint

Your REST endpoint URL. Your endpoint will depend on the Braze URL for your instance.

Redpoint Data Management artifacts

The Braze integration is supported by a set of Redpoint Data Management (RPDM) artifacts. Contact Redpoint Support to request the artifacts for your version of RPDM.

Redpoint CDP custom attributes

The following Redpoint custom attributes can be added to a Braze user profile.

Field

Description

rpi_cdp_attributes

The Redpoint CDP profile attribute object

rpi_audience_outputs

Array of audience output tags where the user is targeted in a Redpoint Outbound Delivery Braze channel execution

rpi_offers

Array of offer tags where the user is targeted in a Redpoint Outbound Delivery Braze channel execution

rpi_contact_ids

Array of offer history contact IDs where the user is targeted in a Redpoint Outbound Delivery Braze channel execution

rpi_channel_exec_ids

Array of channel execution IDs where the user is targeted in a Redpoint Outbound Delivery Braze channel execution

image-20240108-185737.png

Integration

Step 1: Set up templates

Step 1a: Create the Braze Onboarding and Upsert template

  1. In RPI, create a new export template, and name it Braze Onboarding and Upsert. This template defines the core mappings between the Redpoint CDP and the Braze user profile, along with any additional custom attributes you want to add to your user profiles in Braze.

  2. Drag Redpoint CDP attributes into the Attribute column. Set each Header Row Value to the corresponding Braze user attribute. The following table lists Redpoint CDP attributes and their corresponding Braze attributes:

Redpoint attribute

Header row value

PID

external_id

First Name

first_name

Last Name

last_name

Primary Email

email

Primary Country

country

DOB

dob

Gender

gender

Primary City

home_city

Primary Phone

phone

  1. Add the Output Name attribute from the Offer History table.

  2. Lastly, add any additional custom Redpoint attributes you want to merge into Braze. For example, the following is an onboarding and upsert template with education, income, and marital status as additional attributes.

image-20240108-190309.png

Step 1b: Create the Braze Append template.

  1. Create a second export template for append-only operations named Braze Append.

  2. You will set only two attributes for this template:

    • For PID, set the Header Row Value as external_id.

    • For Output Name, set the Header Row as output_name.

image-20240108-191631.png

Step 1c: Set date format

For both export templates, navigate to the Options tab and set the Date Format to the value of Custom Format. Set the format as yyyy-MM-dd.

image-20240108-191651.png

Step 2: Create outbound channels

In RPI, create two new channels. Set both channels to Outbound Delivery. Name one channel Braze Onboarding and Upsert and name the other Braze Append.

image-20240108-191756.png

After the initial onboarding of your CDP records to Braze, check whether subsequent Redpoint Interaction workflows that use the Braze Onboarding and Upsert channel are designed to select only records that have changed since the initial onboarding sync.

Step 3: Configure the channels

Step 3a: Set template and export path format

  1. Navigate to the General tab in the Channels Configuration screen. Set the export template to each respective channel.

  2. Next, define an Export path format on both channels that point to a shared network, file transfer protocol, or external content provider location that is accessible to both RPI and RPDM.

image-20240108-191821.png

The export directory format on both channels will be identical and should end with \\[Channel]\\[Offer]\\[Workflow ID].

image-20240108-191837.png

Step 3b: Configure post execution

  1. Navigate to the Post Execution tab in the Channels Configuration screen.

  2. Check the Post-execution checkbox to call a service URL after channel execution. Enter your RPDM web service URL. This entry will be identical on both your Onboarding and Append channel.

image-20240108-191854.png

Step 4: Set up Braze components in RPDM

The archive containing RPDM artifacts to support the Braze integration contains a README with detailed instructions for setting up the required components. Keep in mind the following details when configuring your integration.

Step 4a: Update the RPI to Braze automation

Next you’ll update the RPI to Braze automation with your Braze REST endpoint and base RPI output directory.

After importing the Braze related artifacts into RPDM, open the automation named AUTO_Process_RPI_to_Braze and update the following two automation variables with the values for your environment:

  • BRAZE_API_URL: The Braze REST endpoint

  • BASE_OUTPUT_DIRECTORY: The shared output directory between RPI and RPDM

image-20240108-191914.png

Step 4b: Update the RPI to Braze append project

The RPDM project named PROJ_RPI_to_Braze_Append contains the outbound delivery export file schema and mappings for the rpi_cdp_attributes custom attribute object in Braze.

Update the file input schema and document injector tool named RPI to Braze Document Injector with any additional custom CDP attributes defined in your export file template. This example shows the additional mapping of education, income, and marital status:

image-20240108-191934.png

Using the integration

The Outbound Delivery Braze channel can now be leveraged within RPI workflows. Follow the standard practices for creating selection rules and audiences in RPI, and building associated workflow schedules and triggers.

To enable the sync of an RPI Audience output to Braze, create an outbound delivery offer and associate it to either the Braze Onboarding and Upsert or the Braze Append channel. This depends on whether the intent is to create or merge new records in Braze, or to only append campaign data if the record already exists in Braze.

image-20240108-191954.png

Once the workflow has executed successfully in RPI, the orchestration and CDP data sourced from RPI can now be used to create segments in Braze.

image-20240108-192013.png

You can view the Redpoint associated properties on the user profile.

image-20240108-192034.png

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.