Skip to main content

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.

With the Mention Me integration into Bloomreach, you can insert a CTA link in your emails to direct customers to a referral landing page. This helps amplify referral performance by surfacing the program to more users and encouraging repeat shares. The personalised link enables customers to skip the referral registration step. Bloomreach will populate the referral landing page with the customer’s name and email address.

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

  1. You promote the referral program in an email and add a CTA link to the personalised referral landing page.
  2. The customer clicks the link and lands directly on their personalised landing page.
  3. The page is pre-filled with their personal information from Bloomreach, and they are auto-registered upon clicking the referral button.
  4. They share the referral offer with a friend using their preferred method.
  1. In your campaign, add a CTA link or button
Adding a CTA link in Bloomreach email editor
  1. 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?
Adding the referral landing page URL to the CTA
  1. Append the following personalisation parameters to the end of the URL. Separate each with &:
ParameterValue / VariableNotes
firstname{{ customer.firstname }}Use Bloomreach’s personalisation variable for first name
surname{{ customer.lastname }}Use Bloomreach’s variable for last name
email{{ customer.email }}Use the customer’s email variable
situationBloomreach-newsletter-jan23Indicates the campaign placement. Use channel-type-date format to help analyze traffic in your Mention Me dashboard.
segmentloyaltyOptional parameter to target specific campaign rules (e.g., by customer type or locale).
localeen_GB

Final example URL

https://www.yoursite.com/refer-a-friend?email={{ customer.email }}&firstname={{ customer.firstname }}&surname={{ customer.lastname }}&situation=Bloomreach-newsletter-jan23&locale=en_GB&segment=loyalty
Final personalised referral URL with parameters in Bloomreach

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:

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.
These segments will begin populating from the time the integration is enabled, capturing live referral activity.

Prerequisites for initiatives

  1. An active Mention Me referral program
  2. Mention Me / Bloomreach integration is activated
  3. Your Bloomreach account must be integrated with your ESP
  4. Basic understanding of Bloomreach Jinja
Bloomreach pre-built initiatives overview

Step 1: Download the initiatives

Download the JSON file attached at the bottom of this guide.

Step 2: Import into Bloomreach

  1. Log in at Bloomreach.
  2. Click on Initiatives.
Initiatives page in Bloomreach
  1. Click Import at the top right.
Import button in Bloomreach Initiatives
  1. Upload your JSON file and click Import.
Uploading JSON file for initiative import

Troubleshooting: Incompatible version error

If you receive the error “Imported JSON definition has incompatible version”:
  1. Open the JSON file in a text editor like Notepad or TextEdit.
  2. Scroll to the end and find the line that includes "version": "1.265.3".
Version number in JSON file
  1. In Bloomreach, click the Help icon in the top toolbar and locate your Release Notes version number.
Finding Bloomreach release version in Help menu
  1. Update the version number in the JSON to match your current Bloomreach platform version (e.g., 1.276).
  2. Save the file without changing its name or extension, then re-upload and import.
Need help? Reach out to your Mention Me CSM or submit a support request here.

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.
Last modified on March 31, 2026