Documentation Index

Fetch the complete documentation index at: https://docs.mapp.com/llms.txt

Use this file to discover all available pages before exploring further.

Customized Landing Pages for the Opt-In Processes

Prev Next

Overview

This feature lets you customize the links in system messages so that recipients are redirected to your own landing pages instead of the default Mapp Engage subscription pages. Use it to display a branded success or error page after a subscription action.

Prerequisites

Two custom landing pages must be created and uploaded:

  • A success page that confirms the subscription and optionally provides additional information.

  • An error page that displays a failure message and encourages retrying the subscription.

Key Characteristics

  • When a contact is imported or manually added to a group, the system can send an invitation message.

  • These system messages contain a default link to the Mapp Engage-hosted subscription page.

  • You can replace this link to redirect to your custom landing pages instead.

  • If your custom landing page includes further redirection (e.g. to your website or shop), the links in the system messages must be adjusted accordingly.

  • The link can be modified in:

    • The system message text itself

    • A prepared message that replaces the system message (see Create Templates for System Messages)

Messages Used in the Subscription Process

System Message

Description

SysMsgConfirmSubscription

Sent for email subscriptions when the recipient is not yet in the system.

SysMsgConfirmSubscriptionPasswd

As above, but also requests the recipient to set a Mapp Engage password.

SysMsgInviteToGroup

Sent for subscriptions via import/API when the recipient is not yet in the system.

SysMsgInviteToGroupPasswd

As above, but also requests a password.

SysMsgRemindPending

Sent as a reminder when the subscription has not yet been confirmed.

Warning

The reminder message SysMsgRemindPending does not support the tan parameter. Do not reuse the double opt-in subscribe link, which includes &tan=<%subscribe_link_tan%>, in this message. The reminder does not generate a tan value, so the parameter stays empty and the subscription cannot be completed.

For the reminder message, use the subscribe link without the tan parameter:

<%domain.WebDomain%>/public/custom_subscribe.jsp?tsp=<%subscribe_link_tsp%>&uid=<%subscribe_link_uid%>&sig=<%subscribe_link_sig%>&gid=<%group.PK%>&lang=en

Note:

You may also need to adjust unsubscribe links in these messages if you are replacing them with custom templates. For more information, see Create Templates for System Messages.


Procedures

Scenario 1: Link in the System Message Text

  1. Go to Messages​ > ​System Message​.

  2. Change the landing page of a single group or for the entire system by clicking on the appropriate tab.

    • System Message - Group general​. The system message is changed for all groups in your Mapp Engage system.

    • System Message - Group specific​. The system message will be customized for a specially selected group. All other groups remain unchanged. Choose the group from the ​Group​ drop-down list. Click the   symbol in the line of the system message to be edited and choose ​Edit. The window ​Edit System Messages ​opens. Languages that have already been processed are displayed in the ​Customized Language​ list.

  3. Click ​Add Language​ to select the language versions to be edited.

    System messages must be individually customized for all languages used.  If only one language is used on your system for message sendout it is sufficient to simply adjust the default language. This overrides all other language preferences of the recipient.

  4. Highlight the language and click on the icon to ​Select​. The system message opens for editing.

  5. Replace the placeholder for the link that is located in the text of the system message, <%subscribe_link%>, with:

    <%subscribe_link%>&action=subscribeToSingleGroup&redirect_ok=http://www.subscriptionSuccess.com&redirect_err=http://www.subscriptionError.com/&errorPage=/automated/action.jsp
    1. redirect_ok= Indicates the page that opens to confirm a successful subscription. Insert the address of the page that the subscriber sees here.

    2. redirect_err= Marks the page that is opened to indicate a subscription error. Insert the address of the page that the subscriber is shown here.

Scenario 2: Link in a Prepared Message

  1. Go to ​Message​ > ​Prepared Message​.

    It is possible to insert prepared messages as the default template. The text of the message remains in the actual system message. It must also be used to change the unsubscribe link in the system message.

    A system message only needs to be customized if the unsubscribe link is also part of the prepared message.

  2. The window ​Prepared Messages Overview​ opens.

  3. Open the prepared message which contains the subscribe link. The subscribe link is represented by the placeholder <%subscribe_link%>.

  4. Replace the subscription link with:

    <%subscribe_link%>&action=subscribeToSingleGroup&redirect_ok=http://www.subscriptionSuccess.com&redirect_err=http://www.subscriptionError.com/&errorPage=/automated/action.jsp
    1. redirect_ok= Indicates the page that opens to confirm a successful subscription. Insert the address of the page to be displayed to the subscriber here.

    2. redirect_err= Marks the page that is opened for a subscription error. Insert the address of the page to be displayed to the subscriber here.