Table of Contents Previous Next Index

Section 12 Completed Jobs

Section 12 Completed Jobs
The Completed Jobs Screen contains a list of all email jobs that have attempted delivery and the present state they are in, either processed successfully or failed during delivery. To access this screen, perform one of the following actions:
From the Toolbar, click Mail Job > Completed Jobs.
From the Dashboard, click the Completed Jobs link located in the Currently in the System section.
Figure 12-1 The Completed Jobs Screen
From this screen, you can:
Display jobs in a specific category – Click the Display jobs with category drop-down menu and select the category of jobs you want to view in the list.
Sort the job listing – The column headers in the table are links that, when clicked, will sort the jobs in ascending (one click) or descending (two clicks) order. Each subsequent click will reverse the sort order.
Note: It is not possible to sort the table using the Owner column.
View the details for any job – Click on the Job ID to open the Completed Job Details screen, which is where you can edit or view various parts of the job.
Jobs that were successfully processed by LISTSERV Maestro are represented by a green checkmark.
Jobs that fail to be processed are represented by a red x. This means that LISTSERV Maestro was unable to send the job to LISTSERV.
Important: A job might be processed successfully but still fail to be delivered. The processing state only describes the success or failure of the act of transferring the job to LISTSERV. If, for some reason, LISTSERV fails to actually deliver the job, then no message(s) will be sent and the job will be listed in the successful state.
12.1 Advanced Filter Settings
The Completed Jobs: Advanced Filter Settings screen lets you activate and define an advanced filter for the Completed Jobs list. To access this screen, click on the Advanced Filter Settings link on the Completed Jobs screen.
Select if the current filter will be active or inactive.
If the filter is set to active, then only jobs that fulfill the filter condition will be displayed in the list. Define the active filter condition as follows:
Job ID starts with or Full Job ID starts with – Enter a text string that is used as a "starts with" filter for the job ID. Only jobs where the job-ID (or the full job-ID, including the ID-prefix) starts with the given text will be included. Whether or not the job-ID or the full job-ID will be used for filtering is determined by your preference setting for job-ID prefix. If the prefix is included in the job list, then this filter will be applied to the full job-ID, including the prefix (as it is displayed in the job list). If the job-ID prefix is not included, then this filter will only apply to the bare job-ID, without the prefix. Leave this field empty if you do not want to filter over the job ID.
Job Title contains – Enter a text string that is used as a "contains" filter for the job title. Only jobs where the job title contains the given text string (case sensitive) will be included. Leave empty if you do not want to filter over the job title.
Date/Time of Sending – Enter a From and/or a To date and time (in the displayed format) to define a time range filter. If only a From date/time is entered, only jobs where the date/time is the given date/time or later will be included. If only a To date/time is entered, only jobs where the date/time is the given date/time or earlier will be included. If both a From and To date/time is entered, only jobs where the sent date/time is between the two given borders (including the borders themselves) will be included. Leave empty if you do not want to filter over the date/time.
Recipients Count Range – Enter a From and/or a To range to define a number range filter. If only a From number is entered, then only jobs where the number of recipients is the given number or higher will be included. If only a To number is entered, then only jobs where the number of recipients is the given number or lower will be included. If both a From and To number is entered, then only jobs where the number of recipients is between the two given borders (including the borders themselves) will be included. Leave empty if you do not want to filter over the number of recipients.
Job State – Select one of the jobs states (OK or Failed) to define a job state filter. Only jobs with the matching job state will be included. Select <Ignore> if you do not want to filter over the job state.
Owner – If applicable, select an owner from the drop-down menu. Only jobs with the matching owner will be included. Select <Ignore> if you do not want to filter over the owner.
Mail Type – Select one of the mail types (HTML or Plain) to define a mail type filter. Only jobs with the matching mail type will be included. Select <Ignore> if you do not want to filter over the mail type.
Figure 12-2 Advanced Filter Settings
Note: If you define any filter settings and later set the filter to "inactive", then the filter settings will still be remembered, which means you can easily activate them again at a later time.
12.2 Auto-Repeat Sequences in the Delivered Jobs List
Only the first job of an auto-repeat sequence is normally shown in the list of completed jobs. This is to avoid making the list overly long, filled with many jobs with the same job title, but with different Job IDs and delivery times. The first job of a sequence is marked by the Sequence icon.
By clicking on the Sequence icon, the sequence expands and displays all jobs in that sequence. From there, select any of these jobs by clicking on its ID. To hide the sequence jobs, simply click on the Sequence icon again or click on the icon of a different sequence, which will expand that other sequence and hide the sequence that was previously expanded. Only one sequence can be shown at a time.
Note: A job might be processed successfully but still fail to be delivered. The processing state only describes the success or failure of the act of transferring the job to LISTSERV. If LISTSERV fails to deliver the job, no messages will be sent, but the job will still be in the “successful” state inside of LISTSERV Maestro. For example, if a job is sent to a LISTSERV list with the Standard list submit option, and using a sender address that is not authorized to post to the list, then the job will be successful, but LISTSERV sends an error message to the non-authorized email address, and no messages to recipients are actually delivered.
Tip: If a user suspects that a job that is shown as “successful” was actually never sent – for example, because recipients report that they never got the message – then the administrator should check the LISTSERV logs to find out what happened to the job.
12.3 Multiple Job Actions
From the Completed Jobs screen, you can also perform certain actions on several jobs at once by using the Multiple Job Actions feature. This feature is normally disabled. To enable it, click Mail Job > Multiple Job Actions > Enable Multiple Job Actions. The Completed Jobs screen will refresh and each job will have a checkbox next to it. In addition, the Mail Job menu will show additional entries that can be performed on several jobs at once.
Figure 12-3 Multiple Job Actions for the Ongoing Jobs Screen
To manipulate several jobs at once, check all jobs that you want to edit and then select the desired option from Multiple Job Actions submenu (located on the Mail Job menu). These options include:
Edit Category of All Selected Jobs – Opens the Edit Category of All Selected Jobs screen. Select or define the category that you want to assign to the selected jobs.
Edit Team Collaboration of All Selected Jobs – Opens the Edit Team Collaboration of All Selected Jobs screen. Grant (yes), revoke (no), or keep as is (keep) the team collaboration permissions for the selected jobs. You can also load the permissions from a specific job and then apply these permissions to the selected jobs.
Move All Selected Jobs to Archive – Opens the Move Selected Jobs to Archive screen. Click [Move to Archive] to move the selected jobs to the archive. Archived jobs will no longer be viewed from within LISTSERV Maestro until they are imported by the administrator.
Delete All Selected Jobs – Deletes the selected jobs.
Select All – Selects all of the jobs in the list.
Unselect All – Unselects all of the jobs in the list.
Disable Multiple Job Actions – disables the feature and hides the additional checkboxes.
Note: Once the Multiple Job Actions feature is enabled, then it will be enabled on all other job list screens (i.e. the Open Jobs Screen and the Ongoing Jobs Screen) until you disable it again.
12.4 Completed Jobs Summary
The Summary tab of the Completed Job Details screen displays information about the completed job. Click on View adjacent to a section to see more information on that particular section. Two additional links are available here – Update bounce count and View bounce details (See Section 12.4.1 Viewing Bounce Details for more information).
Figure 12-4 Completed Jobs Summary
12.4.1 Viewing Bounce Details
From the Summary tab of the Completed Job Details screen, it is possible to update the bounce count and generate a graphical representation of the number and type of bounces for the job. Click on the View bounce details link to open the Bounce Details screen.
The Bounce Details report is comprised of color-coded bars that represent the number and type of bounces. The top bar displays the total number of al bounces. The bars below represent the total number of bounces divided into different bounce types. Bounce types are based on RFC error codes that define the characteristics of why the message bounced. The codes are documented in RFC 1893 "Enhanced Mail System Status Codes".
LISTSERV Maestro groups bounces into types based on the codes specified in this RFC. The group types LISTSERV Maestro uses are:
Unknown delivery errors (RFC 1893 4.0.x and 5.0.x).
All otherwise unspecified errors.
Address related errors (RFC 1893 4.1.x and 5.1.x).
Includes errors like "Unknown user at host" or "Unknown host".
Recipient mailbox related errors (RFC 1893 4.2.x and 5.2.x).
Includes errors like "Recipients mailbox full", "Mailbox disabled" or "Mail too large".
Mail system related errors (RFC 1893 4.3.x and 5.3.x).
Includes errors like "Mail system full" or "Message too big for system".
Network related errors (RFC 1893 4.4.x and 5.4.x).
Includes routing errors and errors like "No answer from host" or "Bad connection".
Mail protocol related errors (RFC 1893 4.5.x and 5.5.x).
Errors on the mail protocol level.
Message content related errors (RFC 1893 4.6. x and 5.6.x).
Includes errors like "Conversion failed" or "Conversion not supported".
Security or policy related errors (RFC 1893 4.7.x and 5.7.x).
Errors for security or mail system policy reasons, like "Delivery not authorized".
For more information on RFCs, see Appendix D: Email Related RFCs.
Use the check box adjacent to each bar to select it for download. Use the drop-down menu to download only those email addresses that bounced, or the email addresses with the delivery failure information included.
12.4.2 Viewing Content Details
The Detailed Content Information screen lets you view the content and tracking information of an email job that has already been delivered, that is currently being sent, or that is authorized for sending and currently waiting for the scheduled send time.
To access this screen, click on the View link in the Content section of the Completed Job Details screen.
Figure 12-5 Viewing Content Details
View the subject line, message body, attachment list, and tracking information by switching between the available tabs. If the message is an HTML message with a plain text or AOL format alternative, then you may also view these alternatives.
Use the available download buttons and links to download the HTML body and/or attachments. HTML files will be downloaded in a ZIP format (compressed archive). Depending on the type of the attachment, it will either be saved to a disk or opened directly in your Internet browser.
If drop-in content is enabled for the message, then you can toggle resolution of drop-in elements with the Resolve Drop-Ins option, allowing you to display the drop-in placeholders instead of their drop-in content. If errors have been encountered while LISTSERV Maestro tries to replace the drop-in placeholders with the drop-in content, then an error message is displayed and the un-replaced drop-in placeholders are highlighted in the message preview.
If the message contains links that are tracked for click-through tracking (either in the plain text body, the HTML body, or any of the alternatives), you can toggle highlighting of the tracked links with the Highlight tracked links option.
Also for a message with link tracking, you can use the Show Click Rates option to view the click rate of each tracked link directly here in the content: If the option is enabled (checked), then a marker pin will be "pinned" into each tracked link, where the head of the pin displays the click rate, both as a numerical value and as a pie chart.
The click rates are displayed as a percentage value, showing how many percent of the recipients have clicked the corresponding link. You can click on a marker pin to see details about each link, which include the actual tracked URL, the tracking alias (if any), the click rate (in percent), and the absolute number of unique clicks on the link.
Figure 12-6 Show Click Rate Details
In addition, while the Show Click Rates option is enabled, the text just below the option will display the date and time when the click rate tracking data that is displayed was retrieved from the database. Click on the Refresh link to refresh the data.
Note: LISTSERV Maestro does not discern between multiple occurrences of the same URL if they are also using the same tracking alias; therefore, if a tracked link appears at least twice with the exact same URL and alias, be it in the same content part or in different content parts, then the click rate that is displayed on each link's marker pin (and in the details popup when you click on a pin) does not display the actual unique clicks on the marked link, but instead the accumulated total rate of all links with the same URL and alias combination.
12.5 Completed Jobs Reports
On the Completed Job Details screen, click the Reports tab to generate a quick report on the current job (as long as tracking has been switched on for the job in question). Quick reports are predefined report types that create a temporary report based on the selected report settings and the active email job.
Figure 12-7 Completed Jobs Quick Reports
Creating a quick report is a multi-step process.
First, select the type of report to create. LISTSERV Maestro can produce four basic types of reports depending on the type of recipients and recipient data used in the job:
Event distribution over time – This report type produces a simple line graph showing the number of responses over time. Time is plotted on the x-axis of the chart and event statistics are charted on the y-axis. For more information on event distribution reports, see Section 13.7 Event Distribution Report.
Sum of events – This report type produces a bar graph that shows the number of recipients who clicked on each URL and/or opened up the email message. The length of each bar shows the number of events.
Two types of sum can be chosen for the report – Sum of unique events or Sum of all events. Sum of unique events plots only a single event of each type for each recipient. This report will register “0” (zero) events if blind tracking has been selected for the tracking type during the tracking definition because blind tracking cannot count any event as unique. Sum of all events counts all events triggered for each recipient and is available for blind tracking. For more information on sum of events reports, see Section 13.8 Sum of Events Report.
Recipient Details – The Recipient Details report is only available for personal or anonymously tracked jobs because this report type is linked to recipient profile data. This report type displays a multi-frame table that lists each data source and the profile field columns from the recipients definition. Select the data from the top frame in the table by clicking the Select link. In the lower frame, click Select All to choose all the columns, or Edit to re-order and/or remove columns. Select the file encoding from the drop-down menu. The data will then be ready to download in the form of a ZIP archive file. Click the [Download] button to begin downloading the raw data to a local drive. Raw data can be used in Microsoft® Excel or other statistical software to create detailed reports. For more information on Recipient Details reports, see Section 13.9 Recipients Details Reports.
Event Details – The Event Details report is available for personal, unique, anonymous, and blind tracking jobs. This report displays a table that lists the report type, lists the time period of the report, allows for the selection of encoding for downloading the data, and allows for the selection of the time zone to reference the downloaded data. Click the download link to download the raw data to a local drive. Raw data can be used in Microsoft Excel or third-party statistical analysis software to create detailed reports. For more information on event details reports, see Section 13.10 Event Details Report.
Next, select the source data for the report type. There are five choices depending on the type of message and the tracking selected for the job:
Open-Up events – This option charts all the open-up events for a job. It is only available for HTML messages.
Click-Through events (all links bundled) – This option bundles all click-through events together into one variable charted on the report.
Click-Through events (all links separate) – This option creates separate variables for each click-through event that is tracked.
Open-Up and Click-Through events (all links bundled) – This option bundles all the open-up events into one variable and all the click-through events into a second variable charted on the report. This only available for HTML messages.
Open-Up and Click-Through events (all links separate) – This option creates separate variables for each of the open-up and click-through events. This type of data source is only available for HTML messages.
Other data sources can be added to the chart by selecting any or all of the options in the Additional Statistics section. These additional data sources can provide comparison data in the chart so that it is possible to see the total number of messages sent in relation to the number of open-up events that occurred, for example. Three Additional Statistics options are available:
Number of Sent Messages – Adds the number of messages that were sent to LISTSERV as a constant reference value in the report.
Number of Unbounced Messages – Adds the number of unbounced messages as a constant reference in the report. This value shows the number of messages that were sent and not detected as bounces by LISTSERV. This value can go down over time as LISTSERV receives more bounces. This option is only available if LISTSERV handles bounces automatically (selected during the sender definition).
Number of Bounced Messages – Adds the number of bounced messages as a constant value in the report. This value shows the number of messages that were sent but were detected as bounces by LISTSERV. This value can go up over time as LISTSERV receives more bounces. Bounces usually stop coming in after about 5 days. This option is only available if LISTSERV handles bounces automatically (selected during the sender definition).
If the job is part of an auto-repeat sequence, and the report should total all of the data over all of the jobs run in the sequence so far, then check the Include all auto-repeat instances of this job in the report option. Uncheck this option to generate a report for a single run.
Once you’ve selected a report type, a source data type, and any additional statistics using the option buttons. Click [OK] to continue. A report will be generated based on your selections. For a more detailed report or to edit the report, click the Go to the edit page of this report link.
Located at the bottom right side of the Delivered Jobs report are four icons. Each icon opens a screen with different functions and options. The currently selected icon will be highlighted with a blue border. Icons that are unavailable will appear grayed out. These icons appear on all test report, quick report, and regular report pages.
Table 5 Delivered Jobs Report Icons
View Report – Displays the currently selected report with the latest report options.
Download Report – Opens the Download Report Result screen. From here it is possible to download report data in a zipped text file.
Change Results Settings – Opens the Change View Settings for Report screen. From here it is possible to change how the results are displayed and downloaded.
Edit Report / Create Report – Opens the Define Report screen. For delivery tests, it is not possible to save a quick report; therefore, this icon is disabled (grayed out).
For more information on creating and editing reports, see Section 13 Tracking Statistics and Reports.
Figure 12-8 Line Chart Report of Events Distributed Over Time
Tip: When you scroll over the data in the report, a small gray box will display the time period. To display even more information, click on this box. The information in the gray box is expanded and displays links for generating reports based on that particular time period.
To save a quick report as a regular report, click the Create Report icon. This opens the Define Report screen. Click the [Save & Execute] button and the quick report will be saved as a regular report with the same name. Instructions for further editing and using reports are covered in Section 13 Tracking Statistics and Reports.
12.6 Forward-to-a-Friend Report
If the Forward-to-a-Friend feature and “Forward to a Friend” tracking was enabled for an email job, then the Forwards tab on the Complete Jobs Details screen is available. This tab displays a report that charts all forward requests and conversions. Forward requests are forwards requested by users, either by the original recipients or by friend-recipients. Conversion occur when someone joins the membership area using the special {{*SubscribeURL}} link in the forwarded message.
Figure 12-9 The Forward-to-a-Friend Report