Brightpearl have teamed up with MailChimp to provide an integrated email marketing service.
With this Brightpearl App, contacts and segmentation are managed in Brightpearl and automatically synchronized with MailChimp mailing lists and interest groups. The email campaigns sent from MailChimp will be recorded on the contact timeline in Brightpearl allowing you to see a full history of communications. When using MailChimp’s premium feature Ecommerce360, order data collected in Brightpearl will be sent to MailChimp for reporting on visitors drawn from campaigns and the purchases they made.
Installing and connecting MailChimp
The MailChimp app is activated within the Brightpearl App Store. Once the app has been added to your account you will find the settings menu added at Settings > Brightpearl apps > MailChimp from where the app is connected and configured.
Mapping tags to MailChimp groups
Contacts are uploaded to MailChimp from Brightpearl when they are assigned a Brightpearl Tag which is mapped to a MailChimp List, and when the contact's 'Receive email newsletters' is set to Yes.
MailChimp says 'it's a good idea to manage one master list, and use groups to organize subscribers', in effect that you should map your Brightpearl contacts to a single list. In any case, each tag can be mapped to one or more lists in MailChimp:
Upon saving the tag mapping Brightpearl will synchronize with the MailChimp list looking for groups with the same name as the tags, and where no match is found a new group is created. This means that all the mapped tags exist as a group on the list, without any duplicates. Note that any existing groups on the MailChimp list will not download into Brightpearl.
Tags will only attempt to connect with group names which are within a single group title of "Brightpearl". If this group title doesn't exist for the list when the sync occurs, the app will create the group title and all the tags as new group names, regardless of whether a group of the same name exists under a different group title. When connecting a MailChimp account which already contains groups, it is possible to rename one title on each list to "Brightpearl" so that those group names can be used.
When a tag is successfully synchronized with a list, it is indicated with a check mark on the Brightpearl list of tags at Settings > Contacts > Tags :
This is what it will look like in MailChimp:
Adding groups within MailChimp
A group name added directly in MailChimp will not download into Brightpearl. When this occurs, a tag will need to be manually created in Brightpearl and then mapped to the relevant MailChimp list within the app settings. Note that the group must be added under the group title of "Brightpearl".
Uploading contacts to MailChimp
Both customers and suppliers can be uploaded to MailChimp, but they must meet these criteria:
- They must have an email address
- They must be set to receive email newsletters. This setting is found on the customer/supplier record and can also be updated via the customer/supplier import or batch processing on the customer/supplier list.
This setting can be reviewed for each customer/supplier by adding the Newsletter/Mailmerge column to the customer/supplier list:
A contact is uploaded to MailChimp when:
- They are assigned a Brightpearl tag which is mapped to a MailChimp list
- A tag already assigned to the contact is now mapped to a MailChimp list
The contact will be added to the relevant MailChimp list and assigned to the group with the same name as the tag. If no group of the same name is found, it will be created in MailChimp as part of the sync.
A single tag can be mapped to multiples lists, in which case the contact will be added to each list once and assigned the group from each list.
A contact can be assigned multiple tags which are mapped to MailChimp. The contact will be added to a list once and assigned to each group.
A tag can be added to a contact in several ways:
- The contact completed an online Brightpearl SmartForm
- The contact was assigned the tag in Brightpearl
- The contact was assigned a tag when it was imported into Brightpearl
Editing and updating MailChimp contacts
The following details can be updated by the app:
- First Name
- Last Name
Contact details will be kept in sync between Brightpearl and MailChimp by looking for a matching email address every time a contact is saved in Brightpearl. If a contact is amended in Brightpearl the matching record will be updated in MailChimp.
If a contact is amended in MailChimp the matching record will be updated in Brightpearl only if the option has been activated on the app settings at Settings > Brightpearl apps > MailChimp . When active, each time a profile is saved in MailChimp the app will look for a contact with the same email address in Brightpearl to update.
Editing email addresses
If an email address is edited in either system this will cause the contacts to no longer match and to be treated as a new contact. This means that a new contact will be created in MailChimp with the new email address.
Deleting and merging MailChimp contacts
A contact which is deleted in Brightpearl, or removed by merging it into another contact, will not be removed in MailChimp. If this happens, you will need to manually unsubscribe or remove the contact directly within MailChimp. Alternatively, you can first untag the contact in Brightpearl, which will update MailChimp, and then delete them or remove them by merging into another Brightpearl contact.
Double opt-in emails for MailChimp
Contacts which are uploaded to MailChimp from Brightpearl will receive a double-opt in email if specified in the below setting.
With this set to Yes, the contact will be set to a pending state until they click the link in the email confirming their subscription to the mailing list. Find our more about double opt-in here.
Untagging and retagging with MailChimp mapped tags
If a tag, which is mapped to MailChimp, is removed from the contact in Brightpearl then the person will also be removed from the group in MailChimp. If the contact has other tags which are mapped to the same MailChimp list then they will remain subscribed to the list and in those groups. Whilst the contact remains on the list the contact can be added and removed from the groups using Brightpearl tags. However, if the contact is removed from all groups on the list then they will be entirely deleted from the list.
If a contact is assigned a tag after they have been deleted by Brightpearl then they will be resubscribed. But if the contact is assigned a tag after they have been unsubscribed via MailChimp admin or a MailChimp email then they cannot be added again from Brightpearl. If a contact wishes to resubscribe it must be done from MailChimp using their confirmation processes which ensure that this person wishes to be resubscribed. Learn more about how a contact can resubscribe in the MailChimp knowledge base .
If a contact is unsubscribed through MailChimp the contact will be removed from the list but can bee seen on the unsubscribed list. If you would also like the tags to be removed in Brightpearl this must be activated within the app settings. If this is activated later, after a contact has already unsubscribed, the tag will not be removed.
When a tag is automatically removed due to an unsubscribe notification from MailChimp, a note will be added to the contact timeline. If the tag removal was not successful, this will be indicated within the note on the contact timeline and the removal will need to be completed manually.
Unsubscribing and resubscribing contacts on MailChimp
A contact which is unsubscribed from a MailChimp list is removed from all the groups and will no longer be listed as a subscriber. They cannot be resubscribed without obtaining confirmation from the contact that they wish to be resubscribed. Learn more about how a contact can resubscribe in the MailChimp knowledge base
A contact will be unsubscribed from a MailChimp list when any of the following occur:
- The contact unsubscribes via an email sent from MailChimp
- All mapped tags for a list are removed from the contact in Brightpearl
Uploading order data to MailChimp (eCommerce360)
eCommerce360 is a MailChimp feature that allows order data to be recorded for contacts. On the premium version of the feature, order data is used to automate segmentation of contacts.
Order sync must be activated on the app settings at Settings > Brightpearl Apps > MailChimp, and one or more sales statuses must be chosen to sync.
When an order is placed onto one of the selected order statuses it will be uploaded to MailChimp, as long as:
- The order already has a channel assigned
- The contact already has a mapped tag assigned
If an order is not uploaded due to the contact not having a mapped tag, or the order not having a channel, the upload can be retried by ensuring those things are done, and then switching the order off the status and back onto the sync status.
The following sales order information will be uploaded to MailChimp from Brightpearl:
- Channel name (store)
- Brightpearl order ID
- Customer email address
- Order total (gross)
- Order total tax
- Order shipping cost (amount against the accounts default shipping nominal)
- Order date
- Brightpearl product ID
- Product name (on order)
- Product SKU
- Product category ID
- Product category name
- Row total (gross)
Email campaigns are created and sent directly within MailChimp. When an email is sent to a contact a note will be added to the contact in Brightpearl.
FAQs - MailChimp App
What happens if a group name is edited in MailChimp?
Editing a group name in MailChimp will not update the matching tag in Brightpearl. If the group name is edited it will no longer match the Brightpearl tag name, and this means that when the next sync occurs (either by saving the settings or by tagging a contact) Brightpearl will not find a matching group and will therefore create a new group using the tag name.
What happens if a tag name is edited in Brightpearl?
Editing a tag name in Brightpearl will not update the matching group name in MailChimp. If the tag name is edited it will no longer match the MailChimp group name, this means that when the next sync occurs (either by saving the settings or by tagging a contact) Brightpearl will not find a matching group and will therefore create a new group using the new tag name. The old group will remain in MailChimp with the original name and a new group will exist with the new tag name.