Home

Mailchimp Integration

memberr integrates with Mailchimp to help you create personalized email campaigns using customer data from your loyalty program. This integration allows you to sync important customer information like store credit balances, membership status, and referral links directly to Mailchimp merge fields.

Installation

To integrate Mailchimp with memberr, you'll need:

  1. Your Mailchimp API Key
  2. Your Mailchimp Server prefix

Getting Your API Key

  1. Log in to your Mailchimp account
  2. Click on your profile name to expand the Account Menu
  3. Click "Account & Billing"
  4. Navigate to "Extras" > "API keys"
  5. Create a new API key or use an existing one

Finding Your Server Prefix

Your server prefix is part of your Mailchimp URL. For example, if your Mailchimp dashboard URL is https://us14.admin.mailchimp.com, your server prefix is us14.

Connecting to memberr

  1. In your memberr dashboard, go to "Integrations"
  2. Find Mailchimp in the list of available integrations
  3. Click "Connect"
  4. Enter your API Key and Server prefix
  5. Click "Save" to complete the connection
  6. Select the list you want to sync to

Merge Fields

Once connected, memberr automatically creates several merge fields in your Mailchimp list. These fields allow you to personalize your email campaigns with customer-specific information.

Currency and Balance Information

FieldDescriptionExample Value
M_CURCODEThe currency code used for the customer's Store Credit"USD"
M_CURBALThe raw integer value of available Store Credit (in smallest currency unit)1000
M_UPCBALThe raw integer value of pending Store Credit (in smallest currency unit)500
M_CBALFMTThe formatted decimal value of available Store Credit10.00
M_UBALFMTThe formatted decimal value of pending Store Credit5.00
M_CBALSYMThe formatted available Store Credit with currency symbol"$10.00"
M_UBALSYMThe formatted pending Store Credit with currency symbol"$5.00"

Customer Information

FieldDescriptionExample Value
M_REFLINKThe customer's unique referral link"https://store.com/?memberr-ref=abc123"
M_MEMNAMEThe customer's current membership tier name"Gold"
M_MEMEXPThe customer's membership expiration date"2024-12-31"

Using Merge Fields in Email Campaigns

To use these merge fields in your email campaigns:

  1. Create or edit an email campaign in Mailchimp
  2. Click where you want to insert a merge field
  3. Click the merge tags button (|MERGE|)
  4. Select the desired merge field from the list

Example Template


_13
Dear *|FNAME|*,
_13
_13
You currently have *|M_CBALSYM|* in Store Credit available to spend!
_13
_13
*|IF:M_UPCBAL > 0|*
_13
Good news! You have *|M_UBALSYM|* in Store Credit coming soon.
_13
*|END:IF|*
_13
_13
Share your referral link with friends: *|M_REFLINK|*
_13
_13
*|IF:M_MEMNAME|*
_13
Your current membership tier is: *|M_MEMNAME|*
_13
*|END:IF|*

Best Practices

  1. Use Formatted Values: When showing amounts in emails, use the formatted fields (M_CBALFMT) or symbol fields (M_CBALSYM) for proper display.
  2. Raw Values for Conditions: Use the raw balance fields (M_CURBAL, M_UPCBAL) when creating conditional content.
  3. Currency Awareness: Always consider the currency code (M_CURCODE) when displaying amounts to ensure proper currency handling.
  4. Referral Links: The M_REFLINK is automatically generated and unique to each customer, making it perfect for referral campaigns.

Data Syncing

memberr automatically syncs customer data to Mailchimp whenever there are changes to:

  • Store credit balance
  • Membership status
  • Referral program participation
  • Currency preferences

This ensures your email campaigns always use the most up-to-date customer information.