Bloomreach Data Reference

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.

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.

Consent tracking event in Bloomreach — A consent tracking event in Bloomreach.

Customer Profile Attributes

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

Bloomreach Customer Field	Description	Example
registered	Unique ID (usually email)	jason.jones@mention-me.com
email	Email address (set only if no value exists)	jason.jones@mention-me.com
mention_me_share_link	Referrer’s personal share URL to send to friends	https://demo.mention-me.com/m/ol/xz3uz-joel-mcfly
mention_me_dashboard_link	Referrer’s dashboard showing referred friends	https://demo.mention-me.com/d/2674816/9c34b0c2
mention_me_share_source	Channel used for share	OPEN-LINK
mention_me_referrals	Total successful referrals (includes historical)	5
mention_me_total_shares	Total shares across all channels (includes historical)	10
mention_me_email_shares	Email shares count	2
mention_me_facebook_shares	Facebook shares count	2
mention_me_facebook_messenger_shares	Messenger shares count	2
mention_me_name_sharing_shares	Name sharing count	1
mention_me_whatsapp_shares	WhatsApp shares count	3
mention_me_nps_score	NPS score at post-purchase	8
mention_me_propensity_to_refer	Score from Smart Experiment (High or Low)	High
mention_me_ecr_activity	ECR activity segment: Active, Dormant, Lapsed	Active
mention_me_ecr_status	ECR value status: High, Medium, Low	High
mention_me_network_id	Unique Network ID from Mention Me	N-5051-153480685
mention_me_first_share_date	Date of customer’s first referral share	2024-06-03T16:19:08.000Z
mention_me_first_referral_date	Date of customer’s first successful referral	2024-06-03T16:19:08.000Z
mention_me_last_share_date	Date when last share was made	2024-06-03T16:19:08.000Z
mention_me_last_referral_date	Date when last successful referral occurred	2024-06-03T16:19:08.000Z
mention_me_ecr_12m_predicted	Predicted ECR status 12 months from now: High, Medium, Low, Lapsed	High
mention_me_referrer_engaged	True if referrer accepted terms and engaged with the offer	Yes

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

Mention Me Event Name	Bloomreach Event Name	When It Triggers
Registered as a Referee from Mention Me	registered_as_referee	When a customer has registered as a referee
Registered as a Referrer from Mention Me	registered_as_referrer	When a customer has registered as a referrer
Received a Referee Reward from Mention Me	received_referee_reward	When a customer obtained a reward as a referrer’s friend
Received a Referrer Reward from Mention Me	received_referrer_reward	When a customer obtained a reward for referring a friend
Submitted an NPS Score from Mention Me**	submitted_nps_score	When a customer has supplied an NPS score at post-purchase
Received a discount on next order from Mention Me**	received_reward_next_order	When a customer has received a discount to use on their next order
Propensity to Refer from Mention Me**	propensity_to_refer	Each time a customer has their propensity to refer calculated

** 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.

Field Name	Bloomreach Jinja Syntax	Description	Example
email	`{{ event.email }}`	Email used to register	rydercollins742@mention-me.com
firstname	`{{ event.firstname }}`	First name	Ryder
surname	`{{ event.surname }}`	Surname	Collins
customer_segment	`{{ event.customer_segment }}`	Segment from Mention Me tags	VIP
source	`{{ event.source }}`	System source	mention_me
share_link	`{{ event.share_link }}`	Referrer’s share link	https://demo.mention-me.com/m/ol/xz3uz-joel-mcfly
dashboard_link	`{{ event.dashboard_link }}`	Referrer’s tracking dashboard	https://demo.mention-me.com/d/2674816/9c34b0c2
campaign_name	`{{ event.campaign_name }}`	Internal campaign name	UK Campaign
locale_code	`{{ event.locale_code }}`	Locale code	en_GB
experiment_name	`{{ event.experiment_name }}`	Internal experiment name	AB Test - Current Vs New Imagery - July 2023
offer_name	`{{ event.offer_name }}`	Internal offer name	Variation A
offer_type	`{{ event.offer_type }}`	Type of offer	referral
offer_subject_copy	`{{ event.offer_subject_copy }}`	Customer-friendly offer description	Treat a friend to 20% off and get 20% off for yourself
offer_call_to_action_copy	`{{ event.offer_call_to_action_copy }}`	Customer-friendly CTA	Give 20% off
referrer_reward	`{{ event.referrer_reward }}`	Reward for the referrer	20%
referee_reward	`{{ event.referee_reward }}`	Reward for the referee	£15

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.

