.. include:: /Includes.rst.txt

.. _mail-report:

===========
Mail Report
===========

If you had included links to internal or external pages in the mail content and also enabled click tracking in the
MAIL configuration module, you can also check which links were clicked and how often.
To do this, move to the report's module by clicking on the pie chart icon:

.. include:: /Images/MailReports.rst.txt

To get the report of a specific mail, click on the corresponding mail subject:

.. include:: /Images/MailReportDetails.rst.txt

Under the panel "Mail" you can see some basic stuff.

Under the panel "Performance" you can see some metrics about the responses.

This numbers, especially "Unique responses (links clicked)" and "Total responses/Unique responses" are taken from the
code developed from the EXT:direct_mail team.

I have no clue, how relevant they are and even show the right values.
If someone with marketing skills could give me feedback about it, I would really be happy.

.. _mail-report-returned:

The panel "Delivery failed" shows the different types of returned mails:

*  **Recipient unknown**: the address does not exist or the account is disabled.
*  **Mailbox full**: the mailbox of the recipient has no space left.
*  **Bad host**: the server of the recipient could not be reached or the domain does not exist.
*  **Blocked by policy or spam filter**: the receiving server refused the mail, for example as spam. The address itself is
   fine, so these recipients are not disabled with the button "Disable returned recipients".
*  **Temporary problems**: soft bounces, for example greylisting or a server that is not reachable at the moment. The
   sending is tried again by the mail server of the sender or it is not a problem of the recipient at all. These recipients
   are not disabled either.
*  **Error in Header**: the mail was refused because of its structure or its size.
*  **Reason unknown**: the returned mail contains no explanation, which could be understood.

..  note::
    This data only will be filled if return-path for mails is set and AnalyzeBounceMail-Command-Controller is configured correctly.
    :ref:`See Command Controller Reference <analyze-bounce-mail-command-controller>`

If returned mails found, a forth box will appear, to view, delete or disable the corresponding recipients.

..  note::
    This only works, if :guilabel:`Privacy click tracking` inside :guilabel:`Mail > Configuration > Links and click tracking` is deactivated.

..  note::
    It it possible to exclude links from tracking, by adding `data-do-not-track` as attribute.