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 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 |
---|---|
| The Redpoint CDP profile attribute object |
| Array of audience output tags where the user is targeted in a Redpoint Outbound Delivery Braze channel execution |
| Array of offer tags where the user is targeted in a Redpoint Outbound Delivery Braze channel execution |
| Array of offer history contact IDs where the user is targeted in a Redpoint Outbound Delivery Braze channel execution |
| Array of channel execution IDs where the user is targeted in a Redpoint Outbound Delivery Braze channel execution |
![image-20240108-185737.png](../__attachments/3978199041/image-20240108-185737.png?inst-v=c3007bf4-8f91-43d3-9633-90859273c945)
Integration
Step 1: Set up templates
Step 1a: Create the Braze Onboarding and Upsert template
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.
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 |
|
First Name |
|
Last Name |
|
Primary Email |
|
Primary Country |
|
DOB |
|
Gender |
|
Primary City |
|
Primary Phone |
|
Add the Output Name attribute from the Offer History table.
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](../__attachments/3978199041/image-20240108-190309.png?inst-v=c3007bf4-8f91-43d3-9633-90859273c945)
Step 1b: Create the Braze Append template.
Create a second export template for append-only operations named Braze Append.
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](../__attachments/3978199041/image-20240108-191631.png?inst-v=c3007bf4-8f91-43d3-9633-90859273c945)
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](../__attachments/3978199041/image-20240108-191651.png?inst-v=c3007bf4-8f91-43d3-9633-90859273c945)
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](../__attachments/3978199041/image-20240108-191756.png?inst-v=c3007bf4-8f91-43d3-9633-90859273c945)
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
Navigate to the General tab in the Channels Configuration screen. Set the export template to each respective channel.
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](../__attachments/3978199041/image-20240108-191821.png?inst-v=c3007bf4-8f91-43d3-9633-90859273c945)
The export directory format on both channels will be identical and should end with \\[Channel]\\[Offer]\\[Workflow ID]
.
![image-20240108-191837.png](../__attachments/3978199041/image-20240108-191837.png?inst-v=c3007bf4-8f91-43d3-9633-90859273c945)
Step 3b: Configure post execution
Navigate to the Post Execution tab in the Channels Configuration screen.
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](../__attachments/3978199041/image-20240108-191854.png?inst-v=c3007bf4-8f91-43d3-9633-90859273c945)
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 endpointBASE_OUTPUT_DIRECTORY
: The shared output directory between RPI and RPDM
![image-20240108-191914.png](../__attachments/3978199041/image-20240108-191914.png?inst-v=c3007bf4-8f91-43d3-9633-90859273c945)
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](../__attachments/3978199041/image-20240108-191934.png?inst-v=c3007bf4-8f91-43d3-9633-90859273c945)
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](../__attachments/3978199041/image-20240108-191954.png?inst-v=c3007bf4-8f91-43d3-9633-90859273c945)
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](../__attachments/3978199041/image-20240108-192013.png?inst-v=c3007bf4-8f91-43d3-9633-90859273c945)
You can view the Redpoint associated properties on the user profile.
![image-20240108-192034.png](../__attachments/3978199041/image-20240108-192034.png?inst-v=c3007bf4-8f91-43d3-9633-90859273c945)