Field Name	Bloomreach Jinja Syntax	Description	Example
email	`{{ event.email }}`	Referee’s email	jojohnson378@mention-me.com
firstname	`{{ event.firstname }}`	First name (if supplied)	Joe
surname	`{{ event.surname }}`	Surname (if supplied)	Johnson
source	`{{ event.source }}`	System source	mention_me
share_source	`{{ event.share_source }}`	Share method used	FORWARDED-EMAILED-LINK
campaign_name	`{{ event.campaign_name }}`	Internal campaign name	UK Campaign
locale_code	`{{ event.locale_code }}`	Locale Code	en_GB
experiment_name	`{{ event.experiment_name }}`	Internal experiment name	AB Test - Current Vs New Imagery - July 2023
offer_name	`{{ event.offer_name }}`	Internal offer name	Variation A
offer_type	`{{ event.offer_type }}`	Type of offer	referral
offer_subject_copy	`{{ event.offer_subject_copy }}`	Customer-friendly offer description	Treat a friend to 20% off and get 20% off for yourself
offer_call_to_action_copy	`{{ event.offer_call_to_action_copy }}`	Customer-friendly CTA	Give 20% off
fulfilled_by	`{{ event.fulfilled_by }}`	Reward issuance method	coupon
reward_amount	`{{ event.reward_amount }}`	Reward amount	20
reward_type	`{{ event.reward_type }}`	Type of reward	percent
referrer_reward	`{{ event.referrer_reward }}`	Reward for the referrer	20%
referee_reward	`{{ event.referee_reward }}`	Reward for the referee	£15

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.

Field Name	Bloomreach Jinja Syntax	Description	Example
email	`{{ event.email }}`	Referee’s email	jojohnson378@mention-me.com
firstname	`{{ event.firstname }}`	First name	Joe
surname	`{{ event.surname }}`	Surname	Johnson
source	`{{ event.source }}`	System source	mention_me
referrer_first_name	`{{ event.referrer_first_name }}`	First name of the referrer	Ryder
referrer_last_name	`{{ event.referrer_last_name }}`	Surname of the referrer	Collins
campaign_name	`{{ event.campaign_name }}`	Internal campaign name	UK Campaign
locale_code	`{{ event.locale_code }}`	Locale Code	en_GB
currency_symbol	`{{ event.currency_symbol }}`	Currency symbol	£
experiment_name	`{{ event.experiment_name }}`	Internal experiment name	AB Test - Current Vs New Imagery - July 2023
offer_name	`{{ event.offer_name }}`	Internal offer name	Variation A
offer_type	`{{ event.offer_type }}`	Type of offer	referral
offer_subject_copy	`{{ event.offer_subject_copy }}`	Customer-facing offer summary	Treat a friend to 20% off and get 20% off for yourself
offer_call_to_action_copy	`{{ event.offer_call_to_action_copy }}`	Customer-friendly CTA	Give 20% off
fulfilled_by	`{{ event.fulfilled_by }}`	Reward issuance method	coupon
reward_amount	`{{ event.reward_amount }}`	Reward amount	20
reward_type	`{{ event.reward_type }}`	Type of reward	percent
referrer_reward	`{{ event.referrer_reward }}`	Reward for the referrer	20%
referee_reward	`{{ event.referee_reward }}`	Reward for the referee	£15
coupon_code	`{{ event.coupon_code }}`	Coupon code issued to the referee	10USDOFF-RXAAURVZ
coupon_expiry	`{{ event.coupon_expiry }}`	Coupon expiry date. Use Jinja conversion for formatting.	2024-09-03T16:19:19.000Z
call_to_action_url	`{{ event.call_to_action_url }}`	URL where the customer can spend their reward	www.mention-me.com

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.

Field Name	Bloomreach Jinja Syntax	Description	Example
email	`{{ event.email }}`	Referrer’s email	jojohnson378@mention-me.com
firstname	`{{ event.firstname }}`	First name	Joe
surname	`{{ event.surname }}`	Surname	Johnson
source	`{{ event.source }}`	System source	mention_me
referee_first_name	`{{ event.referee_first_name }}`	First name of the referred friend	Ryder
referee_last_name	`{{ event.referee_last_name }}`	Surname of the referred friend	Collins
campaign_name	`{{ event.campaign_name }}`	Internal campaign name	UK Campaign
locale_code	`{{ event.locale_code }}`	Locale Code	en_GB
currency_symbol	`{{ event.currency_symbol }}`	Currency symbol	£
experiment_name	`{{ event.experiment_name }}`	Internal experiment name	AB Test - Current Vs New Imagery - July 2023
offer_name	`{{ event.offer_name }}`	Internal offer name	Variation A
offer_type	`{{ event.offer_type }}`	Type of offer	referral
offer_subject_copy	`{{ event.offer_subject_copy }}`	Customer-facing offer summary	Treat a friend to 20% off and get 20% off for yourself
offer_call_to_action_copy	`{{ event.offer_call_to_action_copy }}`	Customer-friendly CTA	Give 20% off
fulfilled_by	`{{ event.fulfilled_by }}`	Reward issuance method	coupon
reward_amount	`{{ event.reward_amount }}`	Reward amount	20
reward_type	`{{ event.reward_type }}`	Type of reward	percent
referrer_reward	`{{ event.referrer_reward }}`	Reward for the referrer	20%
referee_reward	`{{ event.referee_reward }}`	Reward for the referee	£15
coupon_code	`{{ event.coupon_code }}`	Coupon code issued to the referrer	10USDOFF-RXAAURVZ
coupon_expiry	`{{ event.coupon_expiry }}`	Coupon expiry date. Use Jinja conversion for formatting.	2024-09-03T16:19:19.000Z
call_to_action_url	`{{ event.call_to_action_url }}`	URL where the referrer can spend their reward	www.mention-me.com

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.

