Marketing Cloud Test Sends Not Received

A Send Preview or Test Send replicates the exact process to send the email to the Subscriber but instead sends the email to the specified email address. There are a few common reasons a Test Send is not delivered. 
 

Table of Contents:
 

1. Identifying the Root Cause
   1. Email Bounce - The email was sent but not accepted by the recipient's email server.
   2. Unable to Send to the Specific Subscriber  - The email was not sent by Marketing Cloud for one of several reasons.
   3. Data Extension EmailAddress Data Type - The sendable Data Extension needs exactly one field with the EmailAddress data type.
   4. What to Do If None of These Solve My Issue - What to do if you can not identify why the test email was not received

2. Additional Root Cause Details
   1. Subscriber Status - The Subscriber being previewed against must be in an Active Subscriber Status. 
   2. List Detective - The Subscriber's email address must pass List Detective.
   3. RaiseError AMPscript Function - A Test Send can fail to send because the Subscriber and data evaluate the RaiseError function as True.

 1. Identifying the Root Cause

Email Bounce

When Marketing Cloud sends an email the email has to be accepted by the recipient's mail server. If it is not accepted the email is considered Bounced and will not be delivered as expected. Email bounces can happen for many reasons and require the recipient's mail server to tell us the email could not be delivered and why. It can take up to 72 hours for bounces to be reflected in Marketing Cloud Email Tracking. 

Identify if the email Bounced
 

To check if your test send bounced review the Email Tracking for the test send by performing the following steps. 
 

1. Navigate to Email Studio
2. Hover over Tracking and click Sends
3. In the left navigation, window expand the My Tracking folder by clicking +
4. Click on the Test Send Emails folder
5. Locate the email send and click the Email Name

6. In the Send Performance section of the Overview tab, you can see how many of the emails bounced

7. Click on the number next to Hard, Soft, or Bounce Blocks to get a list of the Subscribers who bounced and the reason. 

Resolving Bounced Emails
 

While resolving the issue causing the bounce you can attempt to send the test email to a different email domain. To use the bounced email for future test sends work with your email administrator to resolve the issue listed as the Bounce Reason. 

If the email does not appear to have bounced the next step is to run a Not Sent Tracking Extract to see if Marketing Cloud was unable to send the email. 

Additional Information About Bounces

For more information about Email Bounces reasons review the Bounce Reason section at the bottom of the Email Bounce Tracking Extract Output article.

To get the full Bounce response sent by the recipient's email server run a Tracking Extract and make sure you select "Bounce Extract" during the configuration. See the Tracking Data Extract section of this article to learn how to configure and run a Tracking Data Extract.

 Unable to Send to the Specific Subscriber

Review the Not Sent Extract

The Not Sent Data Extract file provides information about Subscribers who were not sent an email. The field we are most interested in is the Reason field. This field tells us why the email was not sent. 



The following values are the most common Reasons an email is not sent. 

• Account Level Opt Out - The Subscriber has a status of Unsubscribed. The Subscriber Status section of this article to learn more about Subscriber statuses and how to check a specific Subscriber's status.
  • Resolution - Use a Subscriber that has an Active Status

• List Detective Exclusion - The email address was caught by List Detective.
  • Resolution - Use a Subscriber that will not be excluded by List Detective. 
    • The List Detective section of this article has additional details about this feature and how you can verify an email will be excluded by List Detective. 

• Build Email Error or Send Failure - The email could not be created for the Subscriber.
  • Resolution - Use a Subscriber that does not trigger an AMPscript error during Preview.
    • The RaiseError section of this article covers the most common cause for this reason code.

Data Extension EmailAddress Data Type

If the email did not Bounce, there is not a record in the Not Sent extract, and the Subscriber does not exist on the All Subscribers list the Sendable Data Extension may not be configured in a way that allows Marketing Cloud to send the email.

Watch this quick Salesforce Support video or the information after the video to learn how to configure a sendable data extension and how to check the current configuration. 

If a Subscriber hasn’t been added to a List before the Send, Marketing Cloud attempts to add the SubscriberKey and Email to the All Subscribers or Publication List. A Data Extension with more than one or no EmailAddress DataType field prevents Marketing Cloud from creating the Subscriber record resulting in the email not being sent.

To check the Data Extension from within the UI, follow these steps:

1. Within Email Studio, go into the Subscribers tab
2. Under Subscribers, select Data Extensions from the menu

 

3. Locate the folder and Data Extension you’re planning to send to
4. After you've clicked into the Data Extension, review the Properties tab and Fields section on the right

 

5. Review all the Fields and ensure there’s only one EmailAddress DataType field

What to Do If None of These Solve My Issue

If none of these situations are true it is likely that the email has bounced but is not yet reflected in the email tracking. Bounces can take up to 72 hours to appear making it appear that the email was delivered. If you are sending the test send to your company's email domain try using a different email domain to receive your test send or create a support case to understand why the email was not delivered. 

 2. Additional Root Cause Details

Subscriber Status

Send Preview and Test Sends follow the exact process used to build and send the email to the selected Subscribers. When previewing against a Data Extension, the system uses the Status of the Subscriber in the All Subscribers List to replicate what would occur in a live send. If the Subscriber is in an Unsubscribed or Undeliverable/Held status, Marketing Cloud doesn’t send the message because the Subscriber wouldn’t receive the message in a live send.

For an overview of Subscriber statuses, review the following video or steps.
 

To check a Subscriber Status, note down the EmailAddress or SubscriberKey of the record and follow these steps.
 

1. Within Email Studio, go into the Subscribers tab
2. Under Subscribers, select the All Subscribers option
3. Click the Search button towards the top left of the screen
   • You can also select Browse in the top right to limit the search to a particular List you'd like to look within
4. Select Email Address or SubscriberKey within the Criteria section
5. Add in the value you have for EmailAddress/SubscriberKey 
6. Click Find Now to search for the records

List Detective

1. Create a .csv file with two fields; SubscriberKey & EmailAddress
2. Go into Email Studio and select Subscribers from the menu
3. Within the Subscribers menu, select Lists
4. Find the folder the List is saved within
5. On the right-hand side, select the icon for Import
6. Follow the pop-up to Import the List from the .csv file you created
   • Ensure your email is populated in the field before clicking Begin
7. When the Import has finished, review the Results File to see if List Detective prevents the email from being added

{
  "email": "example@example.com",
  "validators": [ "ListDetectiveValidator" ]
}

RaiseError Function

The RaiseError function is used to exclude small numbers of Subscribers that meet rare evaluations within your code and not exclude large groups of Subscribers. The easiest way to confirm if a Subscriber was excluded from your test send due to RaiseError is to do a Send Preview for the Subscriber.

When you do a Send Preview with a Subscriber that triggers a RaiseError function, the Send Preview fails and generates an error. Within the error is the value of Parameter 1 (S1) in the RaiseError function stating this function was processed by the email.





The RaiseError function allows you to stop the whole send or skip the Subscriber via Parameter 2 (B1) and the boolean option. If you set the value to False and to stop, the Send Alert Manager provides you details about the RaiseError function that stopped the send. The following two items must be configured to allow Alert Manager to provide this information:

1. To receive Alert Manager notifications of failed Jobs within the Marketing Cloud, select your User.
2. Enter a unique Error message in Parameter 1 (S1) of the RaiseError function to include the error in the 'Additional Error details' section of the Alert Manager Email.