Creating CampaignSend Templates
You can create a range of different email templates for your clients, depending on the type of email they're trying to send.
We've provided simple but flexible template tags that you insert into your client's HTML email template that allow your client to add their own content when creating a campaign.
Quick Example
To illustrate what you can do with the different template tags, let's take a look at an example. You've just designed an email newsletter concept for your client "ABC Widgets" and now you want to import it into your client's account.
Download the template for this sample campaign (.zip with Photoshop files - 2.5mb)
We've divided the newsletter up into 5 specific areas and we'll look at each these areas separately.
1. Repeating items
If your email is going to have an unknown number of repeating items, such as individual stories or features, then the
Here's the syntax for a repeating item that includes a title, description and image.
<repeater>
<$title link='true' default=''$>
<$description default=''$>
<img src="<$imagesrc link='true'$>" width="200">
</repeater>
As you can see, the entire repeating area is wrapped in an opening and closing
If you want to include an image in the repeater, place the <$imagesrc$> tag in place of the normal image URL. You'll notice we also specify a width for this image. This means that every image your client adds to their repeating items that is larger than 200px will be resized down to that width. Narrower images are not resized.
You can include any HTML and CSS formatting within the
<repeater>
<p class="repeaterTitle"><$title link='true' default='Add the title
for the latest special here'$></p>
<img class="imgBorder" src="<$imagesrc link='true'$>" width="142"
hspace="12" vspace="10" align="right">
<$description default='Summarize the special deal in a single
paragraph'$>
</repeater>
Make your title or image a link (optional)
By adding the optional link='true' attribute to your title or imagesrc tags, your client can easily add an associated link to that element via the editor.
Set default values for title and description (optional)
By adding the optional default='Your text here' attribute to your title or description tags, we'll display that text instead of the standard "title" or "description" placeholder text. This can be great to add reminders or guidelines to your templates that give your client a better indication of what content to add where.
2. Table of contents
If you've got a repeating item in your email, we can automatically create a table of contents for your client based on the title the client adds (which will be inserted where you have the <$title$> tag). Here's the syntax:
<tableofcontents>
<$repeatertitle$>
</tableofcontents>
Just like the repeating item, we wrap a
Here's a sample of how the table of contents would be formatted for our example email:
<table width="100%" cellspacing="0" cellpadding="5" border="0">
<tableofcontents>
<tr>
<td nowrap valign="top"><img src="arrow.gif" width="12"
height="5" border="0"></td>
<td width="100%" class="tocDivider"><$repeatertitle$></td>
</tr>
</tableofcontents>
</table>
Please note: You need to have a
3. Individual items
For all those one-off bits of text or images that don't need to repeat, you can use the individual item tags. These include:
<$title link='true' default=''$>
<$description default=''$>
<img src="<$imagesrc link='true'$>" width="200">
Your client will have full WYSIWYG editing capabilities for the <$description$> content. Just like inside a repeater, place the <$imagesrc$> tag in place of the normal image URL you want your client to be able to update. Make sure you specify a width for the image, as any image your client adds in its place will automatically be resized to that width.
Make your title or image a link (optional)
By adding the optional link='true' attribute to your title or imagesrc tags, your client can easily add an associated link to that element via the editor.
Set default values for title and description (optional)
By adding the optional default='Your text here' attribute to your title or description tags, we'll display that text instead of the standard "title" or "description" placeholder text. This can be great to add reminders or guidelines to your templates that give your client a better indication of what content to add where.
4. Link to a web based version
It's considered best practice to link to a web based version of your email for those recipients that prefer to read your email in their browser, or are using an outdated email environment that does not support your email formatting. The syntax for this is:
<webversion>link text or image</webversion>
Anything in between these 2 tags will become a link to the web-based version of your template, which will reside at your client's personalized sub-domain.
5. Forward to a friend
By adding a forward to a friend link to your client's template, their recipients can easily pass the email on to up to 5 friends at a time. You can even customize how this Forward to a Friend page looks for each of your clients. To include a Forward to a Friend link, use the following tags:
<forwardtoafriend>link text or image</forwardtoafriend>Anything in between these 2 tags will become a link to this client's customizable Forward to a Friend page, which will reside at the generic forwarding domain forward-email.com.
6. The all important unsubscribe link
Every template you design must include a single-click unsubscribe link. You can customize what happens when this link is clicked on a per-list basis. The syntax for the unsubscribe link is:
<unsubscribe>link text or image</unsubscribe>
Anything in between these 2 tags will become a single-click unsubscribe link for each of your client's recipients.
7. Date tags
The date tags make it easy to add date related text to a template that updates based on when your client sends their email campaigns. Instead of relying on your client to add the text "November Newsletter", you could automate this by using the current month name tag, such as "<$currentmonthname$> Newsletter". We'll populate the tag with the month the campaign is being sent automatically when they send the campaign.
The following date tags can be used anywhere in your templates:
<$currentday$>
<$currentdayname$>
<$currentmonth$>
<$currentmonthname$>
<$currentyear$>
Let's say your client sends a campaign on Wednesday, 18th October 2006. Each tag will be converted as follows:
<$currentday$> = 18
<$currentdayname$> = Wednesday
<$currentmonth$> = 10
<$currentmonthname$> = October
<$currentyear$> = 2006
8. Personalization tags
By adding any of the following tags to your subject or campaign content, we will dynamically change these values for every recipient when sending the campaign.
[firstname,fallback=customer] = First name
[lastname,fallback=customer] = Last name
[fullname,fallback=customer] = Full name
[email] = Email address
When personalizing a recipients name, you can provide a fallback value which is displayed if that field is empty for that recipient. If you would like nothing displayed when a recipient's name field is empty, simply leave the fallback value blank (e.g. [firstname,fallback=]).
You can also insert the values of up to 10 custom fields into your emails in a similar way.
