Braze Data Reference

Documentation Index

Fetch the complete documentation index at: https://docs.mention-me.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Overview

The Mention Me integration with Braze allows you to gather insights related to referrals and advocacy directly within your Braze platform in real time.

​

What the integration enables

• Send contact data and opt-ins from Mention Me referred customers to Braze instantly
• Utilise referral data to create coupon email reminders
• Improve the effectiveness of your marketing channels by using referral and advocacy data to segment and target valuable customers

During setup, Mention Me creates the necessary customer attributes and events in Braze. No manual configuration is required. Events and custom attributes linked to customers in Braze are matched by their email address. Mention Me sends data for any customer (prospect or existing), regardless of opt-in status, who has triggered an event through the Mention Me platform. Braze handles the customer profile as follows:

• If the customer already exists:
  • Append Mention Me-specific attributes to their profile
  • Add Mention Me-related events to their profile
• If the customer does not exist:
  • Create the contact using their email address
  • Assign Mention Me-specific attributes
  • Add events from Mention Me
  • Optionally set email channel subscription status if consented through Mention Me journeys

​

Using External ID as Customer Identifier

If you’re using an external ID (instead of an email) as the primary identifier in Braze:

• If a customer already exists in Braze with both external ID and email, Mention Me data will augment the existing contact.
• If Mention Me creates the profile first (e.g., when the customer refers someone), it won’t include the external ID.
• When your system adds a new profile using the external ID, Braze will not merge it with the Mention Me-created profile, creating a duplicate.

To avoid duplicate profiles, use Braze’s Bulk Merge feature, which can be scheduled daily.

​

Contact Data

​

Customer consent

You may collect newsletter opt-in consent through the Mention Me journey. This consent is auto-forwarded to Braze without the need for CSV uploads. If a customer agrees to receive your newsletter during the Mention Me referee journey or post-purchase overlay, the opt-in is automatically sent to Braze. Customers who consent will be marked as opted-in on the email channel. Those who do not will still be signed up, but set to subscribed. A custom event called marketing_consent will be added to their Braze profile to indicate newsletter opt-in via Mention Me. Customers may also give consent through other sources outside Mention Me, so Mention Me may not be the sole source of consent data.

​

Customer profile attributes

Mention Me creates or updates the following fields in Braze:

​

Events

The Mention Me integration uses Braze custom events functionality for trigger-based scenarios to generate email campaigns or segmentations. Mention Me automatically sets the custom events in Braze as part of the integration setup. Events are associated with a customer profile based on their email address and show under the Custom Events section of the profile.

​

Summary of events

** If you have the Mention Me add-on enabled

​

How to use Mention Me data in Canvas Email templates

The Mention Me data can be inserted into Canvas email campaigns to create a personalised email experience using Liquid Scripting as canvas_entry_properties. You can use the data in a drag-and-drop email Body and subject line.

​

registered_as_referrer

Each time a customer registers as a referrer, a registration event will be triggered and the associated data will be sent to Braze.

​

registered_as_referee

Each time a customer registers as a referee, a registration event will be triggered and the associated data will be sent to Braze.

​

received_referee_reward

Each time a referee obtains a reward for being a referrer’s friend, a referee fulfilment event will be triggered.

​

received_referrer_reward

Each time a referrer obtains a reward for referring a friend, a referrer fulfilment event will be triggered.

​

marketing_consent

When a referee requests to receive your newsletter at signup or if an existing customer has signed up post-purchase, an event will be sent to Braze.

​

submitted_nps_score

Each time a customer submits an NPS Score via the Mention Me NPS feature, their response will be sent to Braze.

​

received_reward_next_order

Each time a customer obtains a reward from a non-referral post-purchase message, a discount on next order fulfilment event will be triggered.

​

propensity_to_refer

Each time a customer has their propensity to refer calculated, their propensity value will be sent to Braze. Only sent if you are running a Mention Me Smart Experiment.