Send query results to Braze

Braze is a leading marketing automation platform that allows users to create custom experiences based on sophisticated customer attributes and segments, then map those experiences to campaigns.

Amperity can send customer profile attributes to Braze, attaching the data that is sent from Amperity to profiles that already exist in Braze.

This topic describes the steps that are required to send customer profile attributes to Braze from Amperity:

  1. Build a query

  2. Add orchestration

  3. Run orchestration


Braze must be enabled before you can configure an orchestration to send query results. Ask your DataGrid Operator or Amperity representative to enable Braze for your tenant.

Build query

Use the query editor to filter by the user identifier associated with your segment in Braze, and then return a list of attributes. Send the results of this query to Braze.

For example:

  ,external_id AS external_id
  ,email AS email
  ,last_purchase AS last_purchase
  ,purchase_propensity AS purchase_propensity
FROM Merged_Customers

Use this query to maintain customer profile attributes in Braze. The list in Braze is updated to match these customer profile attributes; attributes are added and/or removed as necessary.

Add orchestration

An orchestration defines the relationship between query results and a destination, including the location to which those query results will be sent and the frequency at which the orchestration will be run.

To add an orchestration

  1. From the Destinations tab, click Add Orchestration. This opens the Add Orchestration dialog box.

  2. From the Object Type drop-down, select Query.

  3. From the Object drop-down, select the query for which results will be sent to Braze.

  4. From the Destination drop-down, select a destination that is configured for sending data to Braze.

  5. From the Data Template drop-down, select a data template.

  6. Verify all settings.

  7. Set the workflow to Manual. (You can change this to automatic later, after verifying the end-to-end workflow.)

  8. Click Save.

Run orchestration

Run the orchestration manually to validate that it works.

Amperity sends attributes to Braze as JSON, using an "attribute": "value" pattern. For example:

  "external_id" : "123",
  "braze_id": "123",
  "email" : "",
  "custom_attributes" : {
    "last_purchase" : "last purchase",
    "purchase_propensity" : "high"

To run the orchestration

  1. From the Destinations tab, under Orchestrations, open the    menu for the Braze orchestration, and then select Run.

  2. The Status column for the orchestration will update to say “Waiting to start…”, after which the notifications pane will update to include a notification that shows the current status.

  3. When the orchestration has run successfully, the status is updated to “Completed”.