Prerequisites
You must have an existing referral landing page implemented on your website with the Mention Me referral tag included.Types of emails to consider
- Dedicated referral emails (recommended sending 1 every 2-3 months)
- Inclusion within newsletters or regular campaign emails
- Always-on placement in header/footer of all marketing emails
- Dedicated email in lifecycle journeys (e.g., welcome, post-purchase)
How it works
- You promote the referral program in an email and add a CTA link to the personalised referral landing page.
- The customer clicks the link and lands directly on their personalised landing page.
- The page is pre-filled with their personal information from Bloomreach, and they are auto-registered upon clicking the referral button.
- They share the referral offer with a friend using their preferred method.
Adding the personalised landing page link
- In your campaign, add a CTA link or button

- In the button/link settings, input the base URL of your referral landing page, followed by a
?Example:https://www.yourwebsite.com/refer-a-friend?

- Append the following personalisation parameters to the end of the URL. Separate each with
&:
| Parameter | Value / Variable | Notes |
|---|---|---|
| firstname | {{ customer.firstname }} | Use Bloomreach’s personalisation variable for first name |
| surname | {{ customer.lastname }} | Use Bloomreach’s variable for last name |
{{ customer.email }} | Use the customer’s email variable | |
| situation | Bloomreach-newsletter-jan23 | Indicates the campaign placement. Use channel-type-date format to help analyze traffic in your Mention Me dashboard. |
| segment | loyalty | Optional parameter to target specific campaign rules (e.g., by customer type or locale). |
| locale | en_GB |
Final example URL

Installing pre-built initiatives
With Bloomreach Initiatives and Mention Me’s integration, you can access pre-built scenarios and segments to quickly activate advocacy data and target your fans with personalised messaging.Pre-built scenarios
These ready-to-go scenarios contain suggested copy and personalised variables from Mention Me events:- Boost New Customer Acquisition: Automatically remind referred users to make their first purchase.
- Drive Repeat Purchases: Remind referrers to return and use their earned rewards.
- Increase Customer Engagement: Encourage brand advocates to share referral links with more friends.
Pre-built segments
These segments help identify actionable referral cohorts, ideal for future campaigns and analysis:- Shares: Identify your top sharers, medium sharers, and customers who haven’t yet shared.
- Referrals: Spot your top referrers, average performers, and those yet to refer.
Prerequisites for initiatives
- An active Mention Me referral program
- Mention Me / Bloomreach integration is activated
- Your Bloomreach account must be integrated with your ESP
- Basic understanding of Bloomreach Jinja

Step 1: Download the initiatives
Download the JSON file attached at the bottom of this guide.Step 2: Import into Bloomreach
- Log in at Bloomreach.
- Click on Initiatives.

- Click Import at the top right.

- Upload your JSON file and click Import.

Troubleshooting: Incompatible version error
If you receive the error “Imported JSON definition has incompatible version”:- Open the JSON file in a text editor like Notepad or TextEdit.
- Scroll to the end and find the line that includes
"version": "1.265.3".

- In Bloomreach, click the Help icon in the top toolbar and locate your Release Notes version number.

- Update the version number in the JSON to match your current Bloomreach platform version (e.g., 1.276).
- Save the file without changing its name or extension, then re-upload and import.
Step 3: Configure scenarios
With your initiatives imported, finalize by configuring them:- Update imagery and copy to match your brand.
- Set the “From” email name and address.
- Assign the correct ESP integration to emails.
- Define the correct consent type for each email journey.
- Test each flow with a contact who has the relevant event triggers.