Skip to main content

Actito Transactional Messaging Syntax

DescriptionCompositionAccepted ValuesExamples
Text part
Defines the text part of a message[EMV TEXTPART]text message contenttext message content: text content of the message[EMV TEXTPART]
Dear [EMV FIELD]FIRSTNAME
[EMV /FIELD]...
HTML part
Defines the HTML part of a message[EMV HTMLPART]HTML message contentHTML message content: HTML content of the message[EMV HTMLPART]
<html>
<body>
Dear [EMV FIELD]
FIRSTNAME[EMV /FIELD]...
Tracked link
Tracks the links contained in the messageGeneral tracking:
[EMV LINK]link ID[EMV /LINK]

Localized tracking
<a href="[EMV LINK]link ID[EMV /LINK]">link name</a>
link name: the name of the link as it should appear in the message
link ID: the ID number of the link. You need to have added the link in the Link Management feature to obtain a link ID.
General tracking examples
[EMV LINK]1[EMV /LINK]

Localized tracking examples<a href="[EMV LINK]1[EMV /LINK]">Actito</a>
Dynamic Content Block
Adds a dynamic content block to the message[EMV INCLUDE]Dynamic Content Block ID[EMV /INCLUDE] Dynamic Content Block ID: the ID of the dynamic content block[EMV INCLUDE]123[EMV /INCLUDE]

Personalization

DescriptionCompositionAccepted ValuesExamples
Push Field
Adds a dynamic parameter that is injected when the transactional message is triggered to be sent (e.g., a name retrieved from a webform).[EMV DYN] parameter[EMV /DYN]parameter: the dynamic parameter[EMV DYN]FIRSTNAME[EMV /DYN]
Push Content
Adds a pre-formatted HTML block that is injected into the transactional message when it is triggered to be sent.[EMV CONTENT] ID[EMV /CONTENT]ID: the ID number of the content[EMV CONTENT]1[EMV /CONTENT]
If
Adds conditional personalization to your message by entering different versions of HTML and/or text in the message depending on the value contained in a database field[EMV IF]valueoperatorfield
[EMV THEN]displayed-content[EMV /THEN]
[EMV /IF].
value: the value that the operator acts on
operator:
  • =
  • !=
  • >
  • >=
  • <
  • <=
  • contains
field: any database field name
displayed-content: the content that will be displayed if the condition is met
[EMV IF]POINTS>30000
[EMV THEN]
Congratulations! You have over 30,000 points.[EMV /THEN][EMV /IF]
Multiple If
Adds conditional personalization to your message by automatically entering different versions of HTML and/or text in the message depending on the value contained in one of selection of database fields[EMV IF]"value"operator{field1, filed2, filed3, field4}
[EMV THEN]displayed-content[EMV /THEN]
[EMV /IF].
value: the value that the operator acts on
operator:
  • =
  • !=
  • >
  • >=
  • <
  • <=
  • contains
field1, field2: , etc: database field names
displayed-content: the content that will be displayed if the condition is met
[EMV IF] "football" in {sport1, sport2, sport3, sport4} [EMV THEN]Since you are a football fan, you will receive two free tickets to the next game! [EMV /THEN][EMV /IF]
Switch
Adds combined conditional personalization to your message by creating multiple conditions each with their own HTML and/or text input[EMV SWITCH]field
[EMV CASE]value[EMV /CASE]
[EMV CASE]value[EMV /CASE]
[EMV /SWITCH].
field: any database field name
value: the value that the operator acts on
[EMV SWITCH] country
[EMV CASE]"France": Special offers for French citizens![EMV /CASE]
[EMV CASE]"United Kingdom": Special offers for British citizens! [EMV /CASE]
[EMV /SWITCH]
Date/Time
Enters the recipient's local date and time in the message[EMV SYSDATE]date-format,country-code [EMV /SYSDATE]date-format: the date format
country-code: the country code
[EMV SYSDATE]
dd/MM/yyyy,fr
[EMV /SYSDATE]

HTML, Text, and Multipart Message Syntax

Your message content needs to be defined as being HTML, text, or both. When you create a new message in Expert mode, you will see that the message content field already contains the following tags:

    [EMV TEXTPART]
[EMV HTMLPART]
<html>
<body>

