> ## 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 Set Up Salesforce Marketing Cloud (SFMC) with Mention Me

> Connect your SFMC account to Mention Me to sync referral data, opt-ins, and link data extensions.

## About the Integration

Seamlessly integrate high-quality, first-party referral data into Salesforce Marketing Cloud (SFMC) to enhance customer segmentation and campaign performance. Use Mention Me data - like next-best action, propensity to refer, and Extended Customer Revenue - to target high-value customer segments more effectively.

The integration is self-serve, requires no major IT effort, and can be fully set up in under 10 minutes.

## Integration Capabilities

* Send contact data and opt-ins from Mention Me referred customers to SFMC in real time
* Create coupon email reminders using referral data
* Use referral data to boost targeting across other marketing channels

## Prerequisites

* **Salesforce Marketing Cloud** - You must have *Administrator* or *Marketing Cloud Administrator* roles.
* **Mention Me** - Access to the [Mention Me platform](https://mention-me.com/login). Contact your Mention Me CSM if needed.

## Step 1: Create a Mention Me App in Salesforce Marketing Cloud

Log in to your Salesforce Marketing Cloud admin account to set up a Mention Me App integration:

<Steps>
  <Step title="Verify permissions">
    Ensure you have **Installed Package > Administrator** permissions.
  </Step>

  <Step title="Navigate to Installed Packages">
    Go to **Setup > Apps > Installed Packages**.

    <Frame caption="The SFMC Setup Installed Packages navigation.">
      <img src="https://mintcdn.com/mentionme/VdCgy-TyOfKIO-83/images/knowledge/esp-crm/sfmc/9243107800733.png?fit=max&auto=format&n=VdCgy-TyOfKIO-83&q=85&s=536b9061a759e5ad9891d0f4b497f2e2" alt="SFMC Setup Installed Packages navigation" width="518" height="776" data-path="images/knowledge/esp-crm/sfmc/9243107800733.png" />
    </Frame>
  </Step>

  <Step title="Create a new package">
    Click **New** and name the package **Mention Me**.

    <Frame caption="Creating a new Mention Me package in SFMC.">
      <img src="https://mintcdn.com/mentionme/VdCgy-TyOfKIO-83/images/knowledge/esp-crm/sfmc/9243107756061.png?fit=max&auto=format&n=VdCgy-TyOfKIO-83&q=85&s=6598a376ad41b8e2ed5d7391482dcff6" alt="Creating new Mention Me package in SFMC" width="964" height="480" data-path="images/knowledge/esp-crm/sfmc/9243107756061.png" />
    </Frame>
  </Step>

  <Step title="Save the package">
    Click **Save**.
  </Step>

  <Step title="Add a component">
    Under Components, click **Add Component**.
  </Step>

  <Step title="Configure API Integration">
    Set the Component Type to **API Integration** with Integration Type **Server-to-Server**.

    <Frame caption="Selecting the API Integration component type in SFMC.">
      <img src="https://mintcdn.com/mentionme/VdCgy-TyOfKIO-83/images/knowledge/esp-crm/sfmc/9243084882973.png?fit=max&auto=format&n=VdCgy-TyOfKIO-83&q=85&s=096862e5a7d9d0a0955b0e4760010428" alt="Selecting API Integration component type" width="882" height="586" data-path="images/knowledge/esp-crm/sfmc/9243084882973.png" />
    </Frame>

    Then set the integration type to Server-to-Server:

    <Frame caption="Setting the Server-to-Server integration type in SFMC.">
      <img src="https://mintcdn.com/mentionme/VdCgy-TyOfKIO-83/images/knowledge/esp-crm/sfmc/9243084932765.png?fit=max&auto=format&n=VdCgy-TyOfKIO-83&q=85&s=13d304d52b677d929e830d225fc132f6" alt="Setting Server-to-Server integration type" width="960" height="588" data-path="images/knowledge/esp-crm/sfmc/9243084932765.png" />
    </Frame>
  </Step>

  <Step title="Enable required permissions">
    Click **Edit** and enable the following permissions:

    * Journeys > Read & Write
    * List and Subscribers > Read & Write
    * Data Extensions > Read & Write

    <Frame caption="Enabling required API permissions in SFMC.">
      <img src="https://mintcdn.com/mentionme/VdCgy-TyOfKIO-83/images/knowledge/esp-crm/sfmc/9243084994589.png?fit=max&auto=format&n=VdCgy-TyOfKIO-83&q=85&s=52a2ecd493de8bb1daae3c1213ef8bc7" alt="Enabling required API permissions" width="920" height="376" data-path="images/knowledge/esp-crm/sfmc/9243084994589.png" />
    </Frame>
  </Step>

  <Step title="Save permissions">
    Click **Save**.
  </Step>

  <Step title="Note down app credentials">
    Note down the following values from the created app:

    * **Client ID**
    * **Client Secret**
    * **Subdomain** (from the REST Base URI, between `https://` and `.rest`)

    <Frame caption="The SFMC app showing the Client ID.">
      <img src="https://mintcdn.com/mentionme/VdCgy-TyOfKIO-83/images/knowledge/esp-crm/sfmc/9243047912093.png?fit=max&auto=format&n=VdCgy-TyOfKIO-83&q=85&s=0ab519c7f25258cfad17863e9f1399d8" alt="SFMC app showing Client ID" width="1287" height="725" data-path="images/knowledge/esp-crm/sfmc/9243047912093.png" />
    </Frame>

    The Client Secret is shown alongside it:

    <Frame caption="The SFMC app showing the Client Secret.">
      <img src="https://mintcdn.com/mentionme/VdCgy-TyOfKIO-83/images/knowledge/esp-crm/sfmc/9243047868189.png?fit=max&auto=format&n=VdCgy-TyOfKIO-83&q=85&s=fa401d71516a24498f5610ae4be2aa30" alt="SFMC app showing Client Secret" width="1287" height="725" data-path="images/knowledge/esp-crm/sfmc/9243047868189.png" />
    </Frame>

    <Frame caption="The SFMC app showing the REST Base URI used to identify the Subdomain.">
      <img src="https://mintcdn.com/mentionme/VdCgy-TyOfKIO-83/images/knowledge/esp-crm/sfmc/9243048008861.png?fit=max&auto=format&n=VdCgy-TyOfKIO-83&q=85&s=f6e79ef55ce2e1a7a45e645d6dc8e281" alt="SFMC app showing REST Base URI for Subdomain" width="1287" height="725" data-path="images/knowledge/esp-crm/sfmc/9243048008861.png" />
    </Frame>
  </Step>
</Steps>

## Step 2: Set Up the Integration in Mention Me

<Steps>
  <Step title="Connect on Mention Me platform">
    Go to the [Mention Me platform](https://mention-me.com/merchant/~/integrations/salesforce_marketing_cloud) and click **Connect**.

    <Frame caption="The Mention Me SFMC integration connect page.">
      <img src="https://mintcdn.com/mentionme/wCXk8mLkd-Pu-JvZ/images/knowledge/esp-crm/sfmc/20902015870109.png?fit=max&auto=format&n=wCXk8mLkd-Pu-JvZ&q=85&s=0619e7cb7a1ad8f2756840774ae10b50" alt="Mention Me SFMC integration connect page" width="1388" height="935" data-path="images/knowledge/esp-crm/sfmc/20902015870109.png" />
    </Frame>
  </Step>

  <Step title="Accept terms and conditions">
    Accept the terms and conditions if prompted.

    <Frame caption="The terms and conditions acceptance screen for the SFMC integration.">
      <img src="https://mintcdn.com/mentionme/wCXk8mLkd-Pu-JvZ/images/knowledge/esp-crm/sfmc/23455848706717.png?fit=max&auto=format&n=wCXk8mLkd-Pu-JvZ&q=85&s=fdd655012d1ba5af5167b12fa127fd69" alt="Terms and conditions acceptance for SFMC integration" width="1432" height="520" data-path="images/knowledge/esp-crm/sfmc/23455848706717.png" />
    </Frame>
  </Step>

  <Step title="Click New authentication">
    Click **New authentication**.

    <Frame caption="The New Authentication button in Mention Me.">
      <img src="https://mintcdn.com/mentionme/wCXk8mLkd-Pu-JvZ/images/knowledge/esp-crm/sfmc/12608140948637.png?fit=max&auto=format&n=wCXk8mLkd-Pu-JvZ&q=85&s=89090d2feeeed91174536906eee7911a" alt="New authentication button in Mention Me" width="1900" height="684" data-path="images/knowledge/esp-crm/sfmc/12608140948637.png" />
    </Frame>
  </Step>

  <Step title="Enter API credentials">
    Fill in the following values gathered in Step 1:

    * Client ID
    * Client Secret
    * Subdomain

    <Frame caption="Entering SFMC API credentials in Mention Me.">
      <img src="https://mintcdn.com/mentionme/VdCgy-TyOfKIO-83/images/knowledge/esp-crm/sfmc/9243108000925.png?fit=max&auto=format&n=VdCgy-TyOfKIO-83&q=85&s=d60176340aec1793fbc9e4dfde34660c" alt="Entering SFMC API credentials in Mention Me" width="1332" height="630" data-path="images/knowledge/esp-crm/sfmc/9243108000925.png" />
    </Frame>
  </Step>

  <Step title="Create the authentication">
    Click **Create**.
  </Step>

  <Step title="Configure Contact Key setting">
    If your SFMC Contact Key is not an email, **untick** the email option.

    <Frame caption="The Contact Key email option in the SFMC integration.">
      <img src="https://mintcdn.com/mentionme/wCXk8mLkd-Pu-JvZ/images/knowledge/esp-crm/sfmc/12608124349341.png?fit=max&auto=format&n=wCXk8mLkd-Pu-JvZ&q=85&s=74884697bd715c250be06e31ab34d32d" alt="Contact Key email option in SFMC integration" width="1858" height="550" data-path="images/knowledge/esp-crm/sfmc/12608124349341.png" />
    </Frame>
  </Step>

  <Step title="Authorise the integration">
    Click **Authorise**.
  </Step>

  <Step title="Select countries to sync">
    Select the countries for which you want Mention Me data synced.

    <Frame caption="Selecting countries to sync with SFMC.">
      <img src="https://mintcdn.com/mentionme/wCXk8mLkd-Pu-JvZ/images/knowledge/esp-crm/sfmc/22852098101533.png?fit=max&auto=format&n=wCXk8mLkd-Pu-JvZ&q=85&s=a5df68e433f2876f05c063b0e185915f" alt="Selecting countries to sync with SFMC" width="991" height="553" data-path="images/knowledge/esp-crm/sfmc/22852098101533.png" />
    </Frame>

    <Note>Only data from selected Mention Me countries will be synced to Salesforce.</Note>
  </Step>

  <Step title="Finalise the connection">
    Click **Connect**.

    Mention Me will now complete the integration and create relevant Data Extensions in Salesforce. This setup may take up to 1 minute to complete before moving to the final step.
  </Step>
</Steps>

## Step 3: Link the Mention Me Data Extension

Once the integration is set up, you need to link the data extension that Mention Me created to your email contact data. This enables Mention Me customer attributes to sync with your contacts for use across Marketing Cloud journeys and campaigns.

### Navigate to Contact Builder

<Steps>
  <Step title="Log in to SFMC">
    Log in to Salesforce Marketing Cloud.
  </Step>

  <Step title="Open Contact Builder">
    Click **Audience Builder > Contact Builder**.

    <Frame caption="Navigating to Contact Builder in SFMC.">
      <img src="https://mintcdn.com/mentionme/VdCgy-TyOfKIO-83/images/knowledge/esp-crm/sfmc/9605374709405.gif?s=dab9c742220df2888630f3a0170300e6" alt="Navigating to Contact Builder in SFMC" width="1920" height="1080" data-path="images/knowledge/esp-crm/sfmc/9605374709405.gif" />
    </Frame>
  </Step>

  <Step title="Click Email Data">
    Click **Email Data**.
  </Step>
</Steps>

### Link the Data Extension

<Steps>
  <Step title="Go to Data Extensions">
    Go to **Data Extensions**.
  </Step>

  <Step title="Click Link">
    Click **Link**.

    <Frame caption="The Link Data Extension button in Contact Builder.">
      <img src="https://mintcdn.com/mentionme/VdCgy-TyOfKIO-83/images/knowledge/esp-crm/sfmc/9607576221597.png?fit=max&auto=format&n=VdCgy-TyOfKIO-83&q=85&s=2ac25ced68c29d89eccf99e6302a2b17" alt="Link Data Extension button in Contact Builder" width="740" height="354" data-path="images/knowledge/esp-crm/sfmc/9607576221597.png" />
    </Frame>
  </Step>

  <Step title="Expand Data Extensions folder">
    Expand the Data Extensions folder.
  </Step>

  <Step title="Select Mention Me Custom Fields">
    Select the **Mention Me Custom Fields** Data Extension.

    <Frame caption="Selecting the Mention Me Custom Fields data extension.">
      <img src="https://mintcdn.com/mentionme/VdCgy-TyOfKIO-83/images/knowledge/esp-crm/sfmc/9607576134429.png?fit=max&auto=format&n=VdCgy-TyOfKIO-83&q=85&s=105ca59100e8745e8406b54cbb50df74" alt="Selecting Mention Me Custom Fields data extension" width="948" height="686" data-path="images/knowledge/esp-crm/sfmc/9607576134429.png" />
    </Frame>
  </Step>

  <Step title="Map the Email field">
    Map the Mention Me Email field to your system's Email Address field.

    <Frame caption="Mapping the Mention Me Email field to the Email Address field.">
      <img src="https://mintcdn.com/mentionme/VdCgy-TyOfKIO-83/images/knowledge/esp-crm/sfmc/9607576103965.png?fit=max&auto=format&n=VdCgy-TyOfKIO-83&q=85&s=e8fb86b2c73afa5eb12ba284d233193b" alt="Mapping Mention Me Email field to Email Address" width="870" height="644" data-path="images/knowledge/esp-crm/sfmc/9607576103965.png" />
    </Frame>
  </Step>

  <Step title="Save the link">
    Click **Save**.

    <Frame caption="Saving the data extension link in SFMC.">
      <img src="https://mintcdn.com/mentionme/VdCgy-TyOfKIO-83/images/knowledge/esp-crm/sfmc/9605448957341.gif?s=e95a48dabd213b28447ab4982f3079dd" alt="Saving the data extension link in SFMC" width="1920" height="1080" data-path="images/knowledge/esp-crm/sfmc/9605448957341.gif" />
    </Frame>

    Your Mention Me customer attributes are now successfully linked to your Marketing Cloud contact data using the email address.
  </Step>
</Steps>
