MailChimp Campaign

MailChimp campaign is a complementary module for the MailChimp module, which allows you to create campaigns from within your Drupal site.

It leverages standard Drupal nodes for preparing your campaign content and does all the work of sending it to MailChimp using their API. As it uses nodes you can format your content any way you'd like, including using nodereference fields to pull in and display other nodes, or maybe embed Views in your node to show lists of content. Basically anything you can do with CCK based nodes you can send to MailChimp as a campaign.

It integrates with MailChimp using their 1.3 API. In its current incarnation it handles almost all the parameters in campaignCreate (see http://apidocs.mailchimp.com/rtfm/campaigncreate.func.php) but not all have been fully tested. Most importantly it handles segmentation so you can send your campaigns out to segments of your list, e.g. interest groups.

How to use

To use this module you must first install it and then set about configuring your content type to be used for your campaigns. Once you have created a content type for your campaigns you will want to set up some defaults to be inherited by each node created for this content type. To do so you can edit the content type and you'll notice the Mailchimp Campaign fieldset has all the API parameters ready to be filled in.

If you're just creating a basic newsletter a simple node with a title and body may suffice, but to do anything fancy you'll probably want to pull in other nodes and using nodereference fields and format them nicely. We do all the fancy formatting using hook_preprocess_node but you may want to do it in your own way. Up to you.

Once you're satisfied with the content type and its style and content you can send to your campaign to MailChimp using the 'Send campaign' local task button. This will start the process but not actually trigger a send until you're completely ready. Clicking the 'Prepare campaign' will create it in MailChimp as a draft and if you're satisfied its going to the right people clicking the 'Send campaign' button will trigger it to send immediately. If you aren't ready to send or want to make changes use the 'Re-prepare campaign' button which will delete the draft from MailChimp and take you back a step.

Reports

Once a campaign has been sent you can view some statistics on the performance of the campaign on the 'Campaign results' tab. There is also a month report (in admin/reports/campaigns) that displays a graph of open and click percentage so you can see how your campaigns are doing.

Module Status

The module is currently under development and is not ready to use in a production environment. Your feedback is greatly appreciated.

Dependencies

The only dependency is the Mailchimp module.
If you'd like fancy graphs you'll need to install the Libraries module and the Flot module (dev version). Download the flot library from http://code.google.com/p/flot/ and extract it as a sub-directory called 'flot' in your sites/all/libraries directory.

Coming soon

The ability to schedule a campaign to send at a particular time.

Downloads