Track Email Unsubscribes

When users unsubscribe to your marketing emails, MoEngage ensures that no further emails are sent to them. You can manage these unsubscribes in multiple different ways. This provides you with the highest amount of control over the handling of the unsubscribe link. 

MoEngage Tracking

If you select MoEngage tracking, MoEngage will add a one-click unsubscribe link in the non-transactional email. 

  • Clicking on the link will lead the user to a Landing page. MoEngage provides a default option for this, which can be used by adding the following URL in the Unsubscribe Page URL field. 
    URL
    https://api-0X.moengage.com/v1/emailresubscribe

    "X" here denotes your data center. 

  • The user gets automatically unsubscribed in this case. They have the option to resubscribe by clicking on the resubscribe me button on the landing page. You can also create a landing page of your own and add the URL for the same. This gives you more autonomy over the process and allows you to do things like capturing the reason why the user wants to unsubscribe.

  • You can also choose to place the unsubscribe link anywhere in the email body by using this HTML code: 
info

Information

Each customer is hosted on a different data center. You can find your data center number (value of "X" in the Unsubscribe page URL) by checking the data center and API endpoint mapping page here.

 

Email Service Provider Tracking

If you are using SendGrid Mandrill or SparkPost for unsubscribe tracking, you can go to their documentation to understand how to set this up.

If you choose this option, your email service provider will include an unsubscribe link in the body of the email and not MoEngage.

  • You will also need to update MoEngage's callback URL on the email service provider's dashboard. To access the URL, go to: Settings > Email Settings > Bounce & Complaint Tracking

If a user clicks on the unsubscribe link, the service provider will manage the request. Pass this data back to MoEngage using the Data API to update the corresponding user profile in the MoEngage dashboard.

 

SendGrid

If you choose SendGrid tracking for unsubscribe management, make sure that you make the corresponding change in the subscription tracking in SendGrid. If subscription tracking is enabled in SendGrid, it will insert a one-click unsubscribe link in the emails. 

  • If you want to add the unsubscribe link within the HTML, make use of the replacement text:  [unsubscribe_here]. This text is case-sensitive. This is only relevant to the MoEngage-managed SendGrid customers. Other customers can add their own replacement text.  [unsubscribe_here] will not be added by default. 

If the webhooks are correctly configured then SendGrid will pass the unsubscribe data back to MoE in near real-time and the user reachability will be accordingly updated. 

 

Mandrill

If you choose Mandrill racking for unsubscribe management on the MoEngage dashboard, then ensure that you make the corresponding change in the subscription tracking section of Mandrill

  • If you enable subscription tracking in Mandrill, they will insert an unsubscribe link in the emails.

If the webhooks are correctly configured then Mandrill will pass the unsubscribe data back to MoE in near real-time and the user reachability will be accordingly updated. 

SparkPost

If you choose SparkPost Tracking for unsubscribe management on the MoEngage dashboard, then ensure that you make the corresponding change in the subscription tracking section of SparkPost

  • If you enable subscription tracking in SparkPost, they will insert an unsubscribe link in the emails.

If the webhooks are correctly configured then SparkPost will pass the unsubscribe data back to MoE in near real-time and the user reachability will be accordingly updated. 

 

None

If you select the unsubscribe option as none then MoEngage expects you to manage this process from your end to remain compliant. You need to ensure that subscription tracking or unsubscribe settings are disabled on the connected email service provider. 

Include your own unsubscribe URL in the email template. This will not get tracked under the unsubscribe event and you have to capture and manage the unsubscribe requests from your end. 

Pass this data back to MoEngage using the Data API to update the corresponding user profile in the MoEngage dashboard.

Preference Management

If you wish to provide an option to categorically subscribe to certain kinds of email communications or select the frequency of email communications, use the subscription categories offered by MoEngage. It is still recommended to configure the option to unsubscribe from all emails at the end of the preference management page.

Replacement Tags

You can use replacement tags and codes to include the unsubscribe link in emails and customize the text for the unsubscribe link.

Configure a Replacement Tag for Sendgrid Tracking

  1. Go to Sendgrid > Settings > Tracking > Suppression Tracking.
  2. Add your preferred replacement tag.
    • MoEngage uses the tag "[unsubscribe_here]" because it is unlikely to be used by mistake in the email body.
    • The replacement tag is case-sensitive.
      TEU 1.png
  3. If you place this tag as the link value anywhere in the email body, it will act as the Unsubscribe link.
    For example:

    In HTML Editor

     

    TEU 2.png

    In Drag and Drop Editor

     

    MoE tracking.png

Configure a Replacement Tag for MoEngage Tracking

  1. In the MoEngage dashboard, go to Settings > Channels > Email. The EMAIL SETTINGS page is displayed.
  2. On the CONNECTOR CONFIG tab, go to the Unsubscribe Settings section.
  3. Select MoEngage Tracking.
    Make sure the respective connector (Sendgrid, Mandrill, Sparkpost, or custom connector) has Unsubscribe tracking turned off. Otherwise, there will be two unsubscribe links in the email.
  4. In the Unsubscribe Page URL field, enter the required URL.
    • MoEngage provides a standard landing page.
      https://api-0X.moengage.com/v1/emailresubscribe
      where X is the data center.
    • If you want to customize the landing page, add your page URL.
  5. Include the following HTML code in the HTML template to include the Unsubscribe link.
    HTML
    <a data-msys-unsubscribe=“1” href="https://custom.landingpage.com/default_moengage_unsubscribe_flow"> Click here to Unsubscribe </a>
    MoE tracking 2.png

    You can also add the HTML code in the WYSIWYG editor.
    You can customize the code to align with your email template.
    For example:
    HTML
    <span style="font-size: 14px;">Want to change how you receive these emails?</span>

    <span style="font-size: 14px;">You can</span> <a data-msys-unsubscribe=""1"" href="https://custom.landingpage.com/default_moengage_unsubscribe_flow" style="font-size: 14px;mso-line-height-rule: exactly;-ms-text-size-adjust: 100%;-webkit-text-size-adjust: 100%;color: #656565;font-weight: normal;text-decoration: underline;"> unsubscribe from this list. </a>
    which results in the following output:
    TEU 3.png

Previous

Next

Was this article helpful?
9 out of 186 found this helpful

How can we improve this article?