MailChimp Application by Kibo eCommerce

Configuration Guide

Current Version: 1.1.0 (March 2015)
Install: Kibo eCommerce App Marketplace
More Info: Version History

MailChimp provides online services for crafting and generating refined email campaigns to promote your business to current and potential customers and shoppers. With a few images, written content, and selections, your emails go from simple data with a few links to stylish, informative marketing pieces sent to key audiences based on subscriptions and configured settings. MailChimp helps you generate better business by marketing to your Kibo eCommerce customers through campaigns, reducing costs and lost time and money spent on design.

The MailChimp Application by Kibo eCommerce leverages MailChimp's services to integrate with your Kibo eCommerce customer accounts, subscribed shoppers, and completed orders. Through your Kibo eCommerce app, you can sync your MailChimp mailing lists with Kibo eCommerce subscribers, build email campaigns in MailChimp, and generate emails using your subscribed mailing list customers in your Kibo eCommerce store.

Application Features

The following occurs between Kibo eCommerce and the MailChimp app:

Install the App

You can install the MailChimp Application by Kibo eCommerce directly from the Kibo eCommerce App Marketplace:

  1. Go to: www.kibocommerce.com/marketplace
  2. In the Search field, enter: MailChimp
  3. Click the app icon.
  4. On the app page, click Install Now.

Configuration Requirements

To configure MailChimp to work seamlessly with Kibo eCommerce, you need specific items installed and settings provided. This guide details each step from requirements to final configuration for syncing contacts and generating email campaigns.

You must meet the following criteria to configure the MailChimp app:

Initialize the App

Prior to creating campaigns and sending emails, you must initialize then enable the MailChimp app.

Configure MailChimp Account Settings

To initialize the app, you add the API Key and link one site to one list. Kibo eCommerce only supports one site per tenant at this time.

  1. In Admin, go to System > Customization > Applications.
  2. Click MailChimp.
  3. Click the Configuration link to open configuration settings.
  4. On the Settings tab, enter your MailChimp API Key. To find this key:
    1. Log in to your MailChimp account.
    2. Go to the Account page and click Extras > API keys. A list of keys appears.
    3. If you do not see an existing API key, click Create a Key and follow the prompts.
    When you click outside of the field, Kibo eCommerce contacts MailChimp to establish the connection. On success, a green checkmark displays. When selected, click out of the list to save the change.
  5. Data of available lists fills the List Name drop-down menu.
  6. Select a List Name to associate between Kibo eCommerce and MailChimp. Kibo eCommerce only supports one list per tenant at this time.
  7. When selected, the association automatically verifies and displays. The app page updates displaying Initialized: true.

Find the MailChimp API Key

  1. Copy and paste the long API Key into the Kibo eCommerce App.

The API Key grants access to sync contacts and send email campaigns.

Enable the App

With the app initialized, you can enable the app:

  1. In Admin, go to System > Customization > Applications.
  2. Click MailChimp.
  3. Click Enable App on the MailChimp page.

Configure the App

To integrate your MailChimp services with Kibo eCommerce, you need to sync the data. The applications require at least one import and export to connect and update. You can perform a manual sync of data through imports and exports. Any manual jobs add a completed log file to the History tab.

Once connected, MailChimp and Kibo eCommerce share data for customer accounts and contacts. All new accounts are created in Kibo eCommerce. MailChimp manages and provides updated opt in/out settings from received email requests. All data is maintained in Kibo eCommerce and shared with MailChimp.

Import MailChimp Contacts

With your Kibo eCommerce and MailChimp accounts newly connected, you should import your MailChimp contacts. The shared data updates the opt in/out settings for your Kibo eCommerce customer accounts/contacts. Once synced, if a MailChimp contact changes their status, it automatically syncs and updates to Kibo eCommerce.

  1. In Admin, go to System > Customization > Applications.
  2. Click MailChimp.
  3. Click the Configuration link to open configuration settings.
  4. On the Data Sync tab, select the Synchronization Type as Import MailChimp Customers.
  5. Click Schedule Sync. A job begins to update subscribed and unsubscribed customers with your contact list.
  6. A new record adds to the History tab.

Export Kibo eCommerce Customers

With your Kibo eCommerce and MailChimp accounts newly connected, you should export your Kibo eCommerce customers. These customer accounts add as new MailChimp contacts or update the subscription settings for current contacts. This data also includes any Kibo eCommerce customer segments.

Once synced, Kibo eCommerce adds any current subscribers to MailChimp contacts. Any new or removed subscribers automatically update between Kibo eCommerce and MailChimp. Once synced, if a Kibo eCommerce customer changes their opt-in status, customer data changes in Kibo eCommerce, or the customer segment(s) change in Kibo eCommerce, it automatically syncs and updates to MailChimp.

  1. In Admin, go to System > Customization > Applications.
  2. Click MailChimp.
  3. Click the Configuration link to open configuration settings.
  4. On the Data Sync tab, select the Synchronization Type as Export Mozu Customers.
  5. Click Schedule Sync. A job begins to update subscribed and unsubscribed customers with your contact list.
  6. A new record adds to the History tab.

Export Kibo eCommerce Orders

With your Kibo eCommerce and MailChimp accounts newly connected, you should export your Kibo eCommerce orders. Only the completed orders are exported into Kibo eCommerce.

  1. In Admin, go to System > Customization > Applications.
  2. Click MailChimp.
  3. Click the Configuration link to open configuration settings.
  4. On the Data Sync tab, set Synchronization Type to Export Mozu Orders.
  5. Click Schedule Sync. A job begins to export all completed order data associated with customers to MailChimp.
  6. A new record appears on the History tab.