Community Documentation

Mailchimp Campaigns

Last updated April 30, 2013. Created by peterx on December 20, 2012.
Edited by batigolix, bjlewis2, Gys. Log in to edit this page.

Mailchimp Campaigns is a sub module of the Drupal 7 Mailchimp module that allows creating and sending campaigns, and viewing statistics from within a Drupal website.

Installation

The install file adds one table to list campaigns and one input filter format named MailChimp campaign. There is one entity added with the name MailChimp Campaign.

Add a Campaign

Add a list and a template first then switch on the campaign module then select Administration » Configuration » Web services » MailChimp then the Campaigns tab and add a campaign.

Enter a Title, Subject, and select a List. The From Email and From Name default to the site settings.

Now you select a Template from a list. The template has to exist before you add the campaign. The page appears to let you edit the template. I have not tested edits. There is no way to create a new template and no link to the MailChimp template creation page.

Creating Campaigns

  1. Click Add a Campaign in the overview
  2. Fill out the required fields
    • Title: An internal name to identify the campaign
    • Subject: Message subject
    • List: The MailChimp list to use
    • From Email: Email address for the campaign
    • From Name: Name for the campaign messages
    • Template: MailChimp template to use
    • Content Sections: Each section (if applicable) of content for the campaign
    • Text format: Choose between MailChimp campaign and Plain Text (see Using MailChimp Macros)
  3. Click Save as draft

Once saved as a draft, the new campaign will be available in both Drupal and
MailChimp as a draft until it is sent. After sending, campaigns can no longer
be edited.

Using MailChimp Macros

This module includes a special text format called MailChimp campaign,
allowing the use of macros to insert Drupal content into campaigns.

Format

[mailchimp_campaign|entity_type=node|entity_id=1|view_mode=teaser]
As a test you can use this exact (!) string in the content area to show the contents of node 1 in teaser mode.

Options

  • The first item, mailchimp_campaign, identifies the macro
  • entity_type specifies which type of entity to use
  • entity_id identifies the entity by ID
  • view_mode specifies which view mode to use

Usage

Macros may be inserted into any text area that is set to use the MailChimp
campaign
text format. Upon saving a campaign, macros will automatically be
replaced with the specified node content.

Troubleshooting

Campaigns, lists, or templates have not updated from MailChimp

Try clearing the Drupal cache and reloading the page.

Cannot edit a campaign

Check to see if the campaign has already been sent. Sent campaigns cannot be
edited.

Page status

About this page

Drupal version
Drupal 7.x
Level
Beginner, Intermediate
Audience
Site administrators, Site builders, Site users
Keywords
email, mailchimp

Site Building Guide

Drupal’s online documentation is © 2000-2013 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution-ShareAlike 2.0. PHP code is distributed under the GNU General Public License. Comments on documentation pages are used to improve content and then deleted.
nobody click here