Troubleshooting marketing emails on MVC sites

✖
Copy to clipboard

This page summarizes common email marketing problems that may occur in the interactions between the Xperience administration application and the MVC live site application.

For general marketing email troubleshooting, not specifically related to MVC sites, see: Troubleshooting marketing emails

Unavailable MVC website

Before you send out marketing emails, verify that your MVC website is:

  • Running
  • Accessible publicly and from the Xperience administration application that you use to manage your email feeds (make sure the connection is not blocked by a firewall, etc.)

Otherwise, email content and functionality that interacts with the site will not be available, for example, unsubscription links or email tracking features.

If the site is not accessible, please contact your system’s administrator.

Incorrect email feed URLs

Some of the email marketing features need to interact with your MVC site to work. Problems can occur if the required features are not implemented or registered correctly on your MVC site, or if the related URLs are not configured correctly in Xperience.

The Email marketing application in the administration interface automatically displays a warning if the related URLs are not accessible for an email feed (on the Emails tab of the email feed and the Send tab of individual emails).

Unsubscription page URL

Verify that your MVC site has an email feed unsubscription page implemented according to the instructions in Setting up unsubscription.

Then make sure the unsubscription URL of your email feeds is correctly configured:

  1. Open the Email marketing application in Xperience.

  2. Edit your email feed and switch to the Configuration tab.

  3. Set the following properties:

    • Base URL – the base URL of your live site. Leave empty to use the site’s Presentation URL. For example: https://www.SiteDomain.com

    • Unsubscription page URL – must match the route of the action that handles unsubscription requests in your MVC application. For example: /NewsletterSubscription/Unsubscribe

      If the Unsubscription page URL value is empty for an email feed, the system uses the URL assigned in the Settings -> On-line marketing -> Email marketing -> Unsubscription page URL setting.

  4. Save the email feed.

Double opt-in approval page URL

If double opt-in is enabled for your newsletters, your MVC site must have a subscription confirmation page implemented according to the instructions in Handling confirmations for double opt-in subscription.

Also, verify that the approval page URL of your newsletters is correctly configured:

  1. Open the Email marketing application in Xperience.

  2. Edit your newsletter and switch to the Configuration tab.

  3. Set the following properties:

    • Base URL – the base URL of your live site. Leave empty to use the site’s Presentation URL. For example: https://www.SiteDomain.com

    • Approval page URL – must match the route of the action that handles subscription confirmation requests in your MVC application. For example: ~/NewsletterSubscription/ConfirmSubscription

      If the Approval page URL value is empty for a newsletter, the system uses the URL assigned in the Settings -> On-line marketing -> Email marketing -> Double opt-in approval page URL setting.

  4. Save the newsletter.

Email tracking URLs

If you have tracking features enabled for your email feed (opened emails and clicked links), verify the following:

  • The Presentation URL of your site or one of its aliases in the Sites application matches the domain name of the running MVC website.
  • Your MVC application has the email tracking feature enabled according to the instructions in Enabling marketing email tracking.