You can add personalisation to your transactional emails using personalisation placeholders. The values for the placeholders are sent by your development team in the SMTP headers or by using an API call.
Before you start
Things you need to know:
If you have included a personalisation marker, for example, @ACCOUNTMANAGER@, in your custom reply-to address for the custom from address (CFA) you’re using to send your transactional email, you must include the key-value pair for this marker in the
PersonalisationValuesarray.If you don’t, the reply-to address can’t be correctly populated, and any replies are only forwarded to the Unknown mail forward for the CFA, if set.
Learn more in the section The reply address.
Add personalisation to your campaign template
You can add personalisation to your campaign template by adding a placeholder in your text, for example, Hello @FIRSTNAME@, or We just wanted to let you know that your order (@ORDERREF@) has been despatched.
The personalisation values then need to be included as an array of data stored in key-value pairs in your code, which are included in the SMTP headers or in the API call parameters.
Example
"PersonalisationValues": [{ Name: "FIRSTNAME" , Value: "John" }, { Name: "ORDEREF" , Value: "01234" }]
The value for the matching placeholder name is pulled into the campaign when it’s sent.
Learn more in Sending a transactional email as a triggered campaign in our Developer Hub.
EasyEditor vs. transactional email personalisation
EasyEditor personalisation and transactional email personalisation are two different things. This means you can't use EasyEditor personalisation in a triggered email campaign sent as transactional email; it won't work. If you haven't included the personalisation value FULLNAME in your code, your transactional email @FULLNAME@ placeholder won't have any value pulled through for it and will appear as blank in the sent email.
Transactional email that is sent as a triggered campaign is a multi-part email, which means it is sent in both plain text and HTML versions. Any personalisation you add appears in both versions. However, when you use transactional email personalisation, the type of personalised content needs to be compatible with the HTML element it's being put into. For example, if the code contains a personalised table, the code needs to go into a table element, not a paragraph. Check with your developers to make sure that your campaign elements are suitable for the personalisation content being used.
Once you save your transactional email template, you are warned about placeholder names which don't match to contact data field names; this is done automatically by the EasyEditor standard validation process. Select Save anyway to ignore the warning.
Personalisation values
PersonalizationValues.Value can be string or JSON. All personalizationValues are also available in the data Liquid collection.
For example, you can access the data Liquid collection in EasyEditor by using the following Liquid:
##{{data.order.items[0].title}} costs ##{{data.order.items[0].price}}