Mailmodo

Introduction

Mailmodo, one of MoEngage's Technology Partners, enables you to create interactive email templates to increase user engagement and marketing ROI using Emails. 

MoEngage <> Mailmodo

Mailmodo is an AMP email solution and with the integration, you can:

  • Use the MoEngage Segmentation module to send emails to targeted users.
  • Use Mailmodo for email template creation and use MoEngage connector campaigns to trigger emails. 
  • Use the existing SendGrid account or set up Mailmodo SMTP to send emails from Mailmodo.
  • Use Mailmodo's campaign activity data inside MoEngage while segmenting users or creating flows.

Integration 

library_add_check

Prerequisites

Ensure you have a Mailmodo account. 

When you sign up for a new Mailmodo account, a default sender ID is automatically added to your account for testing the platform. To send your actual campaigns with Mailmodo, you must add your own custom sender email address. For example, if your domain is 'www.abc.com', the custom sender email address could be 'hey@abc.com.'

Step1.gif

To set up a custom domain, go to the sender settings and enter the sender email. Then you have an option to select an email delivery service. After selecting one, a form appears, which you have to fill for it to be sent, requesting Google to whitelist your email address.

The approval process may take up to 7 days. You will get a confirmation email when it's completed. Once the email address has been whitelisted for AMP by Google, you will be able to send out dynamic AMP email campaigns through Mailmodo.

To learn more about adding a custom domain, read this.

Setting up MoEngage Integration in Mailmodo

  • By setting up the MoEngage integration, you will be able to create segments, campaigns, flows, or dashboards in MoEngage using their campaign activity data, for emails triggered with MoEngage as an external trigger.

Please note campaign activity data of campaigns triggered with MoEngage as an external trigger will only be sent to MoEngage. The overall campaign statistics like email activity trends, AMP vs HTML performance, top email clients, link performance, submissions, insights, etc will also be available in the Mailmodo campaign dashboard.

Sample use cases include triggering a push campaign in MoEngage for all the users opening or clicking a particular campaign from Mailmodo, or creating a dashboard of all the users submitting a form from Mailmodo.

Step2.png

The below-mentioned data will be sent back to MoEngage via the Events endpoint as Tracked User Events:

  • MM Email Opened
    • Campaign Name
    • Email Subject
    • Campaign ID
  • MM Email Link Clicked
    • Campaign Name
    • Email Subject
    • Campaign ID
    • Link URL
  • MM Email Form Submitted
    • Campaign Name
    • Email Subject
    • Campaign ID
    • Template ID
    • Template Name
    • Form ID
    • Form Name
  • MM <Template Name> Form Submitted
    • Campaign Name
    • Email Subject
    • Campaign ID
    • Template ID
    • Template Name
    • Form ID
    • Form Name
    • Form Submissions
  • MM Email Bounced
    • Campaign Name
    • Email Subject
    • Campaign ID

Steps to setup

Step 1: Go to Integrations from the left navigation menu

Step3.png

Step 2: "Click to Authenticate" on the MoEngage card from the Available For Connection section

Step4a.png

Step4b.png

Step 3: Select your Rest API Host from the drop-down

Step5.png

  • Please select the Rest API Host as per your Dashboard URL. The following table describes the dashboard URL, and the REST API hostname associated with it.
Dashboard URL Rest API Host
https://dashboard-01.moengage.com https://api-01.moengage.com
https://dashboard-02.moengage.com https://api-02.moengage.com
https://dashboard-03.moengage.com https://api-03.moengage.com

 

Please refer to the red highlighted box below for your Dashboard URL in MoEngage and select the associated Rest API Host from the above table

Step6.png

Step 4: For the APP ID in Mailmodo:

The App ID of your MoEngage account is available in the following navigations in the revamped and old UIs:

  1. Revamped UI:  Settings -> Account -> APIs -> Workspace ID (earlier App ID).
  2. Old UI: You can find this by navigating to Settings -> App Settings -> APIs -> Data API Settings.

The Data API ID and the Workspace ID of your MoEngage account are the same.

Step7a.png

Step7b.png

Step 5: For the Data API Key in Mailmodo:

The Data API key of your MoEngage account is available in the following navigations in the revamped and old UIs:

  1. Revamped UI:  Settings -> App Settings -> APIs -> API Keys -> Data
  2. Old UI: You can find this by navigating to Settings -> App Settings -> APIs -> Data API Settings.

Step8.png

Step9.png

If you've not generated a key, you need to click on GENERATE KEY and SAVE before using the key.

Step 6: Click on Test and Save.

Step10.png

For testing, we'll send a sample event with the name "MM Email Opened" with customer_id as "hello@mailmodo.com", which will reflect at MoEngage.

  • You're all set! If MoEngage sends a successful response, you'll see a "Setup successful" message, and the MoEngage card will move to the Connected Platforms section.

Please visit this article for more information MoEngage integration with Mailmodo.

Create Templates in Mailmodo

Mailmodo’s no-code/low-code template editor lets you create templates as per your need without needing any expertise in coding. You just have to drag and drop the elements into the template. You can create various templates such as newsletter templates, promotional email templates, feedback email templates, etc.

