Email opt-out management email-opt-out

When sending messages from journeys or campaigns, you must always ensure that customers can unsubscribe from future communications. Once unsubscribed, the profiles are automatically removed from the audience of future marketing messages. Learn more on privacy & opt-out management

NOTE
All your marketing messages must include an opt-out link. This is not required for transactional messages. The message category - Marketing or Transactional - is defined at the channel surface level and when creating the message.

To insert an unsubscription link in your email content, you can:

One step opt-out opt-out-one-step

One-click Unsubscribe URL in the email header unsubscribe-header

One-click list unsubscribe URL is an unsubscribe link or button displayed next to the email sender information and lets recipients instantly opt out of your mailing lists with a single click. In Adobe Journey Optimizer, when the Enable List-Unsubscribe option is toggled on, the email header includes both a mailto and/or a URL by default that recipients can use to unsubscribe from your mailing list.

The Enable List-Unsubscribe toggle must be activated at the channel surface level so that emails using this surface include the one-click unsubscribe URL in the email header.

NOTE
To display the one-click unsubscribe URL in the email header, the recipients’ email client must support this feature.

For example, the one-click unsubscribe URL displays an unsubscription link like this in Gmail:

With Adobe Journey Optimizer, you can configure your email surface settings with an auto-generated one-click unsubscribe URL and mailto address in the email header, or include a one-click opt-out URL in your email body: when a recipient clicks the one-click opt-out link, recipient’s unsubscribe request is processed accordingly.

Depending on the email client, and the email surface unsubscription settings, clicking the unsubscribe link in the email header can have the following impacts:

  • When the Mailto (unsubscribe) feature is enabled by you, the unsubscribe request is sent to the default unsubscribe address based on the subdomain created by you.
  • When the One-click Unsubscribe URL feature is enabled by you - or if you inserted an unsubscription URL in your email body content -, the recipient is directly opted-out, either at the channel level or at the ID level (depending on how the consent is set up), when the recipient clicks on the one-click unsubscribe URL, which is based on the subdomain created by you.

In both cases, the corresponding profile for the recipient is immediately opted out and this choice is updated in Experience Platform. Learn more in the Experience Platform documentation.

If you have toggled on the Enable List-Unsubscribe option in regards to List Unsubscribe header, we recommend that you enable both methods - Mailto (unsubscribe) and One-Click Unsubscribe URL. Not all email clients support the HTTP method. With the Mailto list-unsubscribe feature provided as functionality for you to select an alternative, your sender reputation can be better protected and all your recipients are able to have access to use the unsubscribe functionality. Learn more

One-click opt-out from the email content one-click-opt-out

To set a personalized unsubscribe URL, insert a one-click opt-out link into the email message content and enter the URL of your choice, as described below:

  1. Access your email content and insert a link.

  2. Select One click Opt-out as the type of link.

  3. Enter the URL of the landing page where the user is redirected once unsubscribed. This page is here to confirm that opting out was successful.

    note note
    NOTE
    If you enabled the List-Unsubscribe option at the channel surface level and have the default one-click opt-out URL option unchecked, then this URL is used when users click the unsubscribe link in the email header. Learn more

    You can personalize your links. Learn more on personalized URLs in this section.

  4. Select how you want to apply the opting out: at the channel, identity, or subscription level.

    • Channel: The opt-out applies to future messages sent to the profile’s target (i.e. email address) for the current channel. If several targets are associated with a profile, the opt-out applies to all targets (i.e. email addresses) in the profile for that channel.
    • Identity: The opt-out applies to future messages sent to the specific target (i.e. email address) being used for the current message.
    • Subscription: The opt-out applies to future messages associated with a specific subscription list. This option can only be selected if the current message is associated with a subscription list.
  5. Save your changes.

Two-step opt-out opt-out-external-lp

The standard opt-out mechanism relies on two steps: the subscriber clicks the opt-out link in an email, then they are redirected to an opt-out landing page to confirm their unsubscription.

To implement this unsubscription mode, you must create and publish an opt-out landing page, and add an unsubscription link in your email messages, with a link to the landing page. These steps are outlined below.

Prerequisites prereq-lp

To set up a two step opt-out mechanism, you must create your own unsubscription landing pages. The first landing page will be linked from your message and must contain a call-to-action button. A confirmation message should display when the user clicks on the button.

Learn how to create a landing page in Adobe Journey Optimizer to manage unsubscriptions in this page.

You can also use an external landing page. In that case, configure the API to send the information to Adobe Journey Optimizer when a recipients has unsubscribed.

Learn how to implement an opt-out API call

To have your recipients opted out when they submit their choice from the landing page, you must implement a Subscription API call through Adobe Developer to update the corresponding profiles’ preferences.

This POST call is as follows:

Endpoint: https://platform.adobe.io/journey/imp/consent/preferences

Query parameters:

  • params: contains the encrypted payload
  • pid: encrypted profile ID

These three parameters will be included into the third-party landing page URL sent to your recipient:

Header requirements:

  • x-api-key
  • x-gw-ims-org-id
  • x-sandbox-name
  • authorization (user token from your technical account)

Request body:

code language-none
{
   "marketing": [
       {
            "type": "email",
            "choice": "no",
            "scope": "channel"
        }
    ],

}

Journey Optimizer uses these parameters to update the corresponding profile’s choice through the Adobe Developer API call.

You first need to add an unsubscribe link into a message. To do this, follow the steps below:

  1. Create a message and insert a link using the contextual toolbar.

  2. Select the Landing page from the Type drop-down list, and select your opt-out landing page in the Landing page field.

    If you are using an external landing page, select External Opt-out/Unsubscription from the Type drop-down list.

    In the Link field, paste the link to your third-party landing page.

  3. Click Save.

Once you configured the unsubscribe link to your landing page, your can create and send your message.

  1. Configure your message with an unsubscription link and send it to your subscribers.

  2. Once the message is received, if the recipient clicks the unsubscribe link, your landing page is displayed.

  3. If the recipient submits the form - here, by hitting the Unsubscribe button in your landing page - the profile data is updated through the API call.

  4. The opted-out recipient is then redirected to a confirmation message screen indicating that opting out was successful.

    As a result, this user will not receive communication from your brand unless subscribed again.

  5. To check that the corresponding profile’s choice has been updated, go to Experience Platform and access the profile by selecting an identity namespace and a corresponding identity value. Learn more in the Experience Platform documentation.

    In the Attributes tab, you can see the value for choice has changed to no.

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76