Configuring the Mailchimp Integration with E-commerce support module
page last edited on 11 September 2017
The settings and preferences for the addon “Mailchimp Integration with Ecommerce support” can be adjusted on the addon settings page in your X-Cart store’s Admin area.
In the Mailchimp settings section of the page, the following settings can be adjusted:
Mailchimp API key: The API key that was used to connect your X-Cart store to your Mailchimp account. If, for some reason, you need to use a different Mailchimp account or a different key, use the “Reset Mailchimp connection” link.
Enable E-commerce analytics: This option enables E-commerce analytics by Mailchimp for your X-Cart store. For details, see the article Use Mailchimp for E-Commerce in Mailchimp Knowledge Base. E-commerce analytics is the core component of the integration functionality; the setting is enabled by default, and we recommend keeping it that way. When the E-commerce analytics option is enabled, the settings page for the module includes the E-Commerce features setup section. Be sure to visit that section and specify the lists for which Ecommerce Stores need to be created on the Mailchimp end. See the E-Commerce features setup section further below for more info. Important: Be sure also to enable E-Commerce Link Tracking for your campaigns and automations in your Mailchimp account back end.
Enable Abandoned Carts: This option enables the Abandoned Carts feature. For more info on this feature, see the Mailchimp site
Enable single opt-in for customers: This setting defines whether customers who opt in to subscribe to your news lists should be asked to confirm the subscription via email, or not. When this option is disabled, new subscribers get an email containing a subscription confirmation link that they need to click to be added to your list (Double opt-in). When this option is enabled, new subscribers are added to your list as soon as they opt in, without having to confirm the subscription by email (Single opt-in). Remember that abusing the single opt-in option may get your account banned by MailChimp.
Subscription select element type (Type:checkbox or Type:select box): This setting defines the way your customers select a subscription. If the select box option is enabled here, your customers can subscribe to only one mail list; if the checkbox option is enabled, your customers can subscribe to multiple lists.
Update Mailchimp lists every (Never, 1 minute, 10 minutes, etc.): Select the time interval for the periodical list updates.
E-Commerce features setup
The E-Commerce features setup section of the module settings page enables you to control the upload of store data (products, orders, carts and customers) to Mailchimp.
Uploading your store data to Mailchimp enables you to take full advantage of Mailchimp Product Recommendations and Abandoned Carts. For the best performance of these features, the products, orders, carts and customers from your ecommerce store need to be uploaded to Mailchimp and organized as a Store. On the Mailchimp end, a Store is the top-level e-commerce resource. Carts, Customers, Orders, and Products all exist inside of the scope of a Store.
Each Store in Mailchimp needs to be tied to a Mailchimp list.
In the E-Commerce features setup section of the module settings page in X-Cart, you specify the lists for which Mailchimp Stores need to be created and initiate the upload/syncing of store data.
First, you need to select the check boxes for the lists you require and click Update. This saves the set of MailChimp lists for which Stores should be created.
To initiate the upload of store data for the selected lists, click Upload store data to Mailchimp. Mailchimp will create the Stores and will connect them to the Mailchimp lists you have specified. Store data from X-Cart will be uploaded to these specific Stores. After the initial synchronization, further synchronization of store data will be done on the go automatically, without the need to click the Upload store data to Mailchimp button; for example, when a new cart or a new order are created in your X-Cart store, the respective information will be automatically submitted to Mailchimp.
The button Upload store data to Mailchimp remains in the E-Commerce features setup section just in case you need to redo the synchronizion; for example, you may need to use the button again if things get desynchronized between your store and your Mailchimp account after you disable the module in X-Cart temporarily.
Another button - Update store data - will help you to update your company information on the Mailchimp end (for example, if your company name or address change).
Help make this document better
This guide, as well as the rest of our docs, are open-source and available on GitHub.