11.png

Mailmodo’s template also allows you to add different AMP widgets like Polls, Calendars, carts, Spin the wheel, Forms, etc. You can read these to find out how to add AMP widgets to your template. These widgets will help increase your engagement metrics. 

The template editor also has options for personalization. You can add first name, last name, contact info., email, etc., in the template. You also have some pre-made templates to work with if you want to avoid making the whole thing from scratch. 

Read this to learn more about the process of creating a template.

Create Transactional Campaign in Mailmodo

Step 1: Go to Transactional campaigns from the left navigation menu and click on New Transactional Campaign.

12.jpeg

Step 2: Select the required template and Click on Next.

13.jpeg

Step 3: Add Campaign Name, Subject Line, Pre-header Text, From Name and Reply to Email and Click on Next.

14.jpeg

Step 4: Select MoEngage as an External Trigger and Click on Next.

15.jpeg

Step 5: Click on Enable Campaign after reviewing and testing the campaign.

16.jpeg

Step 6: Copy the Webhook URL and use it for creating Connector Campaign in MoEngage.

17.png

For more information, please refer to Trigger Campaigns through MoEngage in Mailmodo.

Send Email Campaigns from MoEngage

Use the connector campaigns to send email campaigns from MoEngage. For more information, refer to Connector Campaigns.

Ensure you do the following in the MoEngage connector campaign when you send campaigns using MoEngage:

Step 1: Click Create New → Connector → Custom and Select one-time, periodic, or event-triggered as per your requirement.

18.png

Step 2: Add Campaign, name, Tags, and Select the audience as per your requirement, and Click on Next.

19.png

Step 3: Select POST under Method and from the Mailmodo Trigger Info section, copy and paste.

  • The Webhook URL from Mailmodo under Webhook URL in MoEngage
  • The Headers from Mailmodo under Headers in MoEngage
    • Key : content-type
    • Value : application/json;charset=utf-8

20.png

Step 4: In the Body Type, select Raw and Paste the body from the Mailmodo Trigger Info section.

If your Mailmodo template has personalization, then delete <Value for personalization parameter> in the MoEngage body, type @, and select the corresponding personalization attribute in MoEngage in the ensuing Connector Personalisation pop-up.

21.png

  • Please choose fallback as per your requirement for when personalization fails for the selected property in the above pop-up
  • For example, if your template has first_name then delete <Value for first_name>, type @, and select the First Name attribute in the ensuing pop-up.

22.png

Body from Mailmodo

JSON
{
  "email": "{{UserAttribute['Email']}}",
  "moengage_id": "{{UserAttribute['ID']}}",
  "data": {
    "first_name": "<Value for first_name>"
  }
}

Body type in MoEngage after personalization mapping

JSON
{
  "email": "{{UserAttribute['Email']}}",
  "moengage_id": "{{UserAttribute['ID']}}",
  "data": {
    "first_name": "{{UserAttribute['First Name']}}"
  }
}
  • Both email and moengage_id (customer_id) are mapped by default in the Mailmodo body. 
  • If you're storing email ID in any other attribute, delete the {{UserAttribute['Email']}} value, type @, and map it to that attribute.
  • Also, if you're manually mapping, map the moengage_id to the ID (a.k.a customer_id) attribute in MoEngage.
warning

Note

The moengage_id (a.k.a ID or customer_id in MoEngage) of the email recipients is mandatorily needed to push the campaign activity to MoEngage. Hence the same is configured in the body while setting up the MoEngage Transactional (Trigger) campaign. For more information, please refer to the article

  • Test the campaign using email ID and click on Next.

23.png

Step 5: Publish the campaign after entering requisite details like schedule date and time, conversion goals, delivery controls, etc in the Schedule and Goals step.

24.png

warning

Sending Requirement

Add Hard Bounce, Spam, and Unsubscribe criteria in Segmentation of the campaign creation manually to ensure your domain reputation is intact.

Personalization

  1. Use the personalization tag '${attribute_name}' to personalize subject lines, links, and images in Mailmodo.
  2. Ensure that the attributes with respective values are passed in the API call from MoEngage to populate the same and personalize templates.
  3. Ensure to use MoEngage User attributes in the attribute values to personalize the Mailmodo templates using MoEngage attribute personalization.
  4. Personalize Images in Mailmodo. For more about how to personalize images in Mailmodo Templates, refer to the How to use dynamic image feature in your campaign.

Analyze Campaign Data in MoEngage

  1. For more information about the analysis of campaigns, refer to Analyze emails in MoEngage.

  2. Export the response data from Mailmodo and use the exported data in MoEngage Data APIs.

Limitations of MoEngage <> Mailmodo Integration

  1. Templates created in Mailmodo cannot be synced back to MoEngage. Switch back to Mailmodo from MoEngage to view the AMP templates.
  2. A/B testing is based on Subject Lines and the distribution is always 50-50%.
  3. Locales are not available in Mailmodo Campaigns.
  4. MoEngage Content API is not supported in Mailmodo Campaigns.

 

 

Previous

Next

Was this article helpful?
0 out of 0 found this helpful

How can we improve this article?