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

# How to Promote Referral from Emarsys

> Add a personalised referral CTA link to your Emarsys emails and test Mention Me powered Tactics.

With the Mention Me integration into Emarsys, you can insert a CTA link in your emails to direct customers to a referral landing page. This puts your scheme in front of customers who may not have seen it yet, and reminds those who have to share with friends.

The personalised link allows customers to skip the referral registration page, as Emarsys will insert customer details to pre-populate the referral landing page with their name and email address.

## Prerequisites

* You must have an existing referral landing page on your website with the Mention Me referral tag included.

## Types of Emails to Consider

* Dedicated referral solus emails (recommended at least once every 2-3 months)
* Inclusion in a newsletter or regular marketing email
* "Always-on" inclusion in all marketing emails (e.g. as a link, icon, or button in the header or footer)
* Referral as a dedicated email in your journey (e.g. post-purchase, welcome flow)

## How It Works

1. You promote your referral program via dedicated emails or a specific campaign and add the personalised landing page link as the CTA.
2. The customer clicks the link and is taken to the landing page.
3. The customer lands on a referral offer page with pre-filled information pulled from Emarsys.
4. They are automatically registered when they click the offer button.
5. The customer shares the offer with their friend via their preferred method.

## Adding the Personalised Landing Page Link

<Steps>
  <Step title="Add a CTA button">
    In your campaign promoting referral, add a CTA button:

    <Frame caption="Adding a CTA button in the Emarsys email editor.">
      <img src="https://mintcdn.com/mentionme/XuUPZxVPINYKEGlV/images/knowledge/esp-crm/emarsys/26447328626973.png?fit=max&auto=format&n=XuUPZxVPINYKEGlV&q=85&s=7e72e7a3e3ac8bab64b6900eeac0e28b" alt="Adding a CTA button in Emarsys email editor" width="659" height="326" data-path="images/knowledge/esp-crm/emarsys/26447328626973.png" />
    </Frame>
  </Step>

  <Step title="Add the landing page URL">
    In the URL of the CTA/button, add the base URL of your referral landing page including `?` at the end, for example `www.yourwebsite.com/refer-a-friend?`.

    <Frame caption="Adding the referral landing page URL to the CTA button.">
      <img src="https://mintcdn.com/mentionme/XuUPZxVPINYKEGlV/images/knowledge/esp-crm/emarsys/26447328627741.png?fit=max&auto=format&n=XuUPZxVPINYKEGlV&q=85&s=1731bb40ce1fc103037d65f22de08654" alt="Adding the referral landing page URL to the CTA button" width="1318" height="890" data-path="images/knowledge/esp-crm/emarsys/26447328627741.png" />
    </Frame>
  </Step>

  <Step title="Add the tracking parameters">
    Add the following parameters to the end of the URL, separated by `&`:

    | Parameter | Value / Variable           | Note                                                                                                                             |
    | --------- | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
    | firstname | `{{ contact.1 }}`          | Use the personalisation field you have set in Emarsys for first name.                                                            |
    | surname   | `{{ contact.2 }}`          | Use the personalisation field you use in Emarsys for last name.                                                                  |
    | email     | `{{ contact.3 }}`          |                                                                                                                                  |
    | situation | `Emarsys-newsletter-jan23` | Used to identify the source of a click. Use structure: `<channel>-<type>-<date>`. Helps with performance analysis in Mention Me. |
    | segment   | `loyalty`                  | Use for differentiating offers/campaigns for customers across segments or regions.                                               |
    | locale    | `en_GB`                    |                                                                                                                                  |

    #### Final Example URL

    ```text theme={null}
    https://<yourwebsite.com>/referrals?email={{ contact.3 }}&surname={{ contact.2 }}&firstname={{ contact.1 }}&situation=Emarsys-newsletter-jan23&locale=en_GB&segment=loyalty
    ```

    <Frame caption="The final personalised referral URL with parameters in Emarsys.">
      <img src="https://mintcdn.com/mentionme/XuUPZxVPINYKEGlV/images/knowledge/esp-crm/emarsys/26447313726749.png?fit=max&auto=format&n=XuUPZxVPINYKEGlV&q=85&s=141c765a9d53b2a73e1adb9de73ccc68" alt="Final personalised referral URL with parameters in Emarsys" width="1318" height="890" data-path="images/knowledge/esp-crm/emarsys/26447313726749.png" />
    </Frame>
  </Step>
</Steps>

## Testing Mention Me Tactics in Emarsys

This section covers how to test Mention Me Tactics in Emarsys to ensure all ESL variables and customer properties display correctly before going live.

The following Tactics can be tested:

