Message Personalization

Introduction

 

With ListManager, you can easily create unique, one-to-one emails tailored to the exact needs and interests of your recipients, without having to create more than one message. There are three major categories of message personaliztion: Mail Merge, Conditional Content, and Advanced Scripting.

Mail Merge Tags let you insert directly into your email messages information from your database, or from procedures ListManager performs. The classic example of this is to write "Dear Bob" in Bob's email, "Dear Mary" in Mary's, and so on.

Conditional Content Commands allow you to insert blocks of text into your message depending on whether certain conditions are true for a particular recipient. As a simple example, suppose you know that Bob has a dog, but Mary does not. You can tell ListManager to add a special paragraph promoting dog biscuits into all messages going to customers who have dogs. Bob would get this special paragraph in his email, while Mary would not.

Advanced Scripting allows you to insert complex, highly dynamic content in your message. In ListManager, message personalization take advantage of a highly flexible programming language called Tcl. You don't have to be a great programmer to create and use custom scripts! This manual will show you a variety of easy templates for you to follow to create Tcl scripts. People with programming experience will also find that Tcl is a very powerful tool for extending the functionality of their messages.

How Do I Use ListManager's Personalization?

 

All mail merge tags, conditional content commands, and advanced scripts must begin and end with double percent signs (%%). Upon sending, ListManager will automatically replace the script with its appropriate result in the outgoing message.

 

For example:

 

%%merge Members_.FullName%%

 

will be replaced by ListManager with the full name of the message recipient, or a blank if no name is in the database table.

 

If you want double percent signs (%%) to appear in the actual outgoing message for some reason, you can place a "\" before the "%%". The "\" will prevent the delimited script that immediately follows from being executed and replaced.

 

Note that your %%-delimited scripts will only work if you enable scripting in your list settings. If scripting is not enabled, then the script text will appear without being replaced.

 

Documentation Overview

 

The sections below explain ListManager's personalization and scripting features, with numerous examples of common tasks:

 

1.   How Mail Merge Tags Work

1.   Mail Merge Short Tags

2.   How To Format Dates

3.   Fetching Data from a Web Server

4.   Troubleshooting Merge Tag Problems

2.   Conditional Content Commands

1.   iffield

2.   ifcondition

3.   ifboolean

4.   ifrange

5.   ifdate

3.   Advanced Scripting Index

1.   Scripting Introduction

2.   Conditional Statements

3.   Script Execution Points

4.   Error Handling and Debugging

5.   ListManager Tcl Procedures

6.   ListManager Tcl vs. Standard Tcl

4.   Lyris ListManager Mail Merge (from previous versions of ListManager, now replaced by Mail Merge Tags)



EnterList Using Mail Merge Tags