</body>
</html>

Text Email Syntax

The [EMV TEXTPART] tag precedes the text part of the message. You should enter your text after this tag. If you want to create a message consisting of only text, delete the other tags.

HTML Email Syntax

The [EMV HTMLPART] tag precedes the HTML part of the message. You should enter the body of your HTML email content between the <body> and </body> tags. If you want to create a message consisting of only HTML, delete the [EMV TEXTPART] tag.

Multipart Email Syntax

To create a multipart message (i.e., a message in both text and HTML format):

  • Either enter the body of the HTML message content between the <body> and </body> tags and then click Copy Html to text to automatically create a text version of the HTML.
  • Or enter the text part of the message after the [EMV TEXTPART] tag and the body of the HTML message content between the <body> and </body> tags.

When you upload content, Actito replaces the existing content with your uploaded content automatically detecting the format so that the appropriate tag precedes it. If you copy and paste content into the message content field, make sure that you paste it between the appropriate tags.

Links can be tracked per link or per link location. In other words, if you have multiple identical links in different parts of your email, you can choose to track the all identical links as one or track each instance individually.

General Tracking

General tracking allows you to add the tracked link coding to the message invisibly. Any link listed in the general tracked link code will be tracked. However, if you have the same link in two locations in the message and want to track them separately to find out which location attracts more clicks, you should use localized tracking.

If you want to associate an ID to your link:

  1. Add the link through the Link Management feature but instead of clicking Choice2: Save/Add Link, just click Choice1: Save Link.
  2. Note the ID number to insert it between the tracked link tags.
Example
    [EMV LINK]1[EMV /LINK]

Localized Tracking

Localized tracking allows you to track every link individually. If the same link is present in multiple places in the message, each instance will be tracked separately.

If you want to associate an ID to your link:

  1. Add the link through the Link Management feature but instead of clicking Choice2: Save/Add Link, just click Choice1: Save Link.
  2. Note the ID number to insert it between the tracked link tags.
Example
    <a href="[EMV LINK]1[EMV /LINK]">Actito</a>

Dynamic Content Block Syntax

To add dynamic content block to a message:

In the part of the Message where you want the dynamic content block to appear:

  1. Enter [EMV INCLUDE]
  2. Followed by the dynamic content block ID number
  3. Followed by the [EMV /INCLUDE] closing tag.
Example
    [EMV INCLUDE]123[EMV /INCLUDE]

Personalization Syntax

To better understand personalization and to be able to add personalization manually, you need to understand the syntax used.

Push Parameter Personalization

A push parameter is a parameter that is injected into a transactional message when it is triggered to be sent (e.g., a name retrieved from a webform).

Example
    Dear [EMV DYN]FIRSTNAME[EMV /DYN]

Advanced Content Personalization

Advanced content is a pre-formatted HTML block that is injected into a transactional message when it is triggered to be sent. It is identified by its ID number.

Example
    [EMV CONTENT]1[EMV /CONTENT]

If Personalization

If personalization allows you to add conditional personalization to your message by entering different versions of HTML and/or text in the message depending on the value contained in a personalization parameter.

The following operators and value formats can be combined in If personalization:

  • Operators
  • Value formats
Example
    [EMV IF]POINTS>30000
[EMV THEN]Congratulations! You have over 30,000 points.[EMV /THEN]
[EMV /IF]

Multiple If Personalization

Multiple If personalization allows you to add conditional personalization to your message by automatically entering different versions of HTML and/or text in the message depending on the value contained in one of a selection of personalized parameters.

The following operators and value formats can be combined in Multiple If personalization:

  • Operators
  • Value formats
Example
    [EMV IF] "football" in {sport1, sport2, sport3, sport4} 
[EMV THEN]Since you are a football fan, you will receive two free tickets to the next game! [EMV /THEN]
[EMV /IF]

Switch Personalization

Switch personalization allows you to add combined conditional personalization to your message template by creating multiple conditions each with their own HTML and/or text input.

The following value formats can be used in Switch personalization:

  • Value formats
Example
    [EMV SWITCH] country
[EMV CASE]"France": Special offers for French citizens![EMV /CASE]
[EMV CASE]"United Kingdom": Special offers for British citizens! [EMV /CASE]
[EMV /SWITCH]