The Delivery alerting feature is an alert management system that enables a group of users to automatically receive notifications containing information on the execution of their deliveries.
The notifications sent contain a report based by default on the following criteria:
The recipients of the alerts can monitor the deliveries that are being processed by Adobe Campaign and take appropriate actions when there are issues in their execution.
These alerting notifications can be customized depending on specific alerting criteria that are defined through a dashboard in the Adobe Campaign interface.
The alerting notifications are delivered by email only.
The notifications sent contain:
To manage the notifications’ recipients, define the alerting criteria and access the history of the alerts, you need to use dashboards.
To access and configure the dashboards and the alerting criteria, you must have administration rights or appear in the Delivery supervisors security group. Standard users cannot access the dashboards in the Adobe Campaign interface. They can only receive the alerting notifications. For more on users and security in Adobe Campaign, see Types of users and About security groups.
From the Adobe Campaign interface, you can:
Create and manage delivery alerting dashboards. See Creating a delivery alerting dashboard.
Define and manage delivery alerting criteria for each dashboard. For example, you can build alerts based on deliveries with failed preparation or deliveries with a low throughput only. See About alerting criteria.
Modify the criteria parameters for each dashboard. See Criteria parameters.
Define a group of recipients for each dashboard.
For example, you want to inform the users with administration rights of the failed deliveries only. However, you want the marketing users to receive information on the deliveries with a soft bounce bad error ratio. Therefore, you need to create two different dashboards and define the criteria that you want for each group of recipients.
Access the history of all sent alerts for each dashboard.
When selecting a dashboard, the last sent alert for this dashboard is displayed by default. All sent alerts are listed on the left of the screen. Click an item in the History list to access the corresponding alerts.
If you want to send notifications based on specific criteria to different groups of users, you need to use several dashboards. To create a new dashboard:
Go to Administration > Channels > Delivery alerting.
Select Delivery alerting dashboards and click Create.
Check the Enabled box to activate the current dashboard.
If this option is disabled, notifications linked to this dashboard are no longer sent. This option is disabled by default.
Select the group of recipients that you want to notify from the Alert group drop-down list. To modify or create a group, see Creating a security group and assigning users.
From the Delivery alerting criteria section, click Create element to add criteria. See About alerting criteria.
Select the Edit properties button. In the Criteria parameters tab, define how the criteria will be applied. See Criteria parameters.
Click Create to save the dashboard.
Now each time a delivery meets the criteria that you defined in this dashboard, an alerting notification will be sent to the specified group of users.
To access the delivery alerting criteria, go to Administration > Channels > Delivery alerting and select Delivery alerting criteria.
The following criteria can be used in the delivery alerting dashboards:
All the parameters applying to the above criteria have defaults values. These values can be changed in the Criteria parameters tab of the delivery alerting dashboards. See Criteria parameters.
You can select any item from the Delivery alerting criteria list to access its details.
For each criterion, you can define the following settings:
Indicators to add in alerts, meaning the columns that will appear in the notification’s Details section for the deliveries corresponding to the selected criterion.
Alert type, meaning the label and the color that will appear next to the delivery criterion in the notification’s summary.
Criteria frequency: If a criterion is met for one delivery, it is repeated in each notification sent within the monitoring period. Otherwise, only one alert will be sent a day (on the first occurrence) by alert criterion for one delivery.
By default, this option is set to once a day for all criteria.
You can create new delivery alerting criteria to better suit your needs.
For example, you can create a new criterion enabling to send a notification listing all deliveries with a Finished status.
To do this, you first need to extend the Delivery resource and add a new filter allowing you to select only the deliveries with a Finished status.
Go to Adobe Campaign > Administration > Development > Custom resources and click Create.
Select Extend an existing resource, select the Delivery resource from the drop-down list and click Create to edit it.
For more on extending an existing resource, see Define the resource.
In the Delivery resource, go to the Filter definition tab and click Add an element to create a filter.
Edit the new filter definition: in the Filter definition window, drag and drop the Status item into the workspace and select Finished as the filter condition.
For more on creating and editing custom filters, see Define filters.
Save your changes and publish your resources. For more on this, see Publishing a custom resource.
The filter is created and can now be selected in a new delivery alerting criterion.
Go to Administration > Channels > Delivery alerting, select Delivery alerting criteria and click Create.
In the Delivery filter applied by this criterion drop-down list, select the filter that you just created.
You can define your criterion’s settings the same way as for the default criteria. See About alerting criteria.
Once created, these criteria can be added to a delivery alerting dashboard as well as other criteria. See About delivery alerting dashboards.
In the Criteria parameters tab of a delivery alerting dashboard, you can define the settings that apply to the criteria selected in this dashboard.
Delivery target minimum size: For example, if you enter 100 in this field, a notification is sent only for deliveries with a target equal to or greater than 100 recipients. This parameter applies to all criteria.
Monitoring period before and after the contact date (in hours): Number of hours before and after the current time. Only the deliveries having a contact date in this time range are taken into account. This parameter applies to all criteria. By default, the value of this field is set to 24 hours.
For more information on the contact date, see About the scheduling.
Maximum ratio of soft bounce errors: A notification is sent for all deliveries with a soft bounce error ratio greater than the specified value. By default, the value of this field is set to 0.05 (5%).
Maximum ratio of hard bounce errors: A notification is sent for all deliveries with a hard bounce error ratio greater than the specified value. By default, the value of this field is set to 0.05 (5%).
Minimum time threshold for delivery in ‘Start pending’ status (in minutes): A notification is sent for all deliveries with a Start pending status for longer than the duration specified in this field, Start pending status meaning that the messages have not been taken into account by the system yet.
Minimum time required for the computation of the throughput (in minutes): Only deliveries started (with In progress status) for more than the specified duration are taken into account for the Deliveries with low throughput criterion.
Maximum percentage of processed messages for the computation of the throughput: Only deliveries with a percentage of processed messages lower than the specified percentage are taken into account for the Deliveries with low throughput criterion.
Minimum expected throughput (in sent messages per hour): Only deliveries with a throughput lower than the specified value are taken into account for the Deliveries with low throughput criterion.
Minimum processed ratio required for ‘Deliveries in progress’ criterion: Only deliveries with a percentage of processed messages higher than the specified percentage are taken into account.
The Frequency of delivery alerting option allows to define the delay between two alert sendings. By default, it is set to 10 minutes.
You can change this setting through the Administration > Application settings > Options menu.
This option applies to all dashboards defined in Adobe Campaign. You cannot set a specific frequency for each dashboard.
The Delivery alerting feature keeps all of your involved Adobe Campaign users automatically informed about the delivery execution status, via email and dashboard.
Now when you receive a delivery alerting notification, here are a few tips on what you can do.
First of all, check the delivery’s Log tab to view all information relating to the delivery and proofs. The red and yellow icons allow you to identify errors or warnings. The red icon indicates a critical error that prevents the delivery from being started.
To view the history of every occurrence of a delivery, select the Sending logs tab. It contains the list of sent messages and their statuses. There you can check the delivery status for each recipient ( Sent, Pending, Failed, etc.). For more on this, see Sending logs.
Here are a few possible reasons for receiving alerting notifications according to the criteria that are met for a delivery.
Deliveries failed: This criterion informs you of all deliveries with an erroneous status. It can be due to:
If the delivery is triggered with a workflow, check if that workflow was correctly started. For more on this, see Executing a workflow. Otherwise, get in touch with your Adobe Campaign administrator to solve the issue.
Deliveries with preparation failed: An error can occur during delivery preparation in the following cases:
The possible causes for a Delivery with bad error ratio for soft bounces alert can be:
For more information, check the Exclusion logs and Exclusion causes tabs of the delivery logs. See Exclusion logs.
The possible causes for a Delivery with bad error ratio for hard bounces alert can be:
To avoid soft and hard bounce errors, follow the best practices below:
Deliveries with long start pending: Usually this means that there is a problem at the MTA’s (Message Transfer Agent) level. The execution process is waiting on the availability of some resources. The MTA may have not been started.
Deliveries with low throughput: Again, this is a deliverability issue meaning that the MTA is too slow.
For more on these issues, get in touch with your Adobe Campaign administrator.