How to connect Citrus-Lime Ecommerce to a MailChimp account
"Mailchimp helps small businesses do big things, with the right tools and guidance every step of the way. Bring your audience data, marketing channels, and insights together so you can reach your goals faster—all from a single platform."
How to connect your Ecommerce website to MailChimp
Your Ecommerce website can seamlessly integrate with a MailChimp account in just a few short steps, which this article will cover.
If you require any assistance with how to manage and use your MailChimp account, please refer to MailChimp's knowledge base:
1) Find/Generate an API Key in your MailChimp account
MailChimp Users with Manager permissions can generate and view their own API (application programming interface) keys. Users with Admin permissions can also see API keys for other account users.
- Click this link to navigate to the API Keys section of your Mailchimp account: Your API Keys
- Click the Create A Key button;
- Name your key descriptively, so you know what application uses that key;
- Copy the key you have just created.
2) Add the MailChimp API to your Cloud POS Back Office
Once you have your API Key, login to your Cloud POS Back office and add your API Key to the configuration settings: https://pos.citruslime.com/backofficeux/configuration.aspx
3) Wait 24 hours for the Integration to upload to your MailChimp account
Once you have added the API Key to your Cloud POS back office, the integration will automatically begin the upload process to your MailChimp account. After 24 hours, your full Citrus-Lime Ecommerce database will have uploaded to an audience named:
'Citrus-Lime Cloud POS - *Your Store Name*'
4) Before you start sending
Once all Ecommerce data has uploaded to your account, you'll need to make sure your audience information is correct. To do so, head to the audience overview and click on the arrow next to the audience, then Settings: https://us10.admin.mailchimp.com/lists/
The two areas that will need checking over are:
- Audience name and defaults
- Required email footer content
Make sure all fields in these settings match your store information.
And you're done!
You're now able to start sending campaigns using the audience. MailChimp contains plenty of powerful automated features that can help build your brand. If you're looking for somewhere to start, we'd recommend exploring some of these automations that can generate a good source of passive income once they're live!
Create a Winning Welcome Email
Get Shoppers back to their carts
Already have an existing MailChimp account?
If you have an existing MailChimp account, you can still follow the above steps to integration your Ecommerce store. However, it is important to manually move your unsubscribe list and any legacy data in your existing audiences to the new one before you use the data in the audience.
To do so, you'll need to follow the below process.
Export your current audience(s)
You'll need to do this for every audience in your account. Each export will provide you with different spreadsheets for your audience data, split out by the Email Marketing Status (Subscribed, Unsubscribed, Cleaned). We recommend you keep this data for safe-keeping.
Import all audience information to the newer audience
For each audience, you'll need to follow the import process as specified in the article above. You'll need to do this for each spreadsheet you received for the export, making sure you import to the contacts exactly matching their status (E.g. importing 'Unsubscribed' addresses as Unsubscribed').
Bulk Unsubscribe the email address
As good practice, we recommend using MailChimp's Bulk Unsubscribe feature to be certain that all unsubscribed addresses have indeed been imported as unsubscribed.
Remove the other audience(s)
To avoid paying more than you need to for you account, we suggest that you only have the one audience in your account. The above guide goes in to detail about how you can do just that - though we'd always recommend that you backup your account data before doing so: https://mailchimp.com/help/export-back-up-data/
Once all audience data has been transferred to the newer audience, you can start sending with confidence. If you require any assistance with this or encounter any issues, please get in touch with our support team.
Frequently Asked Questions
Each contact in your audience is assigned a field labelled 'GDPR Allowed' that directly relates to how a customer has set their contact preferences at certain stages of your Ecommerce store (signing in, post-checkout). Depending on what option they select, this field will be populated with one of the below:
- 1 = This indicated that a customer has given you their unambiguous consent and is eligible for email marketing;
- 0 = The customer has specifically opted out of email marketing and does not wish to be marketed to*
- Blank = The customer has uploaded without any preference (E.g. basket abandonment) and has not given or consented to receiving email marketing.
You're able to create segments in your audience to target this field before sending your campaigns. For example:
You can read more about Citrus-Lime and GDPR here: https://howto.citruslime.com/42246-platform-updates-changelogs/306251-gdpr-and-you-and-us
MailChimp offer different levels of accounts, mainly dependant on your audience size. If you have an existing account on a 'Free' plan, MailChimp will only allow the creation of one audience. Other plans also have a maximum audience limit. If you're reached the limit with your plan, you will see this message on the audience overview plan: https://us14.admin.mailchimp.com/lists/
If you see the above message, you'll need to export and remove the audience before the new audience can upload. Follow the steps in 'Already have an existing MailChimp account?', but remove the audience before you begin the import.
Other common issues:
- Does your API key match in both your MailChimp account and Cloud POS Back Office?
- Is your MailChimp account suspended?
If none of the above apply, please contact the Citrus-Lime support team for further investigation.
You'll need to switch these automations over to the new audience. To do so, you'll need to create a new automation and target the newer audience instead. Luckily, you can quickly save any automated emails as templates to then import into your newer automations: