Last modified July 15, 2020 by Shelly Wolfe

Mandrill

mandrill_logoMandrill is a transactional email delivery and management service offered as an add-on for Mailchimp. Trigger custom and template-based emails from Swrve based on user actions within the app with Swrve’s Mandrill integration.

Supported actions

Swrve’s Mandrill integration supports the following actions:

Outbound actions

  • Send a custom email
  • Send a template-based email

Inbound actions

  • Process email delivery and email engagement events from Mandrill

Use cases

Transactional emails

Transactional emails are sent in response to a user’s real-time action in the app. For example:

  • Send a welcome email after the customer completes the sign up process.
  • Send a purchase receipt email after the customer completes a purchase.

Using the Mandrill connector, Swrve triggers a transactional email upon receipt of a selected user action that is configured as a mobile event. There are two main steps involved in triggering transactional emails via the Mandrill integration:

  1. Create a custom event in the Swrve SDK for the user action that you want to use to trigger the email send process; for example, registration_complete.
  2. Create a rule in Swrve that is triggered on receipt of the designated event and uses the Send Custom Email or Send Template Email action to send the email.
The Send Custom Email and Send Template Email action configuration includes mandatory fields, such as the To and From email address. If the values vary by user and you want to include them as dynamic content when configuring the rule, ensure the values are included as part of the trigger event payload or set up in Swrve as a user property. If any of these values are the same for all the emails (for example,  From Email), you can configure it manually when setting up the rule.

Update user properties

The Mandrill connector sends email delivery and engagement events to Swrve, which you can use as part of your campaign engagement analysis or to trigger actions in Swrve. For example, if a customer unsubscribes from receiving emails, use the receipt of the Unsubscribe event to trigger a rule in Swrve that updates the value of a user property called email_unsubscribed to true. You could then target those users with a push notification instead.


Mandrill configuration

In most instances, your CSM will set up your Mandrill configuration, however you might need to provide them with certain credentials. To view your active Swrve integrations, on the Manage menu, select Adaptors.

Step 1: To access the configuration settings, on the Mandrill card, select Configure.

Step 2: Complete the following fields as required:

Field Description
API Key The Mandrill API key.

Step 3: To save the configuration settings, select Save.

After you select Save, the configuration status changes to Active and the Deactivate button is available. If you Activate or Deactivate the configuration at any time, the changes apply to both the outbound and inbound actions.


Mandrill actions

This section describes the fields that are included when creating a new rule using the selected action. For certain inbound actions, Swrve automatically creates a rule, while your CSM will likely configure any outbound actions. Most fields have the option to manually enter the value or to select a user property from the list to have Swrve automatically populate the value when the rule is processed.

Send custom email

Triggers a fully composed email that is sent from Mandrill. Complete the following fields to include the values required to send the email.

Field Description
To Comma separated list of recipient email addresses.
From Email The sender’s email address.
From Name The sender’s name.
Subject The subject of the email message.
Text Body The plain text content of the email message.
HTML Body The HTML content of the email message.
Global Merge Variables Global Merge variables are used to personalize the email with user-specific values. Each variable is used to inject text into the email body.
BCC BCC recipient email address. (Optional)
Reply To Comma separated list of Reply To email addresses, including aliases if applicable. (Optional)
Async Enables a background sending mode that is optimized for bulk sending. (Optional)
IP Pool The name of the dedicated IP pool previously setup at Mandrill to send this message.
Send at Timestamp The date used in the email header. The date must be coded in UTC text format. (Optional)

Send template email

Triggers a template-based email that is sent from Mandrill. Complete the following fields to include the values required to send the email.

Field Description
To Comma separated list of recipient email addresses.
From Email The sender’s email address.
From Name The sender’s name.
Subject The subject of the email message. (Optional) If the selected template includes a Subject value, this value overwrites it.
Template Name The email template (slug) to use with this email. Email templates are managed in Mandrill.
Template Content Content that you want to include in the email that is auto-populated with custom values, based on a payload included in the selected property. (Optional)
BCC BCC recipient email address. (Optional)
Reply To Comma separated list of Reply To email addresses, including aliases if applicable. (Optional)
Global Merge Variables Global Merge variables are used to personalize the email with user-specific values. Each variable is used to inject text into the email body.
Async Enables a background sending mode that is optimized for bulk sending. (Optional)
IP Pool The name of the dedicated IP pool previously setup at Mandrill to send this message.
Send at Timestamp The date used in the email header. The date must be coded in UTC text format. (Optional)

Inbound actions

The Mandrill inbound actions use webhooks with the Mandrill system to receive asynchronous email delivery and engagement events. The webhooks are set up when you activate the Mandrill integration. Mandrill sends the following events to Swrve:

Event Description
Click Recipient clicked a link in the message. You need to enable Click Tracking to receive this type of event.
Hard Bounce The message was hard bounced.
Opened Recipient has opened the message. You need to enable Open Tracking to receive this type of event.
Rejected The message was rejected. For more information about rejection reasons in Mandrill, see About Rejected Emails.
Sent Message has been sent successfully.
Soft Bounce Message has soft bounced.
Spam Report The recipient marked the message as spam.
Unsubscribe Recipient unsubscribed.
Delayed Message has been sent, but the receiving server has indicated mail is being delivered too quickly and Mandrill should slow down sending temporarily (not exposed in Reports UI).