Use Documents Seller - Mailchimp to add customers to Mailchimp audiences and assign groups and tags when their orders are confirmed. Configure the selections for each document, so customers receive follow-up messages relevant to the products they buy.
In your Mailchimp account, create the audience you want to use and any groups or tags you want to assign. The document editor lets you select existing audiences, groups, and tags from that account.
Generate a Mailchimp Marketing API key:
See Mailchimp's About API Keys guide for the current instructions. Keep the key private and update the plugin settings if you replace it or it expires.
Double opt-in applies to new contacts. Existing contacts keep their current subscription status; purchasing a document does not automatically resubscribe an unsubscribed contact.
| Setting | Effect |
|---|---|
| Audiences | Add the customer to each selected audience. |
| Groups | Assign the customer to the selected groups. Each option includes its audience and group category. Selecting a group also includes its audience, even if you do not select that audience separately. |
| Tags | Apply the selected tags. Each option includes its audience. Selecting a tag also includes its audience. |
For example, create a Template Buyers tag in your Store Customers audience and select that tag for a template document. When an order for the template is confirmed, the integration adds the customer to Store Customers and applies Template Buyers.
For a cart containing several documents, the plugin combines their audiences, groups, and tags. Repeated selections are applied once. It adds the selected groups and tags without removing other group memberships or tags from an existing contact.
Selections are made per document. To add buyers of every product to the same audience, select that audience, or one of its groups or tags, on each document. If a document has no selections, it contributes no Mailchimp subscriptions to the order.
Orders with a zero total also trigger the integration when Documents Seller confirms them at checkout. Guest customers can be added because the integration uses the order's email address; a Joomla account is not required.
If the settings appear correct, check dms_mailchimp.php in the Joomla log folder, or ask your site administrator to check it. Failed subscription requests are logged with the order ID. A Mailchimp request failure does not stop the order from completing.