The Compose Screen

How to create a standard message

Messages contain all of the content you will be using to deploy to your contacts. When creating a message, you provide the sender information, subject line and template you wish to send. Messages can be re-used over and over again in your deployments to allow you to send the same content to multiple contact segments.

Tutorial

Please note: To try out the feature, click the full screen icon image-1579186565140.png in the tutorial.

 

Getting to know Messages

Getting to know Messages

How to create a message with the Drag & Drop builder

Personalize your emails even further by inserting the information in your Data extension. This can be used for displaying preferred location information or the customer's assigned customer rep. This can create a more one-to-one experience - the type that converts.

Tutorial

Please note: To try out the feature, click the full screen icon Qx1Screenshot-2023-10-26-141632.png in the tutorial.

 

Getting to know Messages

The From Address

The From Address is one of the most important parts of your email campaign. 

It identifies who you are to not only your customers but the ISP's (Gmail, Hotmail, etc.) as well. 

And with any identity, it also indicates your reputation in the space as well. If your a proper email sender who follows all the rules, or a spammer who they should block. 

Below we will discuss specific parts of the from address that might help you decide what to use.


1.  The Sending Domain

 

image-1579286044777.png

 

 


2.  The Local Part

 

image-1579286049644.png

 

 

For more information on dynamic creation of From and Reply-To addresses: Click Here

Getting to know Messages

How to Set Up Effective Click Tracking

Follow this tutorial to setup your message's click tracking in a way that will make your reports easier to read.


 


 

2.  All changes are highlighted in Yellow

 

HighlightedYellow.png

 


3.  Save your work once finished

 

SaveYourWorkOnceFinished.png

Getting to know Messages

How to Preview a Message

Previewing a message is a great way to verify the message you are about to use is correct and to instantly see the changes you have made to the message. 

If you are using dynamic variables or content, it is a great way to verify that the logic and variables you used will work with the data you have collected for your contacts. 

Below are multiple options throughout the system for previewing your message.


1.  The Preview Step

 

PreviewStep.png

 

At any time while setting up a message, you can switch to the "Preview" step and review what your message looks like in different situations. Below are some of the options you have access to.

  1. Contacts - This feature allows you to select contacts that are in your DataMart and see how the message would look to them with their dynamic information.
  2. Required DataMart Fields - This feature allows you to type in values for the DataMart fields that have been used in the dynamic content and preview what the template looks like when a contact has those values.
  3. Combination - This feature allows you to easily cycle through the different combinations of content that are available in the template. 
    • Note: This does not take into account the logic used.
  4. Screen Width - This feature allows you to simulate different screen widths and how your template reacts to them. Note: This does not simulate device specific behaviour.

If you would like a more in depth look at the Preview step and its feature, click here.


2.  Selecting Contacts for Previewing

 

ContactsForPreview.png

 

If you would like to view what your message will look like to other contacts in your DataMart, you can select contacts and load their data into the message to see how it will render with their information.

 

When selecting contacts, you have access to the following options:

  1. Fields required - This section lists the fields used in your message as both Dynamic Variables and in dynamic content logic. This will help you determine which fields are important to your message.
  2. DataMart fields - This section allows you to add/remove different DataMart fields from the contact grid on the right side of the screen. 
    • Each field is filterable and ca be sorted, so if you would like to find a specific group of contacts, you can do that using any field.
  3. Select contacts - At any point, you can select contacts to add to the left on the left panel. These will be the contacts you will carry back to the preview screen. Once back at the preview screen, you will be able to select them and see what the message will look like to them when they receive it.

3.  For a quick preview, you can click on the icon located next to the Message Name on the Email Messages tab under Compose.

 

QuickPreview.png

 

Getting to know Messages

How to Test a Message

Testing your messages is a very important process in quality assurance. We recommend thoroughly testing every message that you set up. Below are the steps necessary to send out test messages.


1.  Click on the "Test" step

 

image-1579103046790.png

 


 

2.  If required, select your Stakeholders

 

image-1579103079509.png

 

 


3.  If required, select your Test Accounts

 

image-1579103100477.png

 

 


4.  If required, select contacts for Dynamic Testing

 

image-1579103109350.png

 


5.  OPTIONAL: Type in a Prefix for the Subject Line to Track Versions

 

image-1579103120815.png

 


6.  OPTIONAL: Select Creative Type to Send

 

image-1579286434884.png

 

 


7.  Click Either "Send" or "Send 250ok Test Deployment"

 

image-1579286441696.png

 

 


8.  OPTIONAL: Viewing the Results of your Tests

 

ViewTestResults.png

 

 

Using your data to provide Dynamic Content

Using your data to provide Dynamic Content

How to Use Fields for Dynamic Content

Dynamic variables are a great way to personalize your message with information you've collected in your DataMart about the user (Name, Address, Recent Purchases, etc.). 

This will help you engage your customers on a much more personal level.


1.  The ## Tag

TheTag.png


2.  Field Names

 

ManageDataFields.png

 

To view the available fields in your DataMart and the Field Name that needs to be referenced in your message, follow these steps:

 

  1. Click on the Target Tab
  2. Click on the Datamart Fields Button
  3. The fields names are located under the Name header.
Using your data to provide Dynamic Content

How to Create a Dynamic Subject Line

This feature offers the possibility to create Dynamic Subject Line based on the data that was collected from your customers or users, You can either use a dynamic variable or add a logic.


1.  Click ## "Insert a Dynamic Variable" button

        Go to Compose > Envelope 

InsertDynamicVariable.png

 

 


2.  Select your Fields

 

InsertDynamicVariable.png

 

In the popup window, different options are available

  1. Select a field : You can choose which DataMart field you would like to pull and display dynamically.
  2. Select a format : This allows you to reformat the data (eg. Switching All caps into lower case)
  3. Default value : If the data field was not provided or collected, we can choose to display a default value eg. "Customer"
  4. Click Insert

3.  Click on Add Logic

 

AddLogicButton.png

 


4.  Add Logic Explained

 

AddLogicExplained.png

 

In the popup window, different options are available

  1. The IF statement is the first condition based on the DataMart fields.
  2. The ELSE/IF statement is the following condition based on the DataMart fields.
  3. The ELSE statement will display the value added in the text box if the above conditions are false
  4. Click Insert

5.  Logic Example

 

AddLogicExample.png

 

Using your data to provide Dynamic Content

How to Provide Targeted Information using Dynamic Content

When building a message or template, you might come across a situation where you want to display an offer or image to the recipient based on their preferences or the demographic information you have collected on them. 

Dynamic Content allows you to create IF/ELSE statements to help dictate which recipients will receive which pieces of content in the message.


1.  Place the cursor where you'd like the dynamic content to appear OR select the content you'd like to replace with Dynamic Content statement.

 

Place the cursor where you'd like the dynamic content to appear OR select the content you'd like to replace with Dynamic Content statement.

 


2.  Click the "Dynamic Content" button in the Editor Bar

 

Click the

 


3.  Name the Dynamic Content section

 

Name the Dynamic Content section

 

 


4.  Define the "IF" statement or copy logic from an existing Dynamic Content piece

 

Define the

 

 


5.  Select the Content Type

 

Select the content type

 

The different content types are:


6.  OPTIONAL: Define additional "ELSE IF" statements

 

OPTIONAL: Define additional

 


7.  If required, define content for the "ELSE" statement

 

If required, define content for the

 

 


8.  Finally, click "Insert" to place the variable in the message or template

 

Finally, click

 


9.  The Dynamic Content variable will appear in the template highlighted green

 

The Dynamic Content variable will appear in the template highlighted green

 

Using your data to provide Dynamic Content

Leveraging Data Extensions in your email content

Personalize your emails even further by inserting the information in your Data extension. This can be used for displaying preferred location information or the customer's assigned customer rep. This can create a more one-to-one experience - the type that converts.

Tutorial

