Messages

Messages

Create a message

To create a new message:

  1. Open the Messages page.
  2. Click on the +Message button.

There are 4 navigation buttons on the upper right corner of the edit form:

HTML editor - the way web email templates are coded so that text is formatted and images are added. This is the way the most subscribers will see your email.

Plain text editor - plain text version of an email the subscribers will see in case the provider blocks the email HTML version.

Message settings - contains general message settings, settings for the dynamic content and integration and other additional settings. Also this menu allows to attach files to the email.

Table of Contents Settings - here a user can set default values for variables used in the messages.

Messages can be saves as a draft. It is different from the regular email as it can be only used to send A/B tests.

HTML editor

Built-in HTML editor allows to easily insert system objects into email.

  1. Tracking pixels
  2. External content
  3. Images
  4. Subscribers details
  5. External JSON
  6. Fragment
  7. Date and time
  8. Unsubscribe URL or Global unsubscribe URL
  9. Confirmation URL
  10. Subscription manager URL

The HTML editor has a preview option.

It is possible to toggle word-wrapping on/off.

Also a user can use the full screen mode.

Plain text editor

Built-in plain text editor allows to create email text version based on its HTML version.

A Generate from HTML version button creates an email text version.

Email settings

General settings:

- Email name - a user will see this name in his messages list.

- Email subject - a subscriber will see the email subject in his inbox. An email subject may include various Emoji.

ALTKRAFT allows to insert Emoji into any part of an email.

- Email settings - From Email and Reply-to settings. These fields will be filled in automatically from the List in case a user leaves them empty.

Dynamic content settings:

- Dynamic JSON content URL

- Integrations

Extra settings:

- Redirect after clicking unsubscribe link - click on the field to insert your own link.

- Redirect after clicking confirmation link - click on the field to insert your own link.

- Suppression list - allows to attach a suppression list to the message.

- Add unsubscribers to suppression list - all subscribers followed the unsubscribe URL will be listed in a suppression list.

- Don’t bake inline CSS - this option affects the appearance of the email. The Don’t bake inline CSS box is unticked as default.

- Attach files - choose files to attach to the message.

Content options

The Content options tab is used to set the default values for variables and to delimit the access to the message fragments.

To insert a variable click on the “Insert variables” tab and choose one from the list. Let’s use {lead.Bank} as an example.

A field will appear on the Content options page. A user can fill in the field with the required value.

This value will be used in the message if the field is empty in the subscriber profile. In other case, the value from the profile will be used.

<h1>Deutsche Bank newsletter!</h1>

Drafts

Drafts help to avoid situations when a campaign might be sent before it is ready.

Drafts are marked with a special symbol (see the screenshot).

A user can’t launch the campaign if a draft’s added in it. A user will see the following error message in the log: This message is draft.

Drafts are also used to test a campaign before the launch.

Drafts are connected with the user rights allocation system.

A user with the rights to view, create and edit a message is allowed to create only draft messages.

To be able to send messages and launch campaigns a user needs to be assigned with the Activate access right.

The Message status toggle is at the right bottom corner of the editing form.

Tracking pixels

Tracking pixels are used to collect statistics on the opened and read messages.

Tracking pixels should be used only in the HTML version of the letter, because images can’t be displayed in the plain text version.

To insert a pixel into a message, click on the Add tracking pixels button on the top of the HTML editor control bar.

Each time a subscriber opens a message with pixels, the message was opened or the message was read event is recorded to the history(log).

External content

External content option allows to insert external links to your message. This is handy, when you need the information to be changed in the message automatically.

To insert the link, click on the “Add External Content” button:

Let’s consider the following example:

There is a server that generates daily individual horoscope. The external link to the source will look like:

http://prophecy.my-horoscope.com/?lead-zodiac-sign=scorpion

The subscriber receives plain text message:

<img src="http://prophecy.my-horoscope.com/scorpion-lezet-na-zabor.png" />

<p>Don't worry about a thing, because every little thing gonna be all right!</p>

And here is the example of how a correct external link should look like in the interface (please mind, that you need to use custom field from the subscriber’s profile that contains his zodiac sign info, we use {lead.zodiac_sign} for that purpose):

When the campaign is launched, each subscriber will receive a message with his personal daily horoscope according to the information in his or her profile.

Images

ALTKRAFT allows to upload images and use them in your messages.

To attach an image, click on the Insert image button:

The Upload image button is not displayed on the HTML editor control bar as default. It is available when there is an image from an external source in the letter.

This option allows to upload images to the ALTKRAFT server and replace them in the letter already sent to subscribers.

Replace the image

There can be a situation when the image was attached to the letter by a mistake. ALTKRAFT allows to upload the external images and replace them in case of such situation.

Thus a user is allowed to replace images in the already sent and delivered emails.

External JSON

The dynamic JSON content source is set separately for each message in the message settings menu.

Here is how the information in JSON format is displayed:

 {
    "one": "J",
    "two": "S",
    "three": 0,
    "four": "N",
    "text": "Hello!"
}

To add JSON content, insert the link to the content source into the message.

If the link is correct, the following JSON fields will be available:

To insert a JSON key, click on the Insert variable button at the HTML editor control bar:

JSON content helps to automate the uploading of new subscriber details without changing it in the message.

Subscriber details

Subscriber details are used for personalized emails. For example: Hello, Eddie!

A user can add subscriber details both in the HTML and plain text version of the email.

To add the standard fields details, click on the </> sign and choose From Subscriber from the pop-up menu.

To insert a subscriber’s name, choose the following JSON key:

{lead._fname}

Here you can find the full list of the standard fields names and JSON keys.

To add the custom fields details, choose the following JSON key:

{lead.Custom_Field_Name}

The “Custom_Field_Name” is the name of a custom field. Please note, that the custom field should have a name as it is in the list.

If the chosen fields are empty in the subscriber profile, a user can fill them in with the default values. To set a default value, open the Units tab in the message settings menu.

Default values for personalized messages

There are situations when there is a lack of subscriber details to create a personalized letter. That’s why ALTKRAFT has a feature that allows to set the default values.

For example, a user wants to greet a subscriber by the name:

<p>Hello, {lead._fname} !</p>

If the Name field is empty in the subscriber details, the letter will look like: - Hello, !.

To avoid such situations, a user can set a default value for that field.

Open the Content options tab in the message settings:

Insert the default value into the Field value, if empty field:

Date and time

Date and time variable will record the date and time of the moment the message’s sent.

This variable may be used in any order:

<p> {month}/{day}/{yearlong} </p>

There are 4 system link types:

Unsubscribe URL - the unsubscribe link allows the subscribers to remove their email addresses from the List they are subscribed to.

{unsubscribe}

Global unsubscribe URL - the subscriber’s email address will be listed in the Global suppression list. Global unsubscribe URL allows subscribers to unsubscribe from all the Lists at once.

{globalunsubscribe}

Confirmation URL - {confirm_sub} is used to confirm a subscription in opt-in letters. And {confirm_msg} is used to activate the action trigger (url click) in others.

{confirm_msg} - for a regular message
{confirm_sub} - for an opt-in message

Subscription manager URL - gives a subscriber access to the built-in subscription manager.

{preferences}

Only Master-users are allowed to add the Confirmation and Unsubscribe URLs: Profile >> Setup >> URL Keys.

To set the links, open the Message settings menu and scroll to the Extra settings:

Fragments

Fragment is a part of the HTML code or text that can be saved as a variable and used in a message.

If you change a fragment, all messages, where this fragment’s used, will be changed too. This speeds up some work processes in the system.

Fragments support the same variables as messages do, except the external HTML content.

ALTKRAFT allows to disable tracking for certain links in the message.

To disable link tracking in the email HTML version use the no-track=“true” or no-track attribute:

<a href="http://www.ferrari.com/en_ru/" name="Ferrari" no-track="true">Ferrari</a>

<a href="http://www.ferrari.com/en_ru/" name="Ferrari" no-track>Ferrari</a>

As a result you will have a short link in the message - http://www.ferrari.com/en_ru/, but please mind that clicks won’t be recorded.

It is also possible to disable image tracking:

<img src="http://picture.jpg" no-track="true"/>

Here is the way the link tracking may be disabled in the email plain text version:

Website (Link: http://www.ferrari.com/en_ru/ <no-track>)

ALTKRAFT allows to setup a link, so that certain fields in the subscriber profile will update after the subscriber clicks the link.

See the following examples for the email HTML version:

This will update the First Name - _fname and Last Name - _lname fields after the subscriber clicks the link.

<a href="http://www.link_10.com" name="link_10" update-_fname="Mr." update-_lname="Frog">link</a>

To update custom fields, enter the field name (as it is listed in the List) after update-.

<a href="http://www.link_20.com" name="link_20" update-Custom_Field="Foxxy">link</a>

Click this link to open the full list of the standard fields names (_fname, etc.) for update-

If the Link tracking is disabled, subscriber details won’t update (no-track=“true” link attribute is )

Data can be taken from:

1. Lines.

update-field_name="value"

2. JSON content.

update-field_name="{{.Json.one}} and {{.Json.two}}"

3. Other subscriber details.

update-field_name="{lead._fname} and {lead._lname}"

ALTKRAFT allows to setup a link, so that certain fields in the subscriber profile will update after the subscriber clicks the link.

See the following examples for the email plain text version:

This will update the First Name field value in the subscribers profiles:

Link: (http://www.bugatti.com/chiron/ <update-_fname="ABC">) this is link.

If the Link tracking is disabled, subscriber details won’t update (no-track=“true” link attribute is )

Click this link to open the full list of the standard fields names (_fname, etc.) for update-

Standard fields list

First Name ....... {lead._fname}
Last Name ........ {lead._lname}
Date of Birth .... {lead._bdate}
Gender ........... {lead._sex}
Reg Date ......... {lead._regdate}
Reg IP ........... {lead._regip}
Reg City ......... {lead._regcity}
Reg Country ...... {lead._regcountry}
Reg URL .......... {lead._regurl}
IP ............... {lead._ip}
City ............. {lead. _city}
Country .......... {lead._country}
Vendor Source .... {lead._vendor}