Field Name	Bloomreach Jinja Syntax	Description	Example
email	`{{ event.email }}`	Email used to submit	jojohnson378@mention-me.com
firstname	`{{ event.firstname }}`	First name	Joe
surname	`{{ event.surname }}`	Surname	Johnson
source	`{{ event.source }}`	System source	mention_me
campaign_name	`{{ event.campaign_name }}`	Internal campaign name	UK Campaign
locale_code	`{{ event.locale_code }}`	Locale Code	en_GB
experiment_name	`{{ event.experiment_name }}`	Internal experiment name	AB Test - Current Vs New Imagery - July 2023
offer_name	`{{ event.offer_name }}`	Internal offer name	Collect NPS Feedback
offer_type	`{{ event.offer_type }}`	Type of offer	nps-only
offer_subject_copy	`{{ event.offer_subject_copy }}`	Customer-facing offer description	Treat a friend to 20% off and get 20% off for yourself
offer_call_to_action_copy	`{{ event.offer_call_to_action_copy }}`	Customer-friendly CTA	Give 20% off
customer_segment	`{{ event.customer_segment }}`	Segment from Mention Me tags	VIP
nps_score	`{{ event.nps_score }}`	NPS score submitted	8

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.

Field Name	Bloomreach Jinja Syntax	Description	Example
email	`{{ event.email }}`	Customer’s email	jojohnson378@mention-me.com
firstname	`{{ event.firstname }}`	First name	Joe
surname	`{{ event.surname }}`	Surname	Johnson
source	`{{ event.source }}`	System source	mention_me
campaign_name	`{{ event.campaign_name }}`	Internal campaign name	UK Campaign
locale_code	`{{ event.locale_code }}`	Locale Code	en_GB
currency_symbol	`{{ event.currency_symbol }}`	Currency symbol	£
experiment_name	`{{ event.experiment_name }}`	Internal experiment name	AB Test - Current Vs New Imagery - July 2023
offer_name	`{{ event.offer_name }}`	Internal offer name	Variation A
offer_type	`{{ event.offer_type }}`	Type of offer	referral
offer_subject_copy	`{{ event.offer_subject_copy }}`	Customer-facing offer description	Treat a friend to 20% off and get 20% off for yourself
offer_call_to_action_copy	`{{ event.offer_call_to_action_copy }}`	Customer-friendly CTA	Give 20% off
fulfilled_by	`{{ event.fulfilled_by }}`	Reward issuance method	coupon
reward_amount	`{{ event.reward_amount }}`	Reward amount	20
reward_type	`{{ event.reward_type }}`	Type of reward	percent
discount_reward	`{{ event.discount_reward }}`	Combined reward description	20%
coupon_code	`{{ event.coupon_code }}`	Coupon code	10USDOFF-RXAAURVZ
coupon_expiry	`{{ event.coupon_expiry }}`	Coupon expiry date. Use Jinja conversion for formatting.	2024-09-03T16:19:19.000Z
call_to_action_url	`{{ event.call_to_action_url }}`	URL where the customer can redeem their reward	www.mention-me.com

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.

Field Name	Bloomreach Jinja Syntax	Description	Example
email	`{{ event.email }}`	Customer’s email	jojohnson378@mention-me.com
firstname	`{{ event.firstname }}`	First name	Joe
surname	`{{ event.surname }}`	Surname	Johnson
source	`{{ event.source }}`	System source	mention_me
campaign_name	`{{ event.campaign_name }}`	Internal campaign name	UK Campaign
experiment_name	`{{ event.experiment_name }}`	Internal experiment name	AB Test - Current Vs New Imagery - July 2023
offer_name	`{{ event.offer_name }}`	Internal offer name	Variation A
offer_type	`{{ event.offer_type }}`	Type of offer	referral
offer_subject_copy	`{{ event.offer_subject_copy }}`	Customer-facing offer description	Treat a friend to 20% off and get 20% off for yourself
offer_call_to_action_copy	`{{ event.offer_call_to_action_copy }}`	Customer-friendly CTA	Give 20% off
propensity_segment	`{{ event.propensity_segment }}`	Propensity segment. Values: High or Low	High

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

