2018.2

Table Of Contents
Note
The ESP might also have a test function you can use. Check the options of your ESP.
Tip
For a detailed description of how to use Mandrill to send and track emails, see the following how-
to: Using Mandrill.
Adding custom ESP handling instructions
Most ESPs allow you to provide custom handling instructions as part of the email message, via
custom headers. Typically these include instructions to enable open rate tracking, click through
rate tracking and assign tags/categories to messages. Assigning a tag/category allows you to
view statistics per email type in the dashboard of the ESP. Note that each ESP has its own
notation and instructions.
In a Connect template, these custom headers can be added via the Email section properties
(see "Meta information" on page455).
Alternatively custom headers may be added through a Control Script (see "Control Scripts" on
page751, "Control Script API" on page1162 and "section" on page1196).
The following samples show how to assign a tag or category to a message for various ESPs.
SendGrid
Dashboard: https://app.sendgrid.com/
Documentation: https://sendgrid.com/docs/API_Reference/SMTP_API/using_the_smtp_
api.html
Add a name meta tag with the value X-SMTPAPI and set its content to the required JSON string
(for example: "' category': ['invoices']"). You can make this setting in the Email section
properties (see "Meta information" on page455) or write a Control Script, for example:
var headerObj = {
"category": ["invoices"]
};
merge.context.sections["Content"].headers = {
Page 1233