* [Referee Coupon Reminder Tactic](https://help.emarsys.com/hc/en-us/articles/13050990023569-Coupon-Reminder-Referee-Friend-)
* [Referrer Coupon Reminder Tactic](https://help.emarsys.com/hc/en-us/articles/13051005105041-Coupon-Reminder-Referrer-Existing-Customer-)
* [Referrer Share Again Reminder Tactic](https://help.emarsys.com/hc/en-us/articles/13050919664529-Share-again)

You can test any of these emails based on a recent event sent to your email address to verify the ESL variables are rendering correctly. The following test steps apply to both the Referee/Referrer Coupon Reminder and the Reminder to Share Again Tactics.

### Prerequisites for Testing

* Your email address must be in Emarsys as an existing contact.
* The email campaigns for the selected Automation nodes must be Active to begin testing.

### Testing Steps

<Steps>
  <Step title="Open the tactic">
    Open the relevant tactic (Referee Coupon Reminder / Referrer Coupon Reminder / Reminder to Share Again) in Emarsys.
  </Step>

  <Step title="Set the status to Test">
    Set the Status to **Test**.

    <Frame caption="Setting the Emarsys tactic status to Test.">
      <img src="https://mintcdn.com/mentionme/XuUPZxVPINYKEGlV/images/knowledge/esp-crm/emarsys/16199745418781.png?fit=max&auto=format&n=XuUPZxVPINYKEGlV&q=85&s=e1f48d3bfa0ffaea511772332d2636a4" alt="Setting Emarsys tactic status to Test" width="502" height="239" data-path="images/knowledge/esp-crm/emarsys/16199745418781.png" />
    </Frame>
  </Step>

  <Step title="Configure the test node settings">
    Configure the test node settings as follows:

    * Select "Only Test Contacts, Sent Manually"
    * Skip the Wait Nodes
    * Ignore the Wait Events and select the "No" Path
    * Ignore the Participation Events and select the "No" Path

    <Frame caption="Configuring test node settings in Emarsys.">
      <img src="https://mintcdn.com/mentionme/XuUPZxVPINYKEGlV/images/knowledge/esp-crm/emarsys/16577903047837.png?fit=max&auto=format&n=XuUPZxVPINYKEGlV&q=85&s=198526becfb6753c4c8b1982e090e40c" alt="Configuring test node settings in Emarsys" width="1306" height="1988" data-path="images/knowledge/esp-crm/emarsys/16577903047837.png" />
    </Frame>
  </Step>

  <Step title="Send the test event">
    Click **Send Event**.

    <Frame caption="The Send Event button in Emarsys test mode.">
      <img src="https://mintcdn.com/mentionme/XuUPZxVPINYKEGlV/images/knowledge/esp-crm/emarsys/16577903060125.png?fit=max&auto=format&n=XuUPZxVPINYKEGlV&q=85&s=561a09fac4170656837f7155cad65a49" alt="Send Event button in Emarsys test mode" width="1258" height="306" data-path="images/knowledge/esp-crm/emarsys/16577903060125.png" />
    </Frame>
  </Step>

  <Step title="Enter your test email address">
    Enter your test email address and click Next.

    * A recent event will be detected and used to populate your test email.
    * The appropriate Test Event type will be selected based on the Automation.
    * The email will only be sent to the specified test email address.

    <Frame caption="Entering a test email address for Emarsys event testing.">
      <img src="https://mintcdn.com/mentionme/XuUPZxVPINYKEGlV/images/knowledge/esp-crm/emarsys/16199778096285.png?fit=max&auto=format&n=XuUPZxVPINYKEGlV&q=85&s=0d263cd714ba8fad444b9c6165a89588" alt="Entering test email address for Emarsys event testing" width="717" height="977" data-path="images/knowledge/esp-crm/emarsys/16199778096285.png" />
    </Frame>
  </Step>

  <Step title="Review and send">
    Review the Send Event summary and click **Send Event**.

    * A test email will be sent with your data variables populated. All wait/trigger events will be skipped in test mode.

    <Frame caption="The Send Event summary confirmation in Emarsys.">
      <img src="https://mintcdn.com/mentionme/XuUPZxVPINYKEGlV/images/knowledge/esp-crm/emarsys/16199745428893.png?fit=max&auto=format&n=XuUPZxVPINYKEGlV&q=85&s=41c6c65fc6c047c12f1dbc697b7100d0" alt="Send Event summary confirmation in Emarsys" width="717" height="395" data-path="images/knowledge/esp-crm/emarsys/16199745428893.png" />
    </Frame>
  </Step>

  <Step title="Activate the tactic">
    Once you've received your test email and verified the data, update Status to **Activate**.
  </Step>
</Steps>

For more information on testing interactions events in Emarsys, visit <a href="https://help.emarsys.com/hc/en-us/articles/5871445983889-Testing-Sending-test-events-to-an-Interactions-program#event-data" target="_blank" rel="noopener noreferrer">this guide</a>.
