Braze

Enhance your Braze campaigns with powerful customer data from your data warehouse.

In this guide, we’ll walk you through syncing customer data from your data warehouse into Braze to supercharge your marketing efforts. Let's get started!

Supported Objects

GrowthLoop enables syncing to these Braze objects:

ObjectDescriptionSync ModesField Mappings (Required)Field Mappings (Optional)
EventSync and track in-app behaviors, such as clicks, page views, or interactions.Insert (adds new events)Event name: The event’s name

Timestamp: When the event occurred
Profile AttributeUpdate user preferences and attributes for personalized campaigns.Insert (adds new profiles)

Update (modifies existing profiles)

Upsert (combines insert and update)
At least one attribute, e.g., Country
PurchaseSync transaction data for targeting users with offers or promotions.Insert (adds new purchase records)Product ID: Identifier, e.g., Product Name

Price: Amount paid

Time: When the purchase occurred,

Currency: e.g., USD
Quantity: Purchased amount

Prerequisites

  • Create a Braze API Key.
    1. Log in to Braze and go to Settings > APIs and Identifiers.
    2. Click Create API Key, name it "GrowthLoop," and select the User Data, Purchases, and Events permissions.
    3. Click Create API Key again to save your configuration. Make sure to copy the Identifier, as you'll need it for the next step.
  • Locate your Braze API URL. Visit Braze endpoint documentation to locate the API URL for your Braze instance. Be sure to copy the full API URL (i.e., REST Endpoint).

📘

Note

If your Braze URL is https://dashboard-06.braze.com, your API URL (i.e. REST Endpoint) will be https://rest.iad-06.braze.com.

Add and configure destination

  1. To begin, sign into the GrowthLoop Platform and navigate to the Destinations tab on the left sidebar. Click New Destination in the top right corner.
  2. In the Select Destination window that pops up, type Braze into the search bar to find Braze. Click Add Braze.
  3. Clicking Add Braze will require you to select/insert the following information:
    1. Destination Name: The name that will be used for this destination in the app.
    2. Sync Frequency: Choose either Daily or Hourly, which will determine how often GrowthLoop exports audiences to Braze.
    3. API Key: Enter the "Identifier" of your API Key from Braze.
    4. API URL: Enter the full API URL (i.e., REST Endpoint).
  4. Click Create. We’ll validate your permissions to ensure we can load your customer data to Braze. If successful, Braze will appear in your list of connected destinations!

Create and configure sync

  1. Navigate to the Syncs tab on the left sidebar and click Create Sync in the top right corner.
  2. Set up your Sync with the following details:
    1. Sync Name: A clear, friendly name for your sync.
    2. Sync Frequency: How often data should sync to the destination.
    3. Update Rule: The default method for syncing data to the destination.
    4. Dataset / Table: The table containing your events, purchases, or user data.
    5. Match Field: The column used to identify users in your source table for the destination system.
    6. Dataset Unique Field: The column with unique values for each user in the table.
    7. Connection: Choose the destination for syncing data. Select Braze.
    8. Object Type: Choose the data object to sync: Event, Purchase, or User Attribute.
    9. Match Field: The column used to match and identify users in the destination system based on your source data.
  3. Once you finish selecting/inserting the required fields, click Save Sync.
  4. Next, you'll need to add field mappings based on the object you're syncing to. In this case, we're syncing to the Event object, which requires the following:
    1. Event Name: The name of the event. See best practices on naming conventions here.
    2. Event Time: Indicates when the event occurred. Make sure it is in ISO 8601 or in yyyy-MM-dd'T'HH:mm:ss:SSSZ format.
  5. To map the fields, select the column that represents the Event Name from the drop-down under Source.
  6. Under the Destination section, select Event Name from the drop-down.
  7. Click Add Mapping to include a new Source -> Destination row underneath.
  8. Repeat steps 5 through 7 to map the remaining required destination field: Event Time
  9. After mapping all the fields, clicking Update Sync will prompt you with the following two options:
    1. Updates Only: We recommend you go with the this option, especially if you’re setting up the sync for the first time.
    2. Back-fill: This option is when you are updating an existing Sync with newly mapped fields and you’d like all your already synced events to have those fields backfilled for them. This operation can be very expensive and time consuming on your underlying Data Warehouse, so please choose that option if you’re absolutely sure.
  10. Finally, click the toggle at the top of the page to enable!
  11. To view your event data in Braze, navigate to the Audience section, select Search Users, search for a specific user, and scroll down to the Custom Events section.


👍

Success

You have successfully created an Event sync to Braze!

📘

Note

Experiencing any issues configuring Syncs to Braze? Reach out to us at [email protected] and we’ll be in touch shortly!


What’s Next

Want to discover more ways to combine GrowthLoop and Braze? Click below for a full list of use cases!