The configuration settings for collecting bounces

Last updated Tuesday, June 13, 2017 in Email Experience Manager for Developer, Administrator
Keywords: Configuration, Messages

If an error occurs during email delivery, the sender receives a bounce from the sender's mail server or from the recipient's mail server. When a server accepts a message for delivery, it also delivers a bounce if the delivery fails.

Depending on whether you use the Sitecore Email Cloud, EXM uses one of the following methods to collect the bounces.

Collect bounces using Sitecore Email Cloud

By default, EXM collects the bounced email campaigns on a scheduled interval using the Sitecore.EDS.Providers.Sparkpost.Tasks.PullBouncesAgent setting in the <scheduling> section in the Sitecore.EDS.Providers.Sparkpost.Sync.config file.

<agent type="Sitecore.EDS.Providers.Sparkpost.Tasks.PullBouncesAgent, Sitecore.EDS.Providers.Sparkpost" method="Run" interval="01:00:00">
  <runInterval>01:00:00</runInterval>
  <messageEventsCounts>500</bouncesCount>
</agent>

Setting

Default value

Description

interval

01:00:00

Specify the interval for when you want the Sitecore Email Cloud to collect the bounces.

runInterval

01:00:00

Specify how far back from when you start the Sitecore Email Cloud provider that you want EXM to collect bounces.

messageEventsCount

250

Specify the default page size for the Sparkpost API. By default, 250 is the maximum number of records that is returned at a time. The value must be between 1 and 10.000.

Important

This setting must correspond to the limit that is set in the Sparkpost API.

Collect bounces using a custom SMTP

If you use a custom SMTP, you can configure the bounce settings on the manager root, on the Content tab, in the Delivery Status Notifications section.

exm_ContentEditor_ManagerRoot_DeliveryStatusNotifications.png

Setting

Example

Description

Collect Notifications

cleared

Select this check box to collect bounces from the email address that is used to send your email campaigns. Any blank fields will inherit the values from the manager root.

If you clear this check box, the system ignores the delivery notification settings and behave as though all messages have been delivered successfully.

Return Address

dsn@site.net

Specify the email address that you want the service to send bounces to.

POP3 Server

pop.server.com

Specify the POP3 server address/name. (mandatory)

POP3 SSL

default

Select if you want to the POP3 server to use SSL for transferring email campaigns.

POP3 Port

110

Specify the port for transferring messages from the POP3 server. (mandatory)

POP3 User Name

serveruser

Specify the POP3 server user name.

POP3 Password

12345

Specify the POP3 server user password.

The bounces are collected on a scheduled interval using the setting Sitecore.EDS.Providers.CustomSmtp.Tasks.PullPop3BouncesAgent in the <scheduling> section of the Sitecore.EDS.Providers.CustomSmtp.Sync.config file.

<agent type=" Sitecore.EDS.Providers.CustomSmtp.Tasks.PullPop3BouncesAgent, Sitecore.EDS.Providers.CustomSMTP" method="Run" interval="00:01:00"> 
  <param ref="exm/eds/receiversCollection" /> 
</agent> 

Setting

Default value

Description

interval

01:00:00

Specify the interval during which you want the custom SMTP to collect the bounces.