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

​

What the integration enables

• Grow your contact database by sending marketing opt-ins to Emarsys in real time
• Use referral data for personalised email campaigns and coupon reminders
• Improve segmentation with first-party referral data

As part of the Emarsys integration setup, Mention Me automatically creates the Customer Profile attributes and the External Events needed. No manual configuration is required before enabling the integration.

​

Contact Data

​

How contacts are created

• If the customer does not exist in your Emarsys instance, a new contact will be created.
• If the customer does exist, the existing contact will be updated with Mention Me-specific fields only.

​

Customer opt-ins

When a customer opts into your newsletter via the referee journey or through a post-purchase overlay, the opt-in request will automatically be sent to Emarsys:

• Emarsys opt-in property is set to True only if the user opts-in at registration or post-purchase.
• If they do not opt-in, the opt-in value will not be set (null).
• This will not be set for new Referrers.
• A marketing consent event is sent.
• A dedicated external event (mm:marketing_opt_in) is triggered.

​

Customer profile attributes

System fields — Mention Me will only update the specific system fields listed below. Custom fields — Mention Me will create the custom contact fields during integration setup and update them whenever applicable data is sent.

​

Events

The Mention Me integration uses Emarsys external events functionality for trigger-based workflows to generate email campaigns. Mention Me automatically sets the external events in Emarsys as part of the integration setup. External events are how programs and campaigns in Emarsys can be linked to external triggers. They can be associated with actions outside Emarsys, and can be used to add contacts to an automated program or trigger mobile or email campaigns.

​

Summary of events sent to Emarsys

** 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 using the Emarsys Scripting Language (ESL). You can use ESL in the email body, header, preheader, subject, from name, and anywhere personalisation is supported.

​

Registered as a referrer (mm:referrer_registration)

Each time a customer registers as a referrer, a registration event will be triggered and the associated data will be sent to Emarsys.

​

Registered as a Referee (mm:referee_registration)

Each time a customer registers as a referee, a registration event will be triggered and the associated data will be sent to Emarsys.

​

Received a referee reward (mm:referee_fulfillment)

Each time a referee obtains a reward for being a referrer’s friend, a referee fulfilment event will be triggered and the associated data will be sent to Emarsys. Includes all fields from referee registration plus:

​

Received a referrer reward (mm:referrer_fulfillment)

Each time a referrer obtains a reward for referring a friend, a referrer fulfilment event will be triggered. Same structure as referee fulfilment but with referrer-specific fields (referee_first_name, referee_last_name instead of referrer names).

​

Opted into Marketing (mm:marketing_opt_in)

Each time a referee requests to receive your newsletter at signup or post-purchase, a dedicated event is sent to Emarsys.

​

Submitted an NPS Score (mm:nps_score)

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

​

Discount on next order fulfilment (mm:discount_on_next_order_fulfillment)

Each time a customer obtains a reward from a non-referral post-purchase message, a discount on the next order fulfilment event will be triggered. Key fields include incentive-specific offer headline ({{event.offer.incentive.headline}}), CTA ({{event.offer.incentive.cta}}), coupon code, expiry, and call-to-action URL.

​

Propensity to refer (mm:propensity_to_refer)

Each time a customer has their propensity to refer calculated (Smart Experiment only), the propensity value will be sent to Emarsys.

​

ECR Data Import

Mention Me can automatically send your customers’ Extended Customer Revenue (ECR) data to your Emarsys account. ECR is only calculated for customers who have made a successful referral. This data is sent on a weekly basis and only for customers whose ECR has changed from the previous week. The following steps explain how to import ECR data as a one-off prior to beginning the weekly updates.

​

Step 1: Download ECR Data from Mention Me

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

2. Click Download customer segments (if not visible, contact your CSM).

3. Select all segments and click Generate.

4. A CSV file will be generated (up to 15 minutes). You’ll receive an email notification when it’s ready.
5. Click the link in the email to download (login required). You can also find the file under Settings > Secure file transfer.

​

Step 2: Create a CSV file for Emarsys

1. Open the file using Excel, Google Sheets, or similar tool.
2. Remove the first 3 rows (keep headers only).
3. Delete these 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 must be an exact match (case-sensitive), or duplicates may be created.

5. Move the Email column to the first position.

6. Save your final CSV file.

​

Step 3: Upload your CSV file to Emarsys

1. Go to Contacts > Data Import in Emarsys

2. Click Import File

3. Click Import file manually

4. Click Select a file and upload your formatted CSV.

5. On the Settings screen, configure:
   • Unique Identifier = Email
   • Opt-in declarations = Status not defined

6. Click Show Advanced Settings and select Update only

7. No need to match columns — Mention Me fields are already created during integration.
8. Click Next step

9. Click Next step again.
10. Name the import ECR Import, click Start Import.

11. Import complete! Mention Me ECR segment and activity will now be available in Emarsys.