Please note: To try out the feature, click the full screen icon Qx1Screenshot-2023-10-26-141632.png in the tutorial.

 

Using your data to provide Dynamic Content

Dynamic Content Syntax

PREREQUISITE : Dynamic Content

Allows the user to create dynamic content statements without needing to know the syntax. 

A new syntax has been created in the system which allows developers to keep all content and logic within one document.


Syntax


Data Types for Format


Dynamic Content Syntax.

 

HTML
###variablename###
 if (field[FieldName] operator "value" ) { "Content" }
else if (field[FieldName] operator "value" ) { "Content" }
 else { "Content" }
###/variablename###

Logic Breakdown (Part 1)

 

HTML
if (field[FieldName] operator "value" ) 

 


Logic Breakdown (Part 2)

 

Email/Text Operators:

equals, is_not, begins_with, contains, not_contain, is_empty, not_empty 

 

Number/Date Operators:

HTML
==, !=, greater, greater_or_equal, less, less_or_equal, is_empty, not_empty 

 

AND/OR Statements:

HTML
if ((field[ ] ) && (field[ ] )) 

 

HTML
if ((field[ ] ) || (field[ ] ))

 

HTML
if (((field[ ] ) && (field[ ] )) || (field[ ] ))

 

For Each Statements:

Use the for.each statement by itself:

