Skip to content

Distributions with custom attributes

Braze integration enables you to send Voucherify codes in your Braze messages. This reference article covers how to use Braze custom attributes with Voucherify distributions.

Braze custom attributes enable you to assign Voucherify codes to custom attributes in user profiles in Braze. You can use unique coupons, gift cards, loyalty cards, and referral codes. First, connect Voucherify with Braze, create a distribution in Voucherify, and finally create a campaign in Braze with the custom attribute snippet in your message template.

Step 1: Connecting your Voucherify account to Braze

First, connect your Voucherify account with Braze.

  1. Copy the REST API key from your Braze account.
  2. Go to the Integrations directory in your Voucherify dashboard, find Braze and choose Connect.

  3. Paste the Braze API key and choose Connect:

Step 2: Code distribution

When connected, you can start a new Voucherify distribution that assigns a code to the custom attribute in the user profile in Braze. Later on, you can use received attributes with codes in your Braze campaigns.

Before setting up distribution, you need to add your Braze users to the Voucherify dashboard. Visit Voucherify to learn more.

You can distribute codes to Braze using two modes:

  • Manual mode
  • Define an automated workflow that triggers code delivery in response to an action taken by your users.

In both manual and automatic modes, Voucherify sends unique codes with their attributes and assigns them to Braze Custom Attributes in users’ profiles.

Map fields to custom attributes

Manual mode is a one-time action that assigns codes to a chosen audience. Go to the Distributions in your dashboard, run the distribution manager with the plus, and Choose Manual Message.

  1. Name your distribution.

    Choose a campaign that will be a source of unique codes (1) and select a segment of users or a single customer as your receivers (2). Visit Voucherify to learn more about customer segments.

  2. Next, add marketing permissions. If you don’t collect permissions from your audience, disable the consent verification.

  3. Choose Braze as a channel and map custom fields that will be added to the user profile in Braze. You need to add the field representing the code of the published voucher; the rest of the fields are optional.

  4. When completed, you can see a summary of the distribution. Click Save and send to deliver codes to user profiles in Braze.

Note that all manual distributions are sent with a 10-minute delay.

Voucherify can push codes to Braze automatically in response to the following triggers:

  • Customer entered/left specific Voucherify segment
  • Successful code publish – the message is sent when the code from a campaign is published (assigned) to a customer in Voucherify.
  • Order status changed (order created, order updated, order has been paid, order canceled)
  • Gift credits added – the message is sent when gift card credits are added to the customer’s card.
  • Loyalty points added – the message is sent when loyalty points are added to the customer’s profile.
  • Voucher redeemed – the message is sent to customers who successfully redeemed vouchers.
  • Voucher redemption rollback – the message is sent to the customer whose redemption was successfully rolled back.
  • Reward redemption – the message is sent when a customer redeems a loyalty or referral reward.
  • Custom event was logged for a customer - the message is triggered when Voucherify logs a particular custom event.

To set up an automatic workflow with Braze and Voucherify, visit distributions tutorial.

Step 3: Use Voucherify custom attributes in your Braze campaign

Once the custom attribute with the code is added to the customer’s custom attributes in Braze, you can use it in your campaigns.

Edit the message body and add the custom attribute defined in the Voucherify distribution. Place {{custom_attribute.${custom_attribute_with_code}}} to display the unique code.

When it’s ready, you can see the code in your message preview.

New Stuff!