Send data 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 and custom attributes to Braze, attaching the data that is sent from Amperity to customer profiles that already exist in Braze.

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

  1. About custom attributes

  2. Get details

  3. Add destination

  4. Add data template

About custom attributes

Attributes in Braze describe your customers.

  • Profile attributes describe who your customers are. For example: names, birthdates, email addresses, and phone numbers.

  • Custom attributes describe how your customers have interacted with your brand. For example: purchase histories, loyalty status, and value tiers.

When user profile fields and custom attributes are available in Braze they can be used to build out audience segments and to apply personalization to your campaigns.

Customer profiles

Attributes in Braze describe your customers.

  • Profile attributes describe who your customers are. For example: names, birthdates, email addresses, and phone numbers.

  • Custom attributes describe how your customers have interacted with your brand. For example: purchase histories, loyalty status, and value tiers.

When user profile fields and custom attributes are available in Braze they can be used to build out audience segments and to apply personalization to your campaigns.

What about email and phone subscription status?

Braze uses two fields to track email and phone subscription status: email_subscribe and push_subscribe. The values for these fields are not modified by Amperity even when the fields are sent from Amperity with the correct values. Braze is your source of truth for customer consent and for tracking email and phone subscription status.

The following table describes the default user profile fields that are most commonly updated from Amperity:

Braze default field

Amperity field name

Description

external_id

varies

Required. The external_id is a unique identifer for user profiles in Braze. The external_id is a unique identifier that exists in another system, such as the Amperity ID, a loyalty ID, or some other unique customer identifier.

first_name

given_name

Optional.

last_name

surname

Optional.

email

email

Optional.

phone

phone

Optional.

home_city

city

Optional.

country

country

Optional. Must be in ISO 3166-1 alpha-2 format.

dob

birthdate

Optional. Must be in “YYYY-MM-DD” format.

gender

gender

Optional. Accepted values: “M”, “F”, “O” (other), “N” (not applicable), “P” (prefer not to say), or NULL.

Note

Default user profile fields also exist for alias_name, alias_label, current_location, date_of_first_session, date_of_last_session, email_open_tracking_disabled, email_click_tracking_disabled, facebook, language, marked_email_as_spam_at, push_tokens, subscription_groups, time_zone, and twitter.

These fields are not commonly sent to Braze from Amperity, but if your brand chooses to update these user profile fields from Amperity, be sure to use the exact name of the default field name, send the correct value (or values), and to use lowercase.

Custom attributes

Custom attributes in Braze are represented by a set of custom-named fields. The names of these fields are determined by your brand. They may already exist in Braze, in which case you will want to shape the output that is sent from Amperity to align to the names you already have.

The names of custom attributes that can be managed by Amperity are defined by your brand. The names are strings, may contain hyphens, spaces, or underscores, may include numbers, and may contain a mix of lowercase and uppercase letters. For example, custom attribute can have names that:

  • Already exist within your organization.

  • Are exactly the same as Amperity standard output, such as “One and Done” or “L12M Monetary” (the “monetary” component of an RFM score), or “Early Repeat Purchaser”.

  • Align to marketing goals and/or terminology that exists within your brand’s segmentation strategy.

Verify the names of custom attributes that will be sent to Braze from Amperity. Amperity will add a custom attribute whenever there isn’t a matching name.

Tip

Avoid sending custom attributes as duplicates of default user profile fields. For example, birthdates should be sent to Braze as a user profile field named “dob”. If they are sent as “birthday”, “Birthdate”, or any other string, a custom attribute will be created and the values in the “dob” field will not be updated.

Important

Your brand’s list of custom attributes should be a list that is mostly static, remains stable over time, and is focused on your most valuable customers.

Only update custom attributes for customers to which your brand is currently engaged. Define an audience in Amperity that is some combination of “high value” (historical or predicted), “active” (has purchased recently), and are “contactable” (with an opt-in status of true for phone numbers and/or email addresses).

This will help ensure that you are only updating custom attributes for your most valuable customers. Custom attributes will be updated only for those customers have a matching “external_id” or “braze_id” within Braze.

About data points

Braze uses data points to determine when to update segment membership, to identify which types of messages should be sent, and how to apply message personalization.

