Delivery failures and quarantine management delivery-failures-quarantine

NOTE
Comprehensive guidance on delivery failures and quarantine management is documented in Campaign v8 documentation. This content applies to both Campaign Classic v7 and Campaign v8 users:
  • Understanding delivery failures - Covers failure types, error reasons, synchronous/asynchronous errors, retry management, and troubleshooting
  • Quarantine management - Covers quarantine vs denylist, soft error thresholds, quarantine reports, and address removal
This page documents Campaign Classic v7-specific configuration for bounce mail and quarantine management in hybrid and on-premise deployments.

Understanding delivery failures

For common delivery failure concepts, error types, and troubleshooting guidance, refer to the Campaign v8 Understanding delivery failures documentation.

Bounce mail configuration bounce-mail-config

The following configuration options are available for Campaign Classic v7 hybrid/on-premise deployments to manage bounce mail processing.

Bounce mailbox configuration bounce-mailbox-configuration

For on-premise installations, configuration of the bounce mailbox is detailed in this section.

Asynchronous error messages are collected by the Adobe Campaign platform through the bounce mailbox and qualified by the inMail process to enrich the list of email management rules.

NOTE
For Campaign v8 Managed Cloud Services users, the bounce mailbox configuration is performed and managed by Adobe. No configuration is required.

Bounce mail qualification management bounce-mail-qualification-management

For on-premise installations and hosted/hybrid installations using the legacy Campaign MTA, when the delivery of an email fails, the Adobe Campaign delivery server receives an error message from the messaging server or the remote DNS server. The list of errors is made up of strings contained in the message returned by the remote server. Failure types and reasons are assigned to each error message.

This list is available via the Administration > Campaign Management > Non deliverables Management > Delivery log qualification node. It contains all the rules used by Adobe Campaign to qualify delivery failures. It is non-exhaustive, and is regularly updated by Adobe Campaign and can also be managed by the user.

The message returned by the remote server on the first occurrence of this error type is displayed in the First text column of the Delivery log qualification table. If this column is not displayed, click the Configure list button at the right bottom of the list to select it.

Adobe Campaign filters this message to delete the variable content (such as IDs, dates, email addresses, phone numbers, etc.) and displays the filtered result in the Text column. The variables are replaced with #xxx#, except addresses that are replaced with *.

This process allows to bring together all failures of the same type and avoid multiple entries for similar errors in the Delivery log qualification table.

NOTE
The Number of occurrences field displays the number of occurrences of the message in the list. It is limited to 100 000 occurrences. You can edit the field, if you want, for example, to reset it.

Bounce mails can have the following qualification status:

  • To qualify: the bounce mail could not be qualified. Qualification must be assigned to the Deliverability team to guarantee efficient platform deliverability. As long as it isn’t qualified, the bounce mail isn’t used to enrich the list of email management rules.
  • Keep: the bounce mail was qualified and will be used by the Refresh for deliverability workflow to be compared to existing email management rules and enrich the list.
  • Ignore: the bounce mail is ignored by the Campaign MTA, meaning that this bounce will never cause the recipient’s address to be quarantined. It will not be used by the Refresh for deliverability workflow and it will not be sent to client instances.

NOTE
In case of an outage of an ISP, emails sent through Campaign will be wrongly marked as bounces. To correct this, you need to update bounce qualification. For more on this, see this page.

Email management rules configuration email-management-rules

Mail rules are accessed via the Administration > Campaign Management > Non deliverables Management > Mail rule sets node. Email management rules are shown in the lower part of the window.

NOTE
The default parameters of the platform are configured in the deployment wizard. For further information, refer to this section.

The default rules are as follows:

IMPORTANT
  • The delivery server (MTA) has to be restarted if the parameters have been changed.
  • The modification or creation of management rules is for expert users only.

Inbound email inbound-email

These rules contain the strings which can be returned by remote servers and which enable you to qualify the error (Hard, Soft or Ignored).

When an email fails, the remote server returns a bounce message to the address specified in the platform parameters. Adobe Campaign compares the content of each bounce message to the strings in the rule list, and then assigns it one of the three error types.

NOTE
The user can create their own rules. When importing a package and when updating data via the Refresh for deliverability workflow, the user-created rules are overwritten.

For more on bounce mail qualification, refer to this section.

Domain management domain-management

