This article provides information about various tabs in Email settings and also explains the procedure to configure your email channel. Follow the below steps to access the email settings:
- Login to MoEngage Dashboard.
- Navigate to Settings on the left-side panel.
- Under Channels, click Email.
Overview Tab
The Overview tab helps the user identify whether the senders configured are in MoEngage or App Marketplace. The Overview tab displays the number of senders configured in Moengage and App Marketplace separately. This tab contains the following two options:
-
Setup MoEngage email sender.
Under this option, you can view the number of senders configured via MoEngage delivery. Clicking View details redirects you to the Sender Configuration tab. If you are using MoEngage as your ESP this is where you will find your settings. -
Setup other email sender.
Under this option, you can view the number of senders configured via Moengage App Marketplace. Clicking View details redirects you to the App Marketplace. If you have configured your own ESP (ie other email senders), you will find them under App Marketplace.
Sender Configuration Tab
This tab helps you to configure the senders in MoEngage delivery. You can add any number of senders here. Follow the below steps to add a sender.
- Click Add Sender on the top-right corner of the screen.
- In the following Warning pop-up that appears, click Continue.
- In the following Add sender page, click on any sender you want to configure.
- Refer to the following articles for detailed steps to know how MoEngage configures each Email service provider listed below.
- Refer to the following articles for detailed steps to know how MoEngage configures each Email service provider listed below.
- After adding the sender, it will be displayed under Sender Configuration tab.
- Click the ellipsis icon () to Mark as default, Edit, Delete the added sender. Make sure to follow the below points while deleting a sender.
- You cannot delete a sender, which is marked as default.
- When you delete a sender, a pop-up appears that displays all the active campaigns associated with it. You need to stop each active campaign to delete the sender.
Configure Custom Connector
MoEngage can integrate with any SMTP connector for sending email campaigns. You would need to configure the connector, set up the unsubscribe mechanism, and optionally track bounces & complaints if your SMTP connector can post these details in the required format (as described later in the article)
Configure Custom SMTP Settings
-
-
- Sender Name: Provide a name for the Sender.
- SMTP Host Name: IP Address or server name of the SMTP connector service you are using
- SMTP Port: This is the SMTP port number of the connector service to which the connection would be established. To avoid the rate limits set by some hosting companies, we recommend using port 587 instead of port 25.
- SMTP Protocol: You can select the protocol prefix (SSL/TLS) that your connector supports.
-
SMTP Authentication: Select ON here if your SMTP connector requires authentication to establish the connection. Then, enter the SMTP credentials in the username and password.
-
Configure Custom Unsubscribe Settings
-
MoEngage Tracking will add MoEngage's unsubscribe page URL as the email footer - “If you'd like to unsubscribe and stop receiving these emails click here”.
By default, MoEngage redirects your customers to a standard landing page. The only option available there is to re-subscribe. If you want to navigate your customer to a custom landing page e.g. to capture the reason for their unsubscription etc, they can put a link to their own landing page in Unsubscribe Page URL as shown below:
https://api-0X.moengage.com/v1/emailresubscribe - MoEngage hosts each customer in a different data center; you can find your data center number (value of X) by checking the data center and API endpoint mapping here.
- Selecting None means MoEngage will not include unsubscribe links in your email campaigns. You are now responsible for including an unsubscribe link while creating the email content. If you don't do it in promotional campaigns, the chances of being identified as spam are high.
Configure List Unsubscribe Email
- If you select MoEngage Managed option, MoEngage will include its own mail-to and https URL in email's headers, in all non-transactional emails.
- If you select Self Managed option, enter the One-click unsubscribe URL and List unsubscribe email, so that MoEngage will include this in your mail-to and https URL in emails' headers, in all non-transactional emails.
Configure Custom Bounce and Complaint Settings
-
Bounce & Complaints Tracking: This URL needs to be configured on the ESP's dashboard. They will post events like delivered, bounced, spam complaint on this URL for MoEngage to consume and update stats against the corresponding campaign. MoEngage receive this information in a POST call in the below format to the URL mentioned in your Bounces & Complaint Tracking (Callback URL) field.
- Add the callback URL as shown below:
https://api-0X.moengage.com/v1/emailbounceendpoint/<>
MoEngage hosts each customer in a different data center; you can find your data center number (value of X) by checking the data center and API endpoint mapping here.
info |
Note Since we will not have the Campaign ID in case of this callback, we are unable to show the bounce and complaint details in Campaign Analytics for Custom SMTP Connectors. |
POST Format - list of JSON. In "event" you can pass "hard_bounce", "soft_bounce" or "spam" for each case.
[
{
"event": hard_bounce,
"data": [
{
"email":"abc@moengage.com"
},
{
"email":"bcd@moengage.com"
}
]
}
]
You are all set up with connector configurations. You can now click Save button to test these settings (including credentials etc.) and save them. You can then select Custom SMTP as the default connector in General Settings.
General Settings Tab
While creating new email campaigns, the settings from General Settings will be used as defaults.
- The sender that is marked as default, which can either be a MoEngage sender or non MoEngage sender, is listed under the Set a Default Sender field.
- In the User attribute that stores user's email address field, add Email (Standard). This is the MoEngage standard attribute name for the email attribute, where the name is provided by MoEngage, and the value is provided by the client.
- If you choose Email from the standard attribute with the correct connector configuration, we will track global opt-out against this email address.
-
Positioning of Open Tracking Pixel
MoEngage allows you to position a tracking pixel at the top or bottom of the email body, thereby tracking the open rates of emails sent to your customers. By default, the tracking pixel is at the bottom of the email to ensure high open rates. If you observe clippings in your email then you can select the Place tracking pixel at the top option to keep the tracking pixel at the top of the email body or else you can keep the tracking pixel at the bottom of the email body by selecting Place tracking pixel at the bottom option.
- Under From email address(s) section,
- You can add from email address by clicking the Add email address, In the following screen that appears, enter the following details:
- Add from Email Address, The verified email addresses are available in email campaign creation step 2 while creating content.
-
Select sender from the drop-down. Click Add.
- Add from Email Address, The verified email addresses are available in email campaign creation step 2 while creating content.
- You can view the list of all email addresses configured along with their Connector Type and Email Status.
-
Domain Reputation and Domain Reputation Trend
MoEngage shows the domain reputation and its trend for each unique and verified domain while adding a from email address in the email settings. For more information, refer to Domain Reputation.
- To delete an email address, click the Delete icon against it. When you delete an email address that has some active campaigns associated with it, this will stop sending the campaign.
- You can add from email address by clicking the Add email address, In the following screen that appears, enter the following details:
Subscription Management Tab
This tab contains two sub-tabs such as Opt-out management and Subscription Categories.
-
Opt-out Management Tab
Opt-out Management allows you to automatically exclude specific users from the email campaigns. This tab indicates that the campaigns marked as Spam, Bounce, or Unsubscribe will not be sent to the verified email address.
-
Subscription Categories
Subscription categories are a means to provide your customers with the flexibility to choose the kind of communication that they want to receive from your brand. For more information, refer to Configure Subscription Categories.
PII Tokenization
Personally Identifiable Information (PII) Tokenization in email campaigns is a security measure used to protect sensitive data. PII tokenization allows brands to not send PII data to MoEngage and fetch it only on a need basis while sending a message. For more information, refer to PII Tokenized Sending.
When PII Tokenizations is enabled, you are not be able to see User attribute that stores user's email address field under General Settings.
FC and DND
To limit the number of emails sent to users in a certain period, configure frequency capping settings. Do not disturb are quiet hours during which it is advisable not to send any messages to users. If a message is scheduled to be sent during do-not-disturb hours, you can either discard it or save it for after the do-not-disturb hours. For more information, refer to Frequency Capping and Do Not Disturb.