Navigate to Customer Revenue

Navigating to Customer Revenue page in Mention Me — Navigating to the Customer Revenue page in Mention Me.

Download customer segments

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

Generate the file

Select all segments and click Generate.

Selecting ECR segments to generate CSV — Selecting ECR segments to generate the CSV.

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

Download the CSV file

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

The Secure File Sharing page in Mention Me.

Step 2: Create a CSV File for Bloomreach

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

Open the CSV file

Open the downloaded CSV file.

Remove the header rows

Remove the first three rows so only the headers remain.

Remove unused columns

Delete the following columns:

Individual Revenue
Revenue Referred
Friends ECR Value
Report Currency Code
First Name
Surname

Rename the remaining columns

Rename the following columns:

Email address to email
Activity Status to mention_me_ecr_activity
Ecr Segment to mention_me_ecr_status

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

Reorder the Email column

Ensure the email column is first. Your CSV file should now look like this:

Formatted CSV column layout for Bloomreach import — A formatted CSV column layout for the Bloomreach import.

Save the file

Save the file as .csv

Step 3: Upload Your CSV to Bloomreach

For more guidance, see Bloomreach’s guide to importing customers.

Navigate to New Import

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

The Bloomreach Imports New Import navigation.

Select Customers

Select Customers.

Selecting Customers import type — Selecting the Customers import type in Bloomreach.

Upload your CSV

Click Upload a file and select your prepared CSV.

Uploading CSV file for Bloomreach import — Uploading the CSV file for the Bloomreach import.

Proceed to mapping

The preview will load automatically. Click Next to proceed to mapping.

Import preview in Bloomreach — The import preview screen in Bloomreach.

Configure the data mapping

Configure the data mapping:

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

Data mapping with email as hard_id identifier — The data mapping screen with email set as the hard_id identifier.

Run the import

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.

Getting Started

Onboarding

Referral

Influencer

A/B Testing

Reporting

Integrations

Security & Data

Platform Reference

Overview

What the Integration Enables

How Contact Matching Works

Contact Data

How Contacts Are Created

Customer Profile Attributes

Events

Summary of Events Sent to Bloomreach

How to Use Mention Me Data in Email Templates

Registered as a Referrer (`registered_as_referrer`)

Registered as a Referee (`registered_as_referee`)

Received a Referee Reward (`received_referee_reward`)

Received a Referrer Reward (`received_referrer_reward`)

Submitted an NPS Score (`submitted_nps_score`)

Received a Discount on Next Order (`received_reward_next_order`)

Propensity to Refer (`propensity_to_refer`)

ECR Data Import

Step 1: Download ECR Data from Mention Me

Step 2: Create a CSV File for Bloomreach

Step 3: Upload Your CSV to Bloomreach

​Overview

​What the Integration Enables

​How Contact Matching Works

​Contact Data

​How Contacts Are Created

​Customer Consent

​Customer Profile Attributes

​Events

​Summary of Events Sent to Bloomreach

​How to Use Mention Me Data in Email Templates

​Registered as a Referrer (registered_as_referrer)

​Registered as a Referee (registered_as_referee)

​Received a Referee Reward (received_referee_reward)

​Received a Referrer Reward (received_referrer_reward)

​Submitted an NPS Score (submitted_nps_score)

​Received a Discount on Next Order (received_reward_next_order)

​Propensity to Refer (propensity_to_refer)

​ECR Data Import

​Step 1: Download ECR Data from Mention Me

​Step 2: Create a CSV File for Bloomreach

​Step 3: Upload Your CSV to Bloomreach

Overview

What the Integration Enables

How Contact Matching Works

Contact Data

How Contacts Are Created

Customer Consent

Customer Profile Attributes

Events

Summary of Events Sent to Bloomreach

How to Use Mention Me Data in Email Templates

Registered as a Referrer (`registered_as_referrer`)

Registered as a Referee (`registered_as_referee`)

Received a Referee Reward (`received_referee_reward`)

Received a Referrer Reward (`received_referrer_reward`)

Submitted an NPS Score (`submitted_nps_score`)

Received a Discount on Next Order (`received_reward_next_order`)

Propensity to Refer (`propensity_to_refer`)

ECR Data Import

Step 1: Download ECR Data from Mention Me

Step 2: Create a CSV File for Bloomreach

Step 3: Upload Your CSV to Bloomreach