Setting up a Mention Me integration – Ometria Help Centre

Mentio n Me is a referral marketing platform which allows you to prompt your contacts to refer their friends to your brand by sharing offers.

Ometria’s integration with Mention Me works by automatically importing referral data into Ometria, so you don’t need to upload manually via CSV.

This means you can create a dedicated email cycle for customers who’ve been referred by a friend, offering the ability to build personalised referral campaigns into your wider marketing strategy.

Before you begin

You’ll need an account with Mention Me.

Setting up your integration with Mention Me

Contact your customer success manager letting them know you are ready to begin your integration.

We will configure your integration for you and set up the following custom events and custom fields for your account:

Custom events

Event ID	Title
mm:registration_referrer	Registered as a referrer (Mention Me)

(Event) Property ID	Description	Type	Example
mm:campaign_id	The unique identifier of the Mention Me campaign that the referee has been enrolled in.	String	33463
mm:campaign_short_name	The short name of the campaign that the referee has been enrolled in. Note: This should not be used in customer facing emails.	String	en_FR Campaign (France)
mm:offer_id	The unique identifier of the Mention Me offer that the referee has been enrolled in.	String	115912
mm:offer_summary	A short description of the offer that the referee has been enrolled in Note: This should not be used in customer facing emails.	String	Referrer gets 20% off Referee gets 20% off

Event ID	Title
mm:fulfillment_referee	Obtained a reward as a referee (Mention Me)

(Event) Property ID	Description	Type	Example
mm:campaign_id	A unique identifier of the Mention Me campaign that the referee has been given a reward for.	String	33463
mm:campaign_short_name	The short name of the campaign that the referee has been given a reward for Note: This should not be used in customer facing emails	String	en_FR Campaign (France)
mm:offer_id	The unique identifier of the Mention Me offer that the referee has been given a reward for.	String	115912
mm:offer_summary	The short description of the offer that the referee has been given a reward for Note: This should not be used in customer facing emails	String	Referrer gets 20% off Referee gets 20% off
mm:offer_short_name	The short name of the offer that the referee has been given a reward for Note: This should not be used in customer facing emails	String	Control: name sharing first
mm:coupon	The coupon code of the reward that can referee has been given to use on their next purchase Note: You can use this in emails to remind referees/referrers to use the reward	String	DEMO-58983
mm:reward:type	The type of reward that the referee has been given. It could show as "Percent" or "Amount	String	Amount
mm:reward:amount	The amount of reward that the referee has been given based on the reward type. Note: You can use this in emails to show referees the value of their reward	Integer	38
mm:call_to_action_url	The URL where the referee can spend their reward: Note: You can use this in emails to direct referees to spend their reward.	String	www.fashion.com
mm:referred_by_firstname	The first name of the person who referred the referee. Note: You can use this in emails to remind referees who referred them.	String	John

Event ID	Title
mm:fulfillment_referrer	Obtained a reward for referring a friend (Mention Me)

(Event) Property ID	Description	Type	Example
mm:campaign_id	The unique identifier of the Mention Me campaign that the referrer has been given a reward for.	String	33463
mm:campaign_short_name	The short name of the campaign that the referrer has been given a reward for. Note: This should not be used in customer facing emails	String	en_FR Campaign (France)
mm:offer_id	The unique identifier of the Mention Me offer that the referrer has been given a reward for.	String	115912
mm: offer_summary	The short description of the offer that the referrer has been given a reward for. Note: This should not be used in customer facing emails.	String	Referrer gets 20% off Referee gets 20% off
mm:offer_short_name	The short name of the offer that the referrer has been given a reward for. Note: This should not be used in customer facing emails	String	Control: name sharing first

Custom fields

Category	ID	Description	Type	Example
CUSTOMER	mm:referred_by_firstname	This is the first name of the person who referred the referee. Note: You can use this in emails to remind referees who referred them.	String	John
CUSTOMER	mm:coupon	This is the coupon code of the reward that the referee/ referrer has been given to use on their next purchase Note: You can use this in emails to remind referees/referrers to use the reward.	String	DEMO-58983
CUSTOMER	mm:reward:amount	The amount of reward that the referee/referrer has been given based on the reward type. Note: You can use this in emails to show referees/referrers the value of their reward.	Integer	38
CUSTOMER	mm:call_to_action_url	This is the URL where the referee/referrer can spend their reward. Note: You can use this in an email to direct the referee/referrer where to spend their reward.	String	www.fashion.com
CUSTOMER	mm:share_link	For referrer contacts only. This is the link that referrers send to their friends to join your referral program.	String	https://demo.mentio n-me.com/m/ol/mr4 lk-alicia-winder
CUSTOMER	mm:dashboard_link	For referrer contacts only. The link referrers can use to see how many successful referrals they have had.	String	https://demo.mentio n-me.com/d/225215 1/58fde3c14a72844 b0cb856b530e8956 5ce3dada8ce3cdeb 2bd4129879b04ff4b
CUSTOMER	mm:coupon_expiry	The expiry date of the coupon that the referee/referrer has been given. Note: You can use this in emails to stress urgency to spend their reward.	Date	2020-07-30T18: 26:07+01:00

Note: Mention Me will also pass the referee_email_address to the default Ometria contact.email field. This field is used to identify the contact.

Mention Me merge tags

You can use your Mention Me custom fields to create merge tags for personalising your email templates.

When a merge tag includes a colon (:), e.g. mm:campaign_id, or if it starts with a number, you must use the square bracket [ ] syntax (indexer):

{{ profile.properties['fieldID'] }}
{{ event['fieldID'] }}

See also: Create a custom field

Use cases

Personalising emails

You can personalise emails using the custom fields created during the Mention Me integration.

Use the following structure:

{{ profile.properties['custom event ID'] }}

e.g.

{{ profile.properties['mm:coupon'] }}

Note: When a merge tag includes a colon (:), you must use the square bracket [ ] syntax (indexer).

If you're pasting in Jinja then you should also make sure that it has no formatting applied. We recommend copying from plain text.

Setting up a personalised Mention Me landing page

Ometria’s integration with Mention Me means that you can include ‘Refer a friend’ links to your email templates which direct your contacts to a personalised landing page.

From the landing page, the contact can enter their name and email address (if Ometria doesn’t already have this information) and then choose to share an offer with their friends.

Once you’re ready, all you need to do is is update any existing Mention Me referral links in your email templates to use the new URL:

<a href="https://api.ometria.com/connect/mentionme/{{email.account_hash}}/redirect?profile={{ profile.hash }}"> content copy </a>

Reward customers who refer their friends

Send extra special rewards and incentives to customers who refer their friends to your brand.

Audience: Customers who successfully referred a friend (using the Obtained a reward for referring a friend (Mention Me)event to segment).

Suggested message: Thanks for referring us! Here’s an extra special gift!

T + 7 days

Encourage customers to use their referral rewards with product recommendations.

Audience: Segment customers who have successfully referred a friend (using the Obtained a reward for referring a friend (Mention Me) event to segment), received their reward and have not purchased within 7 days (using date of last order).

Suggested message: Thank you for spreading the word! We selected some items we thought you might like to use your reward on.

Code about to expire

Encourage customers to use their referral offers before the coupon code expires.

Audience: Customers who have accepted the referral offer (using the Obtained a reward as a referrers friend (Mention Me) event to segment) but haven’t made their first purchase since the time the coupon code was generated (using number of orders).

This is not applicable to active customers.

Message: Make sure to use the exclusive offer [Friend’s name] shared with you before it expires!