2022.2

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,customheadersmaybeaddedthroughaControlScript(see"ControlScripts"
onpage398,"ControlScriptAPI"onpage815and"section"onpage848).
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.
WriteaControlScriptthataddsaheaderwiththenameX-SMTPAPIandsetsitscontenttotherequired
JSONstring(forexample:"' category': ['invoices']").
Forexample:
var headerObj = {
"category": ["invoices"]
};
merge.context.sections["Content"].addHeader("X-SMTPAPI", JSON.stringify(headerObj));
IftheemailisgoingtobesentbytheOLConnectSendGridplugin,theX-SMTPAPIheaderwillnotbe
used.Enterthecategoryorcategoriesintheplugin'ssettingsinstead.
Note: Sendgridstripsouttheirownmailheaders.TheresultsneedtobeverifiedviatheirDash-
boards(e.g.theStatssectionletsyouverifythestatsforspecificcategories).Alternativelyone
canusetheirWebAPItoretrievestatsinJSONformat.Toviewthecategorystats,logintoSend-
Page 880