For on-premise installations, the MTA applies a single Domain management rule to all domains.

  • You can choose whether or not to activate certain identification standards and encryption keys to check the domain name, such as Sender ID, DomainKeys, DKIM, and S/MIME.
  • The SMTP relay parameters let you configure the IP address and port of a relay server for a particular domain. For more on this, refer to this section.

If your messages display on behalf of in the sender address, make sure not to sign emails with Sender ID, which is the obsoleted proprietary email authentication standard from Microsoft. If the Sender ID option is enabled, uncheck the corresponding box and contact Adobe Customer Care. Your deliverability will not be impacted.

MX management mx-management

For on-premise installations, MX management rules are used to regulate the flow of outgoing emails for a specific domain.

These rules are available in the deployment wizard and can be customized:

  • MX Management: this rule is used to control the flow of outgoing emails for a domain. It samples bounce messages and blocks sending where appropriate.

  • Period: the time frame during which messages are throttled or blocked.

  • Limit: the maximum number of messages allowed per time period.

  • Type: the error type (hard, soft, or ignored) used to determine sending behavior. Refer to the Campaign v8 documentation for error type definitions.

For more on MX management, refer to this section.

NOTE
For Campaign v8 Managed Cloud Services users, MX rules and email flow management are managed by Adobe as part of the managed infrastructure. Contact Adobe Customer Care if you need to adjust MX settings for specific use cases.

Quarantine management quarantine-management

For comprehensive quarantine management guidance, refer to the Campaign v8 Quarantine management documentation.

Quarantine configuration quarantine-config

The following configuration options are available for Campaign Classic v7 hybrid/on-premise deployments to customize quarantine behavior.

Soft error threshold configuration soft-error-threshold

For on-premise installations using the legacy Campaign MTA, you can modify the number of errors and the period between two errors before an address is quarantined.

To configure these settings:

  1. Access the deployment wizard from Tools > Advanced > Deployment wizard

  2. Navigate to Email channel > Advanced parameters

  3. Configure:

    • Number of errors: The maximum number of soft errors before an address is quarantined (default: 5)
    • Period between two significant errors: The time window (in seconds) for error counting (default: 86,400 seconds = 1 day)

When the error counter reaches the threshold, the address is quarantined. If the last significant error occurred more than 10 days ago, the error counter is reinitialized.

For more details, refer to this page under Delivery sending > Configure retries.

NOTE
For Campaign v8 Managed Cloud Services users, retry settings and error thresholds are managed by Adobe based on IP performance and domain reputation. No configuration is required.

Database cleanup workflow database-cleanup-workflow

For on-premise installations, the Database cleanup technical workflow automatically removes quarantined addresses that match specific conditions.

Access this workflow from Administration > Production > Technical workflows > Database cleanup.

The workflow removes addresses from quarantine in the following cases:

  • Addresses in With errors status after a successful delivery
  • Addresses in With errors status if the last soft bounce occurred more than 10 days ago
  • Addresses in With errors status with Mailbox full error after 30 days

Ensure this workflow runs regularly (recommended: daily) to maintain quarantine list hygiene.

For more on database cleanup, refer to this section.

NOTE
For Campaign v8 Managed Cloud Services users, the database cleanup workflow is monitored and managed by Adobe.

Push notification quarantine specifics push-quarantine-specifics

For Campaign Classic v7, push notification quarantines follow the general quarantine mechanism with some channel-specific behaviors.

For iOS and Android push notifications, the quarantine mechanism uses device tokens rather than email addresses. When a mobile application is uninstalled or reinstalled, the associated token is quarantined.

For detailed information about push notification quarantine scenarios (iOS and Android error types, retry behavior, etc.), refer to the Understanding delivery failures documentation which includes comprehensive push notification error type tables.

SMS quarantine specifics sms-quarantine-specifics

For Campaign Classic v7, SMS quarantines follow the general quarantine mechanism with some channel-specific behaviors related to phone numbers rather than email addresses.

The SMS quarantine mechanism varies depending on the connector used:

  • Standard SMPP connectors: Error qualification rules defined in Administration > Campaign Management > Non deliverables Management > Delivery log qualification apply to SMS deliveries.

  • Extended generic SMPP connector: Error management is handled differently using regular expressions (regexes) to parse Status Report (SR) messages returned by the SMSC provider.

For detailed information about SMS quarantine scenarios and error types, refer to the Understanding delivery failures documentation which includes comprehensive SMS error type tables.

recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1