Bloomreach 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 Bloomreach allows you to receive referral and advocacy-related events into your Bloomreach platform in real time.

​

What the integration enables

• Send contact data and opt-ins from Mention Me referred customers to Bloomreach in real time
• Use referral data to trigger coupon email reminders
• Enhance marketing performance by segmenting and targeting high-value customers using referral and advocacy data

During setup, Mention Me automatically creates the necessary Customer Attributes and Custom Events in Bloomreach. No manual configuration is required. Event and attribute data is pushed based on customer ID (typically email address). Mention Me sends profile and event data for any prospect or customer who triggers a Mention Me event, regardless of their opt-in status in Bloomreach.

​

How contact matching works

• If a customer already exists in Bloomreach:
  • Append Mention Me attributes to their profile
  • Add Mention Me events to their profile
• If a customer does not exist in Bloomreach:
  • Create their contact profile using email as the ID
  • Append Mention Me attributes to the profile
  • Add relevant Mention Me events
  • Add a consent event only if explicitly captured during a Mention Me journey

​

Contact Data

​

How contacts are created

• Mention Me first checks if the customer already exists using email as the identifier.
  • If the contact does not exist, a new contact will be created.
  • If the contact does exist, Mention Me will update them with Mention Me-specific attributes only.
• Mention Me will only set the email field if no value is already present in Bloomreach.

​

Customer consent

Mention Me can capture newsletter opt-in consent directly and send it to Bloomreach, eliminating the need to export CSVs. When a customer consents through the referee journey or the post-purchase newsletter overlay, an opt-in tracking event is automatically sent to Bloomreach. The opt-in is captured using Bloomreach’s Consent Tracking Event under the consent category chosen during integration setup. Consent metadata includes when and where it was captured:

• mention_me_referee = Referee journey opt-in
• mention_me_newsletter = Post-purchase newsletter overlay

A customer may have opted in via other sources. Mention Me is not the source of truth for all consent data.

​

Customer profile attributes

The following custom attributes are created or updated on the customer profile in Bloomreach:

​

Events

The Mention Me integration uses Bloomreach’s custom events functionality to enable trigger-based workflows for email campaigns, segmentation, and automation. These events are automatically created in Bloomreach during setup and are associated with customer profiles via their email (registered ID). Custom events are how scenario segmentations in Bloomreach can be linked to external triggers. They can be used to add contacts to a scenario, trigger email campaigns, or create dynamic segments.

​

Summary of events sent to Bloomreach

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

​

How to use Mention Me data in email templates

The Mention Me data can be inserted into email campaigns to create a personalised email experience using the Bloomreach Jinja syntax. You can use the data in the email Body, Subject line, Sender email, Sender name, Pre-header, and UTM parameters.

​

Registered As A Referrer (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 Bloomreach.

​

Registered As A Referee (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 Bloomreach.

​

Received A Referee Reward (received_referee_reward)

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

​

Received A Referrer Reward (received_referrer_reward)

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

​

Submitted An NPS Score (submitted_nps_score)

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

​

Received A Discount On Next Order (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 (propensity_to_refer)

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

​

ECR Data Import

Mention Me can automatically send your customers’ Extended Customer Revenue (ECR) data to your Bloomreach account. ECR is only calculated for customers who have made a successful referral. This data is sent on a weekly basis and only includes customers whose ECR segment has changed from the previous week. The following steps explain how to import a full set of ECR data into Bloomreach as a one-off setup before automated syncing begins.

​

Step 1: Download ECR Data from Mention Me

1. Log in to the Mention Me Platform and go to Customer Revenue under the Advocacy Intelligence section.

2. Click the Download customer segments button. If you can’t see the button, contact your Mention Me CSM.

3. Select all segments and click Generate.

It may take up to 15 minutes to generate. You’ll receive an email when it’s ready.

4. Click the download link in the email (you may need to log in again to Mention Me).
5. Alternatively, go to Settings & Tools > Secure File Sharing to download the file.

​

Step 2: Create a CSV File for Bloomreach

Use any spreadsheet tool, such as Excel or Google Sheets.

1. Open the downloaded CSV file.
2. Remove the first three rows so only the headers remain.
3. Delete unnecessary columns:
   • Individual Revenue
   • Revenue Referred
   • Friends ECR Value
   • Report Currency Code
   • First Name
   • Surname
4. Rename columns:
   • Email address -> email
   • Activity Status -> mention_me_ecr_activity
   • Ecr Segment -> mention_me_ecr_status

Column names are case-sensitive. Incorrect names will cause duplicates in Bloomreach.

5. Ensure the email column is first.

6. Save the file as .csv

​

Step 3: Upload Your CSV to Bloomreach

For more guidance, visit this Bloomreach help page.

1. In Bloomreach, go to Data & Assets > Imports > New Import

2. Select Customers

3. Click Upload a file and select your prepared CSV

4. Preview will load automatically. Click Next to proceed to mapping.

​

Data Mapping

• De-select the checkbox next to the email field (do not import as a property)
• Drag email to hard_id identifier column
• Leave the two custom ECR fields as is — they’ll be added as customer properties

The mapping should appear as follows before you proceed:

6. Click Run Import

All customers who have successfully referred someone will now have an ECR segment and activity attribute added to their profile in Bloomreach. From here on, Mention Me’s weekly ECR export will only update customers whose ECR status has changed.