Add Custom List-Unsubscribe Headers

Goal​

To add a custom standard list-unsubscribe header to an email message.

Background Information​

In most ISPs, the list-unsubscribe header enables an unsubscribe link or button in the web interface of an email client. This makes it easier for the recipient to unsubscribe and reduces the chance that they mark the message as spam or block the sender.

You can add a list-unsubscribe header with custom values to manage unsubscribe requests outside the group in Mapp Engage. The option you select depends on how you manage unsubscribe requests.

• Use headers with custom values to manage the unsubscribe request in an external application.

• Use headers with custom values to manage the unsubscribe request in a separate group in Mapp Engage.

Procedure

Manage Unsubscribe Requests in an External Application

1. In the ​Main Navigation​, click ​Audience > Group Management > Groups​.

2. In the ​Action​ column, click the symbol next to the group.
   ⇒ The ​General Settings​ window opens.

3. Click the ​Sendout Options​ tab.

4. Click the  symbol to expand the ​List-Unsubscribe Header​ area.

5. From the ​Setting​ drop-down list, select ​Header with Custom Values​.
   ⇒ Additional input fields for email and web headers are displayed.

   When you use headers with custom values, you can enter values for email-based (mailto) and web-based (HTTP) headers.

   We recommend that you use both types in all messages. Not all ISPs support both, but most display one type or the other. This procedure includes instructions for both types.

6. In the ​Email​ input field, enter the list-unsubscribe header as a tag.
   Example: <mailto:listunsubscribe-listName-externalMessageID-externalUserID@externalDomain.com>

7. In the ​Web​ input field, enter the list-unsubscribe header as a tag. The web header supports both HTTP and HTTPS.
   Example: <http://externalDomain.com/member/unsubscribe/?listName=listname@externalDomain.com&mid=externalMessageID&id=externalUserID>

8. To insert placeholders for values stored in Mapp Engage(such as user ID or message ID), click the ​Personalization​ button.
   ⇒ The ​Personalization​ window opens. Select an object from the list to insert it at the cursor position.

9. Click the ​Save​ button.
   ⇒ A list-unsubscribe header with custom values is added to every message sent to members of this group. Unsubscribe requests are recorded in an external application.

Manage Unsubscribe Requests in a Separate Group in Mapp Engage

1. In the ​Main Navigation​, click ​Audience > Groups​.
   ⇒ The ​Group ​ window opens.

2. In the ​Action​ column, click the symbol next to the group.
   ⇒ The ​General Settings​ window opens.

3. Click the ​Sendout Options​ tab.

4. Click the  symbol to expand the ​List-Unsubscribe Header​ area.

5. From the ​Setting​ drop-down list, select ​Header with Custom Values​.
   ⇒ Additional input fields for email and web headers are displayed.
   In the input field ​Email​, paste the following code:
   <mailto:listunsubscribe-<%group.PK%>-<%message.PK%>-<%user.PK%>@<%domain.MailDomain%>>
   Replace the placeholder for the group ID (<%group.PK%>) with the ID of the group that you use to manage unsubscribes.

6. Click the ​Save​ button.
   ⇒ A list-unsubscribe header with custom values is added to every message sent to members of this group. Unsubscribe requests are recorded in a separate group.