You can send custom attributes to Braze from Amperity by attaching attributes from your customer profiles in Amperity, such as first and last names, email addresses, phone numbers, physical locations, SMS and email consent status, purchase histories, and so on.

Data points are part of the billing and pricing structure in your Braze contract. Some data points are non-billable; many data points are billable.

Carefully review the lists of non-billable and billable data points , and then review those lists against the attributes you will send to Braze from Amperity to determine which of those attributes are considered billable or non-billable data points.

Talk with your Braze representative to clarify if an attribute sent from Amperity is a billable or non-billable data point.

Customer profiles table

Build a table that contains all of the attributes in Braze that your brand wants to manage from Amperity. The columns in this table must be correctly mapped to requirements for user profile fields and should contain the list of custom attributes that will be maintained.

To add a Braze customer attributes table

Step 1.

Open your customer 360 database and add a table named “Braze Customer Attributes”.

Use SQL to define the default user profile fields that are required by Braze:

SELECT
  mc.amperity_id
  ,mc.amperity_id AS external_id
  ,mc.given_name AS first_name
  ,mc.surname AS last_name
  ,mc.email
  ,mc.phone
  ,mc.city AS home_city
  ,mc.country
  ,mc.birthdate AS dob
  ,mc.gender
FROM Merged_Customers

You may include custom attributes that map to other fields in your customer 360. For example, to use transaction attributes as custom attributes in Braze you can extend the table to include fields from the Transaction_Attributes_Extended table:

SELECT
  mc.amperity_id
  ,mc.amperity_id AS external_id
  ,mc.given_name AS first_name
  ,mc.surname AS last_name
  ,mc.email
  ,mc.phone
  ,mc.city AS home_city
  ,mc.country
  ,mc.birthdate AS dob
  ,mc.gender
  ,ta.L30D_purchase_channels
  ,ta.L30D_order_revenue
  ,ta.L30D_order_frequency
  ,ta.L3M_purchase_channels
  ,ta.L3M_order_revenue
  ,ta.L3M_order_frequency
  ,ta.L12M_rfm_score
  ,ta.L12M_recency
  ,ta.L12M_frequency
  ,ta.L12M_monetary
  ,ta.lifetime_order_revenue
  ,ta.one_and_done
  ,ta.multi_purchase_channel
  ,ta.first_to_second_order_days
  ,ta.days_since_latest_order
  ,ta.latest_order_datetime
  ,ta.early_repeat_purchaser
FROM Merged_Customers mc
LEFT JOIN Transaction_Attributes_Extended ta
ON mc.amperity_id = ta.amperity_id
LEFT JOIN Customer_Attributes ca
ON mc.amperity_id = ca.amperity_id
Step 2.

Validate the table, and then click Next.

Add the amperity-id semantic tag to the row that contains the “amperity_id” column. This ensures that this table will be available from the Edit Attributes editor within campaigns.

Step 3.

Name the table “Braze Customer Profiles”, and then save the table. Verify that the table is accessible to the Segment Editor and to the Edit Attributes editor within campaigns.

Get details

The Braze destination requires the following configuration details:

Detail one.

Configuration details for Braze.

  • The API key for your instance of Braze.

    Open the Developer Console . Under REST API Key, click + Create New API Key, and then set the following permissions under User Data: “users.track”, “users.export.segment”, and “segments.list”.

    Save the API key.

    Note

    If you view the REST API key after you have saved it you should see a configuration similar to:

    The endpoints that are required for an Amperity-to-Braze workflow.

    The API key that you will use to configure Amperity credentials is available from the Identifier column on the Rest API Key page and is similar to: a1bc2345-678d-9012-e3fg-hi34jk5l6789.

    Add the identifier that is required by this workflow.
  • The REST API endpoint from which your instance of Braze is available.

    For example, if your URL for Braze is https://dashboard-03.braze.com, the REST API endpoint is https://rest.iad-03.braze.com, and the instance is “US-03”.

  • The name of a segment in Braze for which attributes are managed by Amperity. Click Segments to view the list of segments in Braze.

  • A list of user profile fields and/or custom attributes that may be sent to Braze from Amperity.

Detail two.

Configuration details for Amperity.

Amperity requires access to an Amazon S3 bucket, which is used to synchronize attribute updates that are sent from Amperity to Braze.

The S3 bucket requires the following configuration settings:

  • An IAM access key and IAM secret key.

    Important

    This connector uses the Amperity Amazon S3 connector as part of the Braze configuration. The Amazon S3 connector allows the use of a Role ARN; however, the Braze connector does not. Leave the IAM Role ARN setting empty.

  • The name of the Amazon S3 bucket.

  • The name of the folder in the Amazon S3 bucket into which Amperity places data.

Add destination

Configure Amperity to send custom attributes directly to Braze.

To add a destination

Step 1.

Open the Destinations tab to configure a destination for Braze, and then click the Add Destination button to open the Destination dialog box.

Name, description, choose plugin.

Enter a name for this destination and provide a description. For example: “Braze” and “This sends audiences to Braze”.

From the Plugin drop-down, start typing “br” to filter the list, and then select Braze.

Step 2.

Credentials allow Amperity to connect to Braze.

The credential type is set automatically to braze. You may use an existing credential or you may add a new one.

Choose an existing credential or add credential.

Select an existing credential from the Credential drop-down.

– or –

Select Create a new credential from the Credential drop-down. This opens the Credential dialog box.

Choose an existing credential or add credential.

Enter the name for the credential, and then add a description.

Add the API key for your instance of Braze, and then provide the IAM access key and IAM secret key. Leave the IAM Role ARN field empty.

Set the following credentials for Braze.

When finished, click Save.

Step 3.

Each destination has settings that define how Amperity will deliver data to Braze. These settings are listed under the Settings section of the Destination dialog box.

Settings for Braze.

Select the Braze instance .

Select the user identifier. The external_id is a unique identifier for your customers, such as the Amperity ID. The braze_id is a unique identifier for existing Braze customers.

Add the name of the segment. This name should match the name of a segment name that will contain all of the users for which Amperity will manage audience attributes. This segment must be defined in Braze before results can be sent. The audience attributes for the users in the segment will be updated to match the results that are sent from Amperity.

Add the name of the Amazon S3 bucket and the name of the folder within the Amazon S3 bucket to which Amperity will send the data. The folder may be left blank.

Step 4.

Business users are assigned to the Amp360 User and/or AmpIQ User policies. (Amp360 User allows access to queries and orchestrations and AmpIQ User allows access to segments and campaigns.) A business user cannot select a destination that is not visible to them.

Business users – including users assigned to the DataGrid Operator policy – may have restricted access to PII.

What is restricted access to PII?

Restricted PII access is enabled when the Restrict PII Access policy option that prevents users who are assigned to that option from viewing data that is marked as PII anywhere in Amperity and from sending that data to any downstream workflow.

You can make this destination visible to orchestrations and allow users with restricted access to PII to use this destination by enabling one (or both) of the following options:

Allow business users access to this destination.

Note

To allow business users to use this destination with campaigns, you must enable the Make available to campaigns option within the data template. This allows users to send campaign results from Amperity to Braze.

The other two settings may be configured within the data template instead of the destination.

Step 5.

Review all settings, and then click Save.

Save the destination.

Important

You must configure a data template for this destination before you can send data to Braze.

Add data template

A data template defines how columns in Amperity data structures are sent to downstream workflows. A data template is part of the configuration for sending query and segment results from Amperity to an external location.

To add a data template

Step 1.

From the Destinations tab, open the menu for a destination that is configured for Braze, and then select Add data template.

This opens the Add Data Template dialog box.

Step 1

From the Destinations tab, open the menu for a destination that is configured for Braze, and then select Add data template.

This opens the Add Data Template dialog box.

Step 2.

Verify business user access to queries and orchestrations and access to segments and campaigns.

A business user may also have restricted access to PII, which prevents them from viewing and sending customer profile data.

Step 2.

If business user access was not configured as part of the destination, you may configure access from the data template.

Step 3.

Verify all configuration settings.

Verify settings for the data template.

Note

When the settings required by Braze were are not configured as part of the destination, you must configure them as part of the data template before making this destination available to campaigns.

Step 4.

Review all settings, and then click Save.

Save the data template.

After you have saved the data template, and depending on how you configured it, business users can send query results and/or send campaigns to Braze.