Table of contents
Overview
The module being developed by Commerce Guys is built on top of Drupal, and leverages specific features that are added to Drupal by the Drupal Commerce module. This means that:
- Most features are available to all Drupal users
- Some features will only be available to Drupal + Drupal Commerce users
Objectives
The main objectives of the module were:
| Feature | Benefit to Merchant | Why MailUp? |
|---|---|---|
Multi-list email preferences at registration (Drupal) and checkout (Drupal Commerce) | John Smith may want to receive Weekly Specials, but not Daily Promotions. These cannot be groups (or whatever other ESPs call them): if John Smith unsubscribes from Daily Promotions, he should NOT be unsubscribed from Weekly Specials. | MailUp is a multi-list environment. |
| Group preferences within lists | John Smith may want to receive Weekly Specials for "Male" customers, not "Female". The List is "Weekly Specials", and two groups are displayed: "Male" and "Female". The module supports this granular level of subscription preference. | MailUp supports group assignments within Lists. |
Two-way email preference synchronization | Customers may update their email preferences in the storefront's account area or in the email messages themselves (unsubscribe link). | The MailUp API allows for the update of the email preferences from Drupal to MailUp. Webhooks in MailUp allow for communication back to Drupal (e.g. when someone unsubscribes in the footer of the email). |
Transfer of key data from Drupal to MailUp | Segmentation and email automation based on that data. Data may include information about the customer as well as transaction data. Drupal exposes many variables as "tokens". With the MailUp module, tokens can be easily mapped to custom fields in MailUp. When Drupal Commerce is installed, many more ecommerce-specific variables are exposed as tokens (e.g. latest order amount). | MailUp has strong email automation and segmentation tools. |
Availability of MailUp within Drupal as an SMTP relay channel | Increase deliverability and obtain statistics for transactional emails sent directly by Drupal. NOTE: this ended up NOT being part of the Commerce Guys module, because there is already support for SMTP relay in Drupal via this module: https://www.drupal.org/project/smtp | MailUp has a built-in SMTP relay. |
Old module ("MailUp Integration")
Some time ago a basic integration between MailUp and Drupal was developed to address the simple need of adding MailUp list sign-up form to a Drupal site.
- The module helps you to manage users subscriptions and synchronization (see an example).
- From the administration section, you can easily customize your website and enable the features you need
You can download this module here: https://drupal.org/project/mailup_integration
The module is not compatible with Drupal 7.
After the set up of Drupal module for MailUp you can
- Select a subset of MailUp lists and make them available for subscription in the registration form of your Drupal powered website. Selected MailUp lists can be locally renamed on Drupal.
- Specify one or more groups in which list subscribers are added.
- Map Drupal user profiles with MailUp personal data fields and keep synchronization for each Drupal user that is subscribed to MailUp lists.
- Let Drupal user change his/her profile and subscriptions, keeping these data synchronized with MailUp.
- Export existing Drupal users on a XML or CSV file that is compatible for manual import on MailUp admin console.
Export existing Drupal users to MailUp lists/groups by using a specific function in the admin panel. In case of big numbers of users (e.g. several thousands) you can also enable an option that splits users list in several blocks and programs export of each block by using a cron.
For more information, please refer to the online Drupal Handbooks. You may also post at the Drupal forum or view other online support options.
Features available to all Drupal users
- Connect Drupal to MailUp
- Activate N lists in Drupal of the M lists that exist in the MailUp account (e.g. the MailUp account may have 5 lists, of which 3 will be shown to users that register/checkout on the Drupal site)
- Display the lists on the Drupal user registration page
- Display a link to a sample message
- Personalize:
- List name
- List description
- Sample message name
- Support for Groups within Lists:
- For each List, the module retrieves Groups from the MailUp account
- User can activate which groups should be:
- Selected by the customer at registration: use case: customer subscribes to "Weekly Specials" (List) for "Men" (Group), but not "Women" (Group)
- Preselected and hidden: use case: all customers are automatically added to the hidden group "Online store" so that you always know in MailUp where they came from (for marketing channel attribution)
- When a user registers a call is immediately made to the MailUp API to add the user to the list(s) and group(s) selected
- Tokens (i.e. merge tags) in Drupal can be mapped to Recipient Fields in MailUp
Features available only to Drupal Commerce users
- Tokens made available by Drupal Commerce can be mapped to Recipient Fields in MailUp (transaction data). This feature is key because it allows for the transfer of commerce data from Drupal Commerce to MailUp: that data can then be used in segmentation and email automation related to the transactions that happened in the store.
- RSS feeds created by Drupal Commerce can be used in MailUp (e.g. new products)
Commerce Kickstart
Installing Drupal and all the modules needed to run Drupal Commerce could take some time. Commerce Kickstart is an "all in one" solution to get started, and it will include the MailUp module once ready.
- Description in the Drupal marketplace: https://drupal.org/project/commerce_kickstart
- Documentation on Drupal Commerce Web site: http://www.drupalcommerce.org/commerce-kickstart-2
Screen shots
MailUp lists imported into Drupal via the module: the admin can now pick which lists to show at registration / checkout (and which groups to show within each list, if any).
Lists and groups during checkout on Drupal Commerce
Mapping tokens to MailUp custom fields in Drupal via the MailUp module.
Configuration values provided by the Drupal module to create a Webhook in MailUp that notifies Drupal automatically when someone unsubscribers, for example.