HTML
for.each({"test data"})
for.each({block "<table><tr><td>Some text</td></tr></table>"})
for.each({image: "<img src="http://imagefile.jpg">"})

Or combined with an IF statement:

HTML
if(condition) {block "for.each({"test data"})"}
if(condition) {block "for.each({block "<table><tr><td>Some text</td></tr></table>"})"}
if(condition) {block "for.each({image: "<img src="http://imagefile.jpg">"})"}

 

Content Types

Text: Should only contain text, no HTML.

Example:

HTML
{ "Here is some text" }

Image: Should only contain an image tag.

Example:

HTML
{ image"<img src="http://imagefile.jpg">" }

Block: Can contain anything including code.

Example :

HTML
{ block"<table><tr><td>Some text</td></tr></table>" }

Web and Text Versions

Web versions

 

HTML
if (content[type] == "email" ) or if (content[type] == "webversion")

 

Text Versions

System Variables

These variables provide data from the system for various use cases. They all begin with "system" and are proceeded by the variable name.

Eg. ##system:deploymentid##

Variable Description
deploymentid Provides the ID of the deployment at the time of send and is great for adding context to other tracking code.

 

Tips And Tricks

Tips And Tricks

How to Disable/Enable a Message

The Enabled/Disabled status allows you to place messages that you are no longer using in the background (Disabled) or return them to normal view (Enabled).


1.  Disable/Enable a Message

 

Disable/Enable a Message

 


 

2.  OPTIONAL: Change the Enabled status in the Message Details

 

Tips And Tricks

How to use the Template Editor

The template editor provides an array of tools to help edit your template right in Connect. The template editor also provides all the necessary functions to create an email template from scratch although this requires a bit more expertise on your part. 

 

Editing Text

Editing text with the template editor is easy and provides a lot of the same functionality as any word processor software. Here are the functions you can perform when editing your template copy.

 

1. Paragraph Editing - Change the paragraph style, font or font size

2. Text Decoration - Highlight text and choose bold, italic, underline, or strike-through

3. Alignment - Align the text left, center or right

4. Colour - Change the colour of your font or the background colour

5. Lists - Create a bullet or numbered list

 

The template editor makes link management simple. You can apply a link in seconds by highlighting the text or clicking the image you wish to link, clicking the Insert Link button and pasting in the URL. (UMPIRE will automatically track clicks on your links.)

 

2.URL - Text box where you will paste the URL you wish to link to

3.Target - Choose from the drop-down list where the link will point to. For email, choose "New Window" to ensure the link operates properly within the Webmail client or desktop email client.

4.All Properties - Provides extra functions such as anchor links and email address links.

 

Image Management

The image management system that CONNECT provides, allows the user to not only host their images within the tool, but place them in any template they see fit.
 

  1. Image Insertion - The Insert Image button allows you to insert an image where you have placed the cursor in the template editor or change an image you already have selected.
  2. Image Selection - The pop up that appears when you have decided to insert an image, will display all of the available images you have stored in your Image Library.
  3. Insert Image - Once you have made the selection of which image you would like to insert, you simply click the Insert Image button and the image you selected will appear in your template.
 
Tips And Tricks

How to Upload and Insert an Image

If you are looking to use images in your templates and messages, the image library provides a place to host your images and the Template editor allows you to easily access and insert them.


 

1.  First the image must be uploaded to the system. To do this, click “Upload Imageâ€� in the Image library

 

 


2.  Fill out the Name and Alternative Text and Select the image file you wish to upload.

 

 

 


 

3.  The next step requires you to be in the template or message you wish to place the image within.

 

The next step requires you to be in the template or message you wish to place the image within.

 


4.  Select the Area you wish to Place the Image In

 


5.  Select the Image you wish to Place in the Selected Area

 

 

 

 

Select the image you wish to place in the selected area

 

 

Tips And Tricks

How to Duplicate a Message/Template

Duplicating a message or template is a great way to save time and effort in CONNECT. This tutorial will show you the simple steps in doing this.


1.  Navigate to the Message/Template you would like to Duplicate

 

Navigate to the Message/Template you would like to duplicate

 


2.  Click the “Save Asâ€� button located above the Template Editor

 

 


3.  Provide a new message/template name and click “Save Asâ€�.

 

Provide a new message/template name and click “Save As�.

Tips And Tricks

How to Change Background Colors of a Message or Template

Whether you're looking to add some fresh color to your template or wish to change colors of the default templates to match your brand, this tutorial will help you change both the background color of specific areas of your message or the entire message.


1.  Place your cursor or click anywhere in the area you wish to change. Click on "Cell Properties" which should appear at the bottom of the editor.

 

Place your cursor or click anywhere in the area you wish to change. Click on

 


2.  Click on the Table Properties tab

 

Click on the Table Properties tab

 


3.  Click on the Background Color option and select a color. Click OK when finished.

 

Click on the Background Color option and select a color. Click OK when finished.

 


4.  Changing the Background Color of the Entire Message

Changing the background color of the entire message

 

 

Tips And Tricks

How to Insert an Anchor Tag on IE8

Currently, the insertion of Anchor Tags in email templates using IE8 requires a few extra steps due to comparability issues. 

Provided, are steps to help guide you through this process.


1.  In the message you wish to insert the Anchor Tag, highlight the text at the point at which you would like the Anchor to scroll to

 

 


2.  Click the Insert Link button

 

 


3.  In the popup, ignore all fields and simply click "OK"

 

 


 

4.  Place the cursor within the linked area and click on the "Hyperlink Manager" button in the bottom right corner.

 

 

 


5.  Click the "Anchor" Tab

 

 


6.  Type in a name for the Anchor Point. Click "OK"

 

 


7.  Highlight the text that will be the link triggers the scroll to the Anchor Point

 

 

 


8.  Click the Insert Link button

 

 


9.  In the popup, ignore all fields and simply click "OK"

 

 


10.  Put the text cursor within the linked area and click on the "Hyperlink Manager" button in the bottom right corner

 

 


11.  Select the Anchor Point Name that you created earlier

 

 


 

12.  The URL will change to the Anchor Point name with a # in front of it. Click OK once finished.

 

 


13.  Click Save once all editing has been completed

 

Tips And Tricks

Automatic Web Versions

One of the most common items in an HTML email message is the "Online" or web version. 

This version is generally a copy of your HTML email, hosted online so that if a customer has trouble viewing your email, they can click on the web version link and view the email in their browser instead. 

It is best practice to place this link at the top of your email so it's easy to access. 

CONNECT has a feature that by placing a specific tag as the URL of your web version link, you can trigger CONNECT to automatically create a web version and place a URL back into your email at the time of deployment.

 


1.  The URL tag

 

 


2.  Removing the web version link from the web version

 

 

Templates

Templates

How to build a Drag & Drop template

Personalize your emails even further by inserting the information in your Data extension. This can be used for displaying preferred location information or the customer's assigned customer rep. This can create a more one-to-one experience - the type that converts.

Tutorial

Please note: To try out the feature, click the full screen icon  in the tutorial.

 

Landing Pages and Web Forms

Landing Pages and Web Forms

How to Create an Unsubscribe Page (Update: add customised unsubscribe button text and post confirmation text)

Update: add customised unsubscribe button text and post confirmation text

In the landing page feature, you are able to set up an unsubscribe page to include in your email campaigns and manage your opt-outs. 

This tutorial covers the process of setting up an unsubscribe page in CONNECT.


1.  Begin by creating a new Landing Page

 

Begin by creating a new landing page

 


2.  Enter a Title for the Landing Page

 

Enter a title for the landing page

 


3.  Select the domain you would like the unsubscribe page hosted on

 

Select the domain you would like the unsubscribe page hosted on

 


4.  Select "This landing page is an Unsubscribe page"

 

Select


5.  Paste in the landing page HTML code, click "View HTML"

 

To paste in the landing page HTML code, click


6.  Paste in the HTML code and click "Update"

 

Paste in the HTML code and click

 


7.  Variables

 

Variables

 

The following variables are required in the landing page for the Unsubscribe page to be valid:

 

UPDATE:

    CONNECT also allows users to add custom text to the unsubscribe button and post-unsubscribe text confirmation.

 

 

An additional variable is available and is optional for communities that are not sending to Canadian contacts. 

If a community is sending to Canadian contacts, under CASL, the user must offer the user a way to unsubscribe from all of their email communications.

Landing Pages and Web Forms

How to Create a Web Form

Web Forms are a great way to collect new subscribers for each subscription you have in your DataMart or just collecting customer data for later use. 

This tutorial goes over the standard method for creating a web form.


1.  To begin, navigate to the Compose tab and click on the Web Forms tab

 

To begin, navigate to the Compose tab and click on the Web Forms tab


2.  Click "Create new Web Form"

 

Click


3.  Type in the Web Form Name

 

Type in the web form name

 


4.  The Form will Automatically collect the UniqueID field Assigned to your DataMart

 

The form will automatically collect the UniqueID field assigned to your Datamart

 


5.  Add any additional fields you would like your form to Collect

 

Add any additional fields you would like your form to collect. Also indicate the type of field and if it is required.

 


 

6.  Select the Submit Action you would like the form to use when new contacts Submit their information through your Form.

 

Select the submit action you would like the form to use when new contacts are submit their information through your form.

 

 


7.  Select the Permission level for records added by the form to that subscription

 

Select the permssion level for records added by the form to that subscription

 

 


 

8.  OPTIONAL: Select the landing page you would like the form to redirect to after a user has successfully submitted data

 

OPTIONAL: Select the landing page you would like the form to redirect to after a user has succesfully submitted data

 


 

9.  Type in the text you would like placed in the "Submit" button

 

Type in the text you would like placed in the

 


10.  Click "Save Web Form"

 

Click

 

 


11.  Navigate to "Landing Pages'

 

Navigate to

 


12.  Select the landing page you would like to insert in the Web Form

 

Select the landing page you would like to insert the web form

 


13.  Place the cursor in your landing page where you would like the web form to appear

 

Place the cursor in your landing page where you would like the web form to appear

 


14.  Click the "Insert Web Form" option in the editor

 

Click the

 


15.  Select the name of the web form you set up earlier and click "Insert"

 

Select the name of the web form you set up earlier and click

 


16.  This will insert the web form tag into your landing page

 

This will insert the web form tag into your landing page

 


17.  Click "Save" and then click "Preview" to open the landing page in your browser

 

Click

 


18.  The Result

 

The Result


Using your web form