dotCal - Calendar Publishing for Business, Individuals, and Social Media





dotCal Mail Help

Printer-friendly versionPrinter-friendly versionSend to friendSend to friend

dotCal mail help

Automatic XML Post  

Sending data to our XML API requires that you use a scripting language to post to scripts on our server. Languages like Perl, PHP, ASP, .NET, Java, and C++ all provide for user agents that will send form data in HTTPS POST format to our server. We strongly recommend that you use HTTPS POST (and not GET) so you aren't limited by the size of the XML commands.

Please note that due to the technical nature of the XML API, we do not offer free support for this feature. The cost to troubleshoot and make any corrections to your XML is $100 minimum and $100 per hour after the first hour. We do not troubleshoot the code that generates your XML, but only your XML, and will need the XML you are experiencing difficulties with emailed to us at Dan@neutralspace.com, along with your acknowledgment and acceptance of the support charges.

You can POST data to your account automatically using our XML API from an external script with this:

You will only need to send data by HTTPS POST with these names (these must match exactly and they are case-sensitive):

Important Notes:

The XML datastream has 5 top-level data types:


Working with Editions

The <Edition> is used for uploading edition content to a list and edition in your citylogue mail account. There are 5 types of data that go with each edition - EditionName, EditionSubject, EditionList, EditionHTML, EditionText, and ArchiveEdition. ArchiveEdition can be either 'Add' or 'Remove'.

An example record might look like this:

<Edition>   <EditionName>someEditionName</EditionName>   <EditionSubject>Subject line of your email</EditionSubject>   <EditionList>MailingListName</EditionList>   <EditionHTML><html><body>     This is just a test.     </body>     </html>   </EditionHTML>   <EditionText>Some sample text here</EditionText>   <ArchiveEdition>Add</ArchiveEdition> </Edition>


Working with List Settings

You can define List Settings using a specific set of commands. Each list setting you define must exactly match the database field for the setting. The basic command structure is like this:

<ListSettings List="listname">   <Field>field value</Field> </ListSettings>

Available Field names are (note - these are case-sensitive):


Working with Contacts

For the <Record> datatype, the fields you pass up must correlate exactly with the Master List fields. For more information, look at the Knowledge Base entry for "Master List Import XML".

The uploaded file must be a text/plain format, and it must look something like this:

<Record>   <Email>person@somesite.com</Email>   <Firstname>Mary</Firstname>   <Lastname>Jones</Lastname>   <MailingLists>List1,List2,List3</MailingLists> </Record>

You can upload as many records as you like, and each record can have any or all of the field names you see in the Detailed View of each contact in the Master List (e.g., "Email", "Firstname","Company","User1","Notes", etc).

Managing a Contact's Subscribed Lists

You can manage the Mailing Lists a contact is subscribed to by using one of the following 3 XML Tags, which are described in more detail below.

  <MailingLists>  -- Define the entire set of Mailing Lists.   <AddLists>      -- Add to a contact's set of subscribed Mailing Lists.   <DropLists>     -- Remove from a contact's set of subscribed Mailing Lists.  Note: You can only specify one of the above tags per record.

Adding Contact to Lists

When you upload a <MailingLists> field for a contact, it will re-define the lists that contact is assigned to. You may want to just be able to add a contact to a list if that contact is not already on the list. Use the <AddLists> command like this:

  <AddLists>List1,List2</AddLists>

This will add the contact to List1 and List2 if the contact is not already on those lists.

Dropping Contact From Lists

To remove someone from a Mailing List, all you have to do is include this XML in the Record data:

  <DropLists>List3</DropLists>

Setting a Contact's Lists

Instead of adding to, or removing from a contact's subscribed lists you can specify the list in its entirety. To set all the lists a contact is subscribed to, all you have to do is include this XML in the Record data:

  <MailingLists>List1,List2,List3</MailingLists>

This will set the contact to List1, List2 and List3 regardless of which lists the contact was previously set to.

Removing a Contact Completely

You can remove a record from the MasterCRM completely with the ClearRecord command. Note that you can't remove Unsubscribed contacts from the CRM with this (this is to protect you from accidentally sending to this contact). It would look like this:

<Record>   <Email>someone@something.com</Email>   <ClearRecord>1</ClearRecord> </Record>

Changing a Contact's Email Address

Because citylogue mail uses the email address as the primary key for each contact, you must use a separate command inside the <Record> tags to change a contact. The XML command is ChangeEmail, and it would look something like this:

<Email>someone@something.com</Email>   <ChangeEmail>someone@another.com</ChangeEmail> </Record>

Event Triggers

To have an email sent immediately to the person you are posting, add this tag:

  <Trigger>List_Edition</Trigger>

You can even add delayed event triggers like this:

  <Event1date>04/15/2002</Event1date>   <Event1listedition>somelist_youredition</Event1listedition>

Note: format the the Event#date field is either MM/DD/YYYY or is an integer that represents the delay in the number of days for the triggered email (autoresponder). You can also make the event trigger look like this (this example is a 3-day delayed autoresponder):

  <Event1date>3</Event1date>   <Event1listedition>somelist_anotheredition</Event1listedition>

You can also remove events for a contact if you set the event's date field to be "Remove" like this:

  <Event1date>Remove</Event1date>   <Event1listedition>somelist_anotheredition</Event1listedition>

By default citylogue mail will not send an autoresponder email to the same person twice. We automatically run a de-duplication to verify the contact only receives one particular edition. You can override this with this XML tag:

  <Event1force>Yes</Event1force>

Activities - Option 1 (preferred)

You can use XML to add activities to the Master CRM. This is done very simply, like this:

  <Activity id="1">200308131530|Meeting|test description more information here and more information about the activity here. |test status   </Activity>

Each activity element (Date|Activity|Description|Status) is uploaded in a pipe-delimited list, with each separate activity delimited by a newline. Date is in the format YYYYMMDDhhmm, Activity must be one of the Activities you have defined in your Master CRM, and Description and Status can be any text field you would like (limit of 1k per field).

Activities - Option 2

The other way to add activities requires that you have NO newlines (carriage returns) in your activities. This is done like this (note the plural "Activities" is used in Option 2):

  <Activities>200308131530|Meeting|test description|test status 200308140800|Meeting|another description|another status</Activities>


Link Library

Adding a link to the Link Library is very simple - just put the link between LinkLibrary tags like this:

  <LinkLibrary>http://www.somesite.com/somepage.html</LinkLibrary>

If the link does not already exist in the Link Library, it will be added.


Create A New Mailing List

Use the <NewList> command to create a new mailing list. Each list created must have an edition in it. The XML command looks like this:

  <NewList FirstEdition="editionName">MailingListName</NewList>


Redefine a Mailing List

You can use the <DefineMailingList> function to redefine the contacts in a specific mailing list. Anyone not in the list of email addresses provided will be dropped, and anyone in the uploaded list that isn't in the mailing list will be added. This function is called like this:

  <DefineMailingList list="listname">   <Email>something@somesite.com</Email>   <Email>another@anotherone.com</Email>   </DefineMailingList>


Sending Messages

To use XML to send messages with citylogue mail, you can use the XML <Send> command to send either test messages or broadcasts. The generic format of the XML <Send> is as follows:

  <Send List="listname" Edition="editionname">RECIPIENT COMMAND</Send>

RECIPIENT COMMAND specifies who you want to send the edition to. Commands fall into two categories - specific recipients and broadcasts.

If you would like to send to a specific list of email addresses, put those email addresses (comma delimited) between the <Send></Send> like this:

  <Send List="listname" Edition="editionname">person@something.com,another@somesite.com</Send>

If you would like to broadcast to the mailing list, you have 3 options:

An example of this would be:

  <Send List="listname" Edition="editionname">Broadcast 200</Send>

The above example would send the edition "editionname" from the list "listname" to 200 random people who have not yet received it.

An important note: By using this XML API to send emails, you have incredible power to send emails to a lot of people. Be absolutely sure you have tested your interface thoroughly before you create a production environment on your side. If in doubt, please contact our technical support department. To be able to use this function, your account must be in good standing.

Another Note - we run our broadcast queues every 20 minutes, so allow for some delay from when you send up the broadcast to actual delivery of your messages.


Server Response

The server will provide you with XML information about your upload. The response fields below are defined:

As an example,a successful upload of a contact record would look something like this:

  <Compiled>Yes</Compiled>   <DBConnect>OK</DBConnect>   <EditionSuccess>MailingListName_someEditionName</EditionSuccess>   <ImportRecords>1</ImportRecords>   <ExistingRecords>1526</ExistingRecords>   <FinalCompleted>1</FinalCompleted>   <Duplicates>1</Duplicates>   <InvalidLists>0</InvalidLists>   <Triggers></Triggers>   <XMLUpload>Complete</XMLUpload>

Note that some optional fields will be added if you uploaded autoresponders or activities:

  <ActivitiesUploaded>2</ActivitiesUploaded>   <ActivitiesAdded>2</ActivitiesAdded>   <Autoresponders>3</Autoresponders>

The response for uploading links to the Link Library is just the number of successfully added links:

  <LinksAdded>5</LinksAdded>

If you are use the <NewList> function to create a new mailing list, the response from the server will confirm new lists that have been created. This will be in this XML format:

  <NewListsCreated>List1,List2</NewListsCreated>

If you are using the <DefineMailingLists> function, you will get these responses back:

  <DefinedMailingList list="listname">   <DefinedMailingListUploaded>#</DefinedMailingListUploaded>   <DefinedMailingListExisting>#</DefinedMailingListExisting>   <DefinedMailingListAdded>#</DefinedMailingListAdded>   <DefinedMailingListRemoved>#</DefinedMailingListRemoved>   </DefinedMailingList>

If you defined list settings with the <ListSettings> command, you will get a response for each list you updated that looks like this:

  <ListSettingsUpdated List="listname">field1,field2,field3</ListSettingsUpdated>

Where field1, field2, etc are the fields you updated.

If you have used the <Send> command to send emails or broadcasts, you will get a response like this:

  <Send List="testlist" Edition="editionname" Recipients="1">Successful</Send>

If there's an error in the send, the response from the server will be like this:

  <SendError>HTTP Response From Server</SendError>


Portal Managers

The PortalCommand function allows the Portal Manager to update individual accounts by XML. Currently it is limited to setting the Emails included in the account's plan, and the anniversary (expiry YYYYMM) of the account.

  <PortalCommand>   <Username Exports="#" Anniversary="YYYYMM" Active="ActiveSetting"    Branding="BrandingSetting" Monthly_Payment="#">username</Username>   </PortalCommand>

You have the following options for setting the Active value:

You have the following options when setting Branding:

Each account that is updated will count for the final confirmation of updated accounts, sent back in the HTTP response from our server

  <PortalUserUpdates>#</PortalUserUpdates>


Special HTML Characters  

You can add special HTML characters to your emails using standard HTML codes. For this, use the following reference:
‘ => &lsquo; => left single quote
’ => &rsquo; => right single quote
‚ => &sbquo; => single low-9 quote
“ => &ldquo; => left double quote
” => &rdquo; => right double quote
„ => &bdquo; => double low-9 quote
† => &dagger; => dagger
‡ => &Dagger; => double dagger
‰ => &permil; => per mill sign
‹ => &lsaquo; => single left-pointing angle quote
› => &rsaquo; => single right-pointing angle quote
=> &spades; => black spade suit
=> &clubs; => black club suit
=> &hearts; => black heart suit
=> &diams; => black diamond suit
=> &oline; => overline, = spacing overscore
=> &larr; => leftward arrow
=> &uarr; => upward arrow
=> &rarr; => rightward arrow
=> &darr; => downward arrow
™ => &trade; => trademark sign
" => &quot; => double quotation mark
& => &amp; => ampersand
< => &lt; => less-than sign
> => &gt; => greater-than sign
  => &nbsp; => nonbreaking space
¡ => &iexcl; => inverted exclamation
¿ => &iquest; => inverted question mark
¢ => &cent; => cent sign
£ => &pound; => pound sterling
¤ => &curren; => general currency sign
¥ => &yen; => yen sign
¦ => &brvbar; => or &; => &brkbar; => broken vertical bar
§ => &sect; => section sign
¨ => &uml; => or &; => &die; => umlaut
© => &copy; => copyright
ª => &ordf; => feminine ordinal
« => &laquo; => left angle quote
» => &raquo; => right angle quote
¬ => &not; => not sign
­ => &shy; => soft hyphen
® => &reg; => registered trademark
¯ => &macr; => or &; => &hibar; => macron accent
° => &deg; => degree sign
± => &plusmn; => plus or minus
¹ => &sup1; => superscript one
² => &sup2; => superscript two
³ => &sup3; => superscript three
´ => &acute; => acute accent
µ => &micro; => micro sign
¶ => &para; => paragraph sign
· => &middot; => middle dot
¸ => &cedil; => cedilla
º => &ordm; => masculine ordinal
¼ => &frac14; => one-fourth
½ => &frac12; => one-half
¾ => &frac34; => three-fourths
× => &times; => multiplication sign
÷ => &divide; => division sign
À => &Agrave; => uppercase A, grave accent
Á => &Aacute; => uppercase A, acute accent
 => &Acirc; => uppercase A, circumflex accent
à => &Atilde; => uppercase A, tilde
Ä => &Auml; => uppercase A, umlaut
Å => &Aring; => uppercase A, ring
Æ => &AElig; => uppercase AE
Ç => &Ccedil; => uppercase C, cedilla
È => &Egrave; => uppercase E, grave accent
É => &Eacute; => uppercase E, acute accent
Ê => &Ecirc; => uppercase E, circumflex accent
Ë => &Euml; => uppercase E, umlaut
Ì => &Igrave; => uppercase I, grave accent
Í => &Iacute; => uppercase I, acute accent
Î => &Icirc; => uppercase I, circumflex accent
Ï => &Iuml; => uppercase I, umlaut
Ð => &ETH; => uppercase Eth, Icelandic
Ñ => &Ntilde; => uppercase N, tilde
Ò => &Ograve; => uppercase O, grave accent
Ó => &Oacute; => uppercase O, acute accent
Ô => &Ocirc; => uppercase O, circumflex accent
Õ => &Otilde; => uppercase O, tilde
Ö => &Ouml; => uppercase O, umlaut
Ø => &Oslash; => uppercase O, slash
Ù => &Ugrave; => uppercase U, grave accent
Ú => &Uacute; => uppercase U, acute accent
Û => &Ucirc; => uppercase U, circumflex accent
Ü => &Uuml; => uppercase U, umlaut
Ý => &Yacute; => uppercase Y, acute accent
Þ => &THORN; => uppercase THORN, Icelandic
ß => &szlig; => lowercase sharps, German
à => &agrave; => lowercase a, grave accent
á => &aacute; => lowercase a, acute accent
â => &acirc; => lowercase a, circumflex accent
ã => &atilde; => lowercase a, tilde
ä => &auml; => lowercase a, umlaut
å => &aring; => lowercase a, ring
æ => &aelig; => lowercase ae
ç => &ccedil; => lowercase c, cedilla
è => &egrave; => lowercase e, grave accent
é => &eacute; => lowercase e, acute accent
ê => &ecirc; => lowercase e, circumflex accent
ë => &euml; => lowercase e, umlaut
ì => &igrave; => lowercase i, grave accent
í => &iacute; => lowercase i, acute accent
î => &icirc; => lowercase i, circumflex accent
ï => &iuml; => lowercase i, umlaut
ð => &eth; => lowercase eth, Icelandic
ñ => &ntilde; => lowercase n, tilde
ò => &ograve; => lowercase o, grave accent
ó => &oacute; => lowercase o, acute accent
ô => &ocirc; => lowercase o, circumflex accent
õ => &otilde; => lowercase o, tilde
ö => &ouml; => lowercase o, umlaut
ø => &oslash; => lowercase o, slash
ù => &ugrave; => lowercase u, grave accent
ú => &uacute; => lowercase u, acute accent
û => &ucirc; => lowercase u, circumflex accent
ü => &uuml; => lowercase u, umlaut
ý => &yacute; => lowercase y, acute accent
þ => &thorn; => lowercase thorn, Icelandic
ÿ => &yuml; => lowercase y, umlaut



Account Configuration
The checkboxes at the top of this area are available to all users with account that have the right to access them:

  • The CRM functions are focused on providing you with more information about your relationship with your contacts
  • Dynamic Data is an advanced mail merge feature. It allows you to set up rules that build the content for your message on the fly. Once this is activated, you will s ee a new section at the bottom of your Edition Editor screen.
  • Compress Control Panel will convert your unarchived editions to a dropdown select field in the Control Panel. This is useful if you maintain many editions without ar chviving.
  • Activate Search in Control Panel allows you to search your editions for keywords and only display those matches in your Control Panel.
  • Auto Fill CRM with Subscriber Location works with the website signup form, automatically filling in the new subscriber's City, State, and Country fields in the CRM if this box is checked. This information is determined by the IP address of the new subscriber, correlated using a database that relates IP addresses to geographical location.
  • Track Text Message Links by Default changes the links in the text only messages you send to trackable links. Note that this will change the appearance of the links, but wil l allow them to be tracked.
  • Allow Introductory Message for Broadcasts will open a new field in the Send screen for you to add your own introductory message at the top of broadcasts being sent. This is similar to the text at the top of single-shot test messages that you can specify.
  • Create RSS XML File when Sending to Specified Lists will create a new checkbox in your mailing lists' List Settings to create and append edition information to an RSS XML file.
  • Allow Sharing of Specified Document Library Files turns on new functions in your Document Library that allow the files you choose to be shared. Once this box is checked, each file in your Document Library will have a small text box next to it where you can specify a comma-delimited list of usernames that will be able to see that file.
  • Allow SMS Lists will allow you to turn on the SMS List function (a checkbox on the New List screen)
  • The Default Rows numbers specify how many contacts you see on each page as you view them.
  • Bounces to Hard Bounce is a setting that lets you determine how many times a recipient sends back an "undeliverable" message before it is permanently flagged as "Bounced" in your Master CRM. The default for this is 3, meaning that if you have failed to send to a recipient 3 times, we won't continue to try to deliver to that recipient. The complete report of which recipients have bounced for which reason is available in your Master CRM - Reports - Bounce Report section.
  • Minimum Score to Make a Hot Prospect is a scoring system to filter out your most interested recipients. More information about hot prospects is available in the knowledge base or on the Track page for an edition.


The optional fields give you a way to further customize your system.

  • Company Banner URL is a URL to a banner that we will use to place at the top of the dotCal mail interface while you're working.
  • Do Not Email Domains are domains that you will prevent yourself from sending to. This is helpful if you wish to ensure that a competitor never receives any of your emails. To enter domains in, simply comma-separate the domains you want to prevent sending to. Example: abc.com,junk.com,competitor.com
  • Post Profile Update via XML to URL allows you to post information to your database if a recipient updates his or her profile with the Profile Update link we provide you (this is handy for keeping databases in synch). Data will be sent in this format:

    <Record Username="your dotCal mail username" Email="recipient's email">
    <CRM Field>New Field Value</CRM Field>
    </Record>

    The CRM field in the example above corresponds to any field in your Master CRM (Firstname, Lastname, Company, User1, etc).
  • More optional fields include the Privacy/Anti-Spam Policy URL and the Subscription Form Domain. Your privacy/anti-spam policy is available to recipients of your emails that click the unsubscribe/profile update link. Making this available is helpful to recipients that are concerned about the privacy of their email addresses and that you are not sending them email unsolicited.
  • Subscription Form Domain is an easy way to protect yourself from someone hijacking your subscription form and uploading bogus email addresses. While to this date, this has never happened to any dotCal mail client, it is a good way to protect your subscriber data from unwanted bogus new subscribers. Add your domain (e.g., "yoursite.com") to this field and it will prevent someone from signing up for your website from a form on a different website.


Update Account
 

This page, under the My Account tab, allows you to update information about you and how you would like to customize your dotCal mail interface.

The left column is information we use so that we can stay in touch with you, and provide you with updates to our software.

The right side of this page represents the options you control to manage your dotCal mail account.



Account Usage
This is where you can monitor your current account and the total number of emails you have sent. To change your subscription, contact our sales department.



About You
To better serve you, we would like to know a little bit about you. This will aid us in developing features to better match your industry and your needs.



General Email Marketing Tips  

20 General Email Marketing Tips:

Take a few minutes to read these tips -- they may save you time and improve your campaign's effectiveness.

1. Make sure you have permission from your recipients to send them email. This crucial first step is key to having them recognize who you are, and read your message to them.

2. Keep your email lists and your contacts' data private. Do not resell your lists or share them with other companies. Your contacts will be very unhappy with you if they find out you're sharing data about them that they trust you with.

3. Actively build your email lists. Capture email addresses from your website (we have a form that will do that for you). Whenever you talk to a client, or a prospect, get his or her email address (after you ask them if it's ok to send them email). Examples of opportunities to contact your clients and prospects are networking meetings, in-person/by-mail/by-email inquiry forms, change- or upgrade-of-service requests, business reply cards, or return of payment forms.

4. Ask yourself who you are trying to reach and why your recipients will respond to your email. Make sure you know how your email campaigns will tie in with the rest of your marketing/communication efforts. Be aware of how often you are contacting your clients and prospects -- too much is annoying, too little and they'll forget who you are.

5. Direct your audience somewhere. Make sure your recipients know why they are receiving this information. If you want them to do something (like visit a website), make sure you make it clear how to do that.

6. Personalize your email. Use our mail merge/placeholder system to embed information about each contact into a personalized email.

7. Make your website match your email. Be consistent in your company's overall branding. If you are directing your recipients to your website, make sure they are going to a page that is relevant to the email you are sending out.

8. Review your links. Make sure they are all valid. Make sure the "From" email address works, along with any mailto: links in the body of the email.

9. Use your stats. dotCal mail provides detailed tracking data on your clients. Create new lists based behavior, especially click-thru behavior. Send targeted follow-up emails to people that click on specific links.

10. Carefully choose your subject line. Your subject line should make it clear to the recipient why they should open your email. Avoid using spam-ish terms (on the Preview page, we help you with this). A subject line should be short, never more than 30 characters, and cannot contain any HTML coding.

11. Don't oversell yourself. Everyone gets tons of spam every day. People no longer respond to "great deals" and "free opportunities". Stay away from using terms that make your email sound too good to be true -- everyone has read enough spam to be wise to those gimmicks.

12. Be concise. Don't write really long articles. People don't like to read, and unless you are an outstanding writer with an enthusiastic audience, they really don't like to read long emails. Better to create links to more information. Make sure you put lots of pictures in your text if you're going to write a lot of it. Put the most important information first.

13. Send yourself a test message before you broadcast. Make sure it looks good in your Inbox. Get a web-mail account and a POP email account that you can test with Outlook (the most common email program) FIRST before you send your message out to the masses.

14. Pay attention to your Text Only Message. A good 20-30% of users out there only receive text emails. Be sure that those users have something worth reading. Read the Text part of the preview screen.

15. Consider investing in a rich media piece. Flash and streaming video will be received by almost anyone that can receive HTML email.

16. Send when your audience will be most receptive. The best days to send email are Tuesday, Wednesday, and Thursday. If you are targeting corporate recipients, you will get the best response on a weekday afternoon.

17. Pay attention to the "From" line (the Contact Name in the Template Manager). Your recipients should recognize who you are, and it should be your name or your company's name.

18. Double check before you send. Make sure you have chosen the right edition and the right delivery time before you click the Send Now button.

19. Test your broadcast on small groups. If you have an important message to be sent to a large group, you can test its effectiveness by sending to small subsets of your list. Use the "Send to x Random Recipients" feature if you have the time to spend on ensuring your message is as good as it can be.

20. Keep a positive attitude. Email marketing is your most cost-effective means of communication. Learn from your recipients what works, what they like, and what they don't like. The more communication you have with your clients, the stronger your relationship with them (just be careful not to overwhelm them).

We hope you found these tips helpful. If you have more tips, or have feedback for us, please let us know at mailto:


How the Tracking Page Works
Each email campaign you send includes 3 detailed tracking graphs. These graphs report general campaign statistics regarding the recipient list, reads, and click-throughs. Detailed statistics can be viewed by clicking the links just below each bar chart.

Graph1 - General Campaign Statistics
Sent
: Messages successfully delivered* et help on this topic
Read: Recipients who opened your message
Clicks: Recipients who clicked on a link inside your message (any link).
Send 2 Friends: Recipients who sent your message to a friend
Hot Prospects: Calculated to be the most interested people in your list
Unsubscribed: Recipients who "removed" themselves from the list.
Bounces: Bad addresses or errors
et help on this topic

Graph2 - Read Frequency
Recipients who opened their email 1 or more times. Click for details. Total reads are the total number of times this edition was opened by all recipients. Relative read rate is the ratio of total reads to emails sent.

Graph3 - Click Frequency
Recipients who clicked on a link in your message (any link) 1 or more times. Total clicks are the total number of times any link was clicked in this edition by all recipients. Relative click rate is the ratio of total clicks to total reads.

See the table below the bar graphs for statistics displayed by URL.

*Note: because we deliver messages so fast, there is usually a short delay (a few minutes) between when the message was sent and when your data tables mark recipients as "Sent".

 


To simplify the management of large dynamic rule sets, on the Add or Modify Dynamic Data management page, you may choose to import your rules through a pipe delimited, flat file database.

The file format is:

Rule Number|Field|Operator|Test|Result

The order of case comparison is dictated by the order of the file. An example file might look like:

1|Email|=|myemailaddress@domain.com|This is me! 1|Email|=|youremailaddress@domain.com|This is you! 2|Email|=|myemailaddress@domain.com|myimage.gif 2|Email|=|youremailaddress@domain.com|yourimage.gif

This file would be turned into a ruleset that acts like:

If Email is equal to "myemailaddress@domain.com," then replace Dynamic001_Placeholder with, "This is me!" Otherwise, if Email is equal to "youremailaddress@domain.com," then replace Dynamic001_Placeholder with, "This is you!"

If Email is equal to "myemailaddress@domain.com," then replace Dynamic002_Placeholder with, "myimage.gif." Otherwise, if Email is equal to "youremailaddress@domain.com," then replace Dynamic001_Placeholder with, "yourimage.gif."

The file content must be valid and certain fields have data restrictions. The Rule Number column must contain integers only, and must be 1-999. Please see below for valid Field and Operator values. Test and Result data may be anything you like, however they may not contain the pipe character, as that will break the parsing engine.



Valid Fields:

"Email", "Prefix", "Firstname", "Lastname", "Position", "Company", "Address", "Address2", "City", "State", "Zip", "Country", "Phone", "Mobile", "Fax", "Website", "EmailFormat", "Occupation", "Age", "Birthday", "Income", "Gender", "ContactOwner", "ContactType", "InitialContact", "Notes", "MailingLists", "User1", "User2", "User3", "User4", "User5", "User6", "User7", "User8", "User9", "Lastmod", "User10", "User11", "User12", "User13", "User14", "User15", "User16", "User17", "User18", "User19", "User20", "User21", "User22", "User23", "User24", "User25", "User26", "User27", "User28", "User29", "User30", "User31", "User32", "User33", "User34", "User35", "User36", "User37", "User38", "User39", "User40", "User41", "User42", "User43", "User44", "User45", "User46", "User47", "User48", "User49", "User50"

Valid Operators:

"=" (Equal To), "!" (Not Equal To), "<" (Less Than), ">" (Greater Than), "~" (Contains), "-" (Does Not Contain), "+" (Is Contained Within)

Options:

  • Do Not Overwrite Existing Rules -- This will append the new import to your existing ruleset.
  • File Contains Fields Across Multiple Lines -- If the file you're uploading has fields which contain multiple lines of text, you must select this option. You will additionally have to modify your import file in three ways:
    1. The first line of the file must contain the header:
      "Rule Number|Field|Operator|Test|Result".
    2. Each new record must be preceeded with the characters, "~~".
    3. The final line must contain only the characters, "~~".


Multiline File Example:

Rule Number|Field|Operator|Test|Result ~~1|Email|=|myemailaddress@domain.com|This is me! and I have multiple lines  in this field! ~~1|Email|=|youremailaddress@domain.com|This is you! ~~

 

 


Browse our collection of royalty free clipart. You can use these images in your emails as you see fit without any worries regarding licensing fees.

Animals:

International Flags:

Food:

Objects:

People:

Places:

Plants and Flowers:

Scenic Beauty:



Master List Import Textfile  

Importing a tab-delimited textfile into the dotCal mail Master CRM is designed to be a flexible, straightforward process. The file you want to upload with your contacts must be:

1) on your hard drive, and
2) saved as a tab-delimited textfile.

You may import as much or as little data as you would like. The only columns (also sometimes referred to as "fields") which are REQUIRED on an imported file are:

  • Email (Required in first column), and
  • MailingLists (Required in the last column).

In all cases, the header row defining the fields you are choosing to import should match the fields as they appear in your Master Contact List (case-sensitive).

If you would like to import a contact's email address to more than one Mailing List, you can do so by including multiple Mailing Lists in the last column, separated by a comma (e.g., "FirstList,SecondList,ThirdList"). Make sure the MailingList(s) in the last column of your file exactly matches the Mailing List(s) you created in dotCal mail. Here is an example of what an imported file might look like

 

Email

Firstname

Lastname

Company

Address

City

State

Zip

Notes

MailingLists

you@yourcompany.com

John

Doe

ACME, Inc.

1060 Addison Rd.

Chicago

IL

48417

Notes about this contact

List1,List2

jane@somesite.com

Jane

Doe

Somesite Services Corp.

900 Elm Street

Portland

OR

97217

Some more notes about this person

List2

joe@another.com

Joe

Doe

Another Dot Com

512 Beach Lane

San Diego

CA

92024

Notes about Joe would be here

List1

To import your data from a spreadsheet (e.g., Excel), please make sure every column header on your spreadsheet matches exactly to a Master List header. Allowable headers are:

  • Email (Required in first column)
  • Prefix
  • Name*
  • Firstname
  • Lastname
  • Position
  • Company
  • Address
  • Address2
  • City
  • State
  • Zip
  • Phone
  • Mobile
  • Fax
  • Website
  • Country
  • EmailFormat (Note: this is one word)
  • Occupation
  • Age
  • Birthday
  • Income
  • Gender
  • ContactOwner
  • ContactType
  • InitialContact
  • User1
  • User2
  • User3 ... etc... through User50
  • Notes
  • MailingLists (Required in last column)


Note: although "Name" is not a defined field in the Master List, you can use it (instead of Firstname and Lastname). If your spreadsheet has both first names and last names in the same column, use the "Name" column heading.

Another note: if you are uploading data into a User field defined as a "Checkbox" type, you can upload multiple values by separating each value with the pipe | character, like this: value1|value2|value3 flexible, straightforward process. The file you want to upload with your contacts must be: 1)



Creating Surveys  

Creating surveys in dotCal mail is a simple form-based process. Under the Libraries - Survey Library tab, you will see a record of all of your surveys and can create new questions.



Getting Started
In the Survey Library screen, you will be able to see every survey question you would like to ask. In each email you send out will be one (and only one) question which will link to each follow-on question. Each question in your Survey Library is treated as a separate object and questions can be tied to as many editions as you like. The Contacts screen will track individuals' responses to surveys; the Survey Library screen will track the total up-to-date number of responses for each question (not tied to individuals). You can reset the number of responses to each question on the Survey Library screen - this does not affect individual answers because those answers are associated with the inidividual contacts in each mailing list.

The Survey Code is a short unique identifier that you can use to remember the question. In your survey reports, and when working with Follow-On Questions, you will need that Survey Code. It's a good idea when building lots of survey questions to have Survey Codes that are similar to each other (e.g., "Survey1Question1" and "Survey1Question2"), since they are displayed on the Survey Library page ordered by Survey Code.

Next Questions allow you to have your recipients answer more than one question. You will create your first question, and in the form field where it asks for the "Next Question Survey Code", you will provide the Survey Code for the following question. You can create branching surveys, which will display a different Next Question based on the response given. This is helpful if you need to ask a specific follow up question based on the response (e.g., if you ask "Did you buy Product X?" you can have a different question based on whether the survey respondant answered "Yes" or "No")

When you are ready to put your survey in a dotCal mail, select the FIRST question and click on the "Generate Survey HTML" button. Note that if you only have one question, click on the "Generate Survey HTML" button for that question.

After you have generated your Survey HTML, paste it into the content of the edition would like to send to your recipients. You will see that the HTML generated has both an HTML form and a link. You do not need the form, and may use just the link to have your recipients take your survey.

Displaying Multiple Questions per Page
It is also possible to display more than one question per page. To trigger this functionality, use the 'Question display page' select box at the top of each question. This sets the page number the question is to be included in. You are allowed from 1 to 10 pages, with no limit to the number of questions per page. When taking this type of survey, the end user will first see all questions assigned to page 1, followed by all questions assigned to page 2 etc... until there are no questions assigned to the subsequent page. All questions per page must be answered before the end user is able to proceed.

There are a few key differences to keep in mind when creating grouped surveys of this type:
1, The questions presented to the end user are determined exclusively by the page to which they are assigned. Any per question or per answer settings are ignored as they are not compatible.
2, Grouped surveys of this type can only be included in your dotCal mail via a html link. That is, the option of including the first question in your dotCal mail as a form is not compatible.



 

Dynamic Data  

Dynamic Data starts when you go to your "Update Account" screen and check the box to activate Dynamic Data (by default this is OFF for users for simplicity).

After you activate "Dynamic Data", when you go to the Edition Editor, you will see a new area where you can "Add and Modify" dynamic data for your edition. If you click on this link, you will be taken to a new page where you can define your Dynamic Data Rules.

The Dynamic Data function is like a more powerful and flexible version of the built-in mail merge (a.k.a. the _Placeholder function). Here's an example:

Say you want to include a special message in your email to everyone who is having a birthday this month. You would go to the Dynamic Data Rules screen for the edition you want to send out and add Rule 001 to be:
If Birthday CONTAINS Nov REPLACE Dynamic001_Placeholder WITH "Happy November Birthday To You!"
If BIRTHDAY = blank REPLACE Dynamic001_Placeholder WITH "We don't have your birthday on file - please update your profile and give it to us"
ELSE REPLACE Dynamic001_Placeholder WITH "Your birthday is Birthday_Placeholder"

Then you would put Dynamic001_Placeholder (this is automatically added to the "Include" popup in the Edition Editor) in the message somewhere and dotCal mail will automatically make the mail merge based on the rules you define.

You can have up to 999 rules per edition, and up to 999 comparisons per rule (the above example is 1 rule with 3 comparisons). Maximum data content per Placeholder is 64K.

Term Definitions:

·  Rule #: The number which corresponds to the placeholder value.

·  Field: The user field to make the comparison against.

·  Operator: What type of comparison should be used.

·  Test Value: The value to compare against the data stored in "Field."

·  Replace with Result: The value with which to replace the placeholder.

 


 

Marketing with SMS - A How To Guide  

dotCal mail integrates your SMS (short message service for mobile phones) and email marketing into one system. Currently in its development phase, you can build SMS lists with the help of double-opt-in website subscription forms.

The first step to setting up your account to manage SMS is to allow the creation of SMS Lists. This is done in the My Account - Update Account screen. Check the box to allow a new SMS List to be created.

Next, you create your SMS List. Go to the Control Panel and click the New List button. At the bottom of the left column, you will see a new checkbox that will allow you identify the list as an SMS list. When you create the list, it will be identified in your Control Panel as an SMS list.

Third, you will need to create a website signup form that allows new subscribers to opt-in to your SMS List. To be added to an SMS List via websign signup form, you need to add an additional checkbox that confirms that the recipient gives permission to be contact via SMS. This will add a special phrase to the Notes field of the contact that is used to confirm that the recipient has indeed opted in to receive SMS.

The special phrase - "SMS permission given with subscription" - identifies a recipient as being ok to be sent an SMS. If you would like to add someone to an SMS List without having them use the website signup form described above, you must add this phrase first to the contact's Notes field in the Master CRM. Due to the sensitivity of users receiving unsolicited SMS, it is absolutely critical that you be very careful when adding people to an SMS List this way. Spam complaints from SMS messages carry a $100 fine per complaint if no double-opt-in record is provided.

Building an SMS message is easy - it's just like using the Text Only Message layout in your Edition Editor. Simply type your message, up to 110 characters, and click the Save Changes button. The preview function works the same way.

Once you are ready to send your SMS message, you may do so with the usual Send screen. You will notice the page is slightly different, but the same functions are available.

After your message has been sent, you will receive two confirmation emails. The first confirmation is sent to you when all of the SMS messages have been delivered to the SMS servers. The second confirmation is sent after the SMS servers have delivered all of the messages. Because the SMS servers are at a different location and run on separate schedules, there may be several minutes delay before your SMS message is delivered.

There is no tracking information available on SMS messages, due to limitations of how SMS works.

Pricing for your SMS messages is just like your emails. Each SMS message counts as one email sent.



 One to One Personalization and Placeholders  

You can use fields from your Master List in a dotCal mail edition by inserting Placeholders into the text of the email.

This mail merge capability allows you to place each contact's data directly in the content of the email like this:
Fieldname_Placeholder where Fieldname is the name of a field in the Master List.

When you use placeholders like this, you can insert them anywhere in your email. If you are using one of our templates, look for this button:
http://emailer.dotcal.com/images/text_include.gif


An example would look like this:
Hi Firstname_Placeholder Lastname_Placeholder, it was great meeting you at User1_Placeholder

Available fields for placeholder replacement:

  • Name
  • Email
  • Firstname
  • Lastname
  • Company
  • Address
  • Address2
  • City
  • State
  • Zip
  • Country
  • Phone
  • Mobile
  • Fax
  • Website
  • EmailFormat
  • Occupation
  • Age
  • Birthday
  • Income
  • Gender
  • ContactType
  • InitialContact
  • ListAddress1
  • ListAddress2
  • User1 .. User50


List Placeholders

Certain elements of the mailing list itself are made available to you in the form of placeholders. These are:

  • MailingList
  • Edition
  • ListEmail
  • ListAdminEmail
  • ListAddress1
  • ListAddress2
  • ListCompany


Dynamic Placeholders

You can also merge in Dynamic Placeholders, which rely on rules to search and replace. This function must be turned on in the My Account - Update Account screen. Once activated, you will be able to add dynamic data rules in your Edition Editor.



Import Email List From ACT  

Use this method if you are NOT using the dotCal mail/ACT! Plug-In. For more information about the dotCal mail/ACT! Plug-In program, visit our Help page.

(Courtesy of Interact Corporation)

1. Choose File, point to Data Exchange, and then choose Export. The first panel of the Export Wizard appears, asking you the type of file that you want to export and the name and location of the file to which you want to export it.

2. From the File Type drop-down list, choose Text-Delimited.

3. Click the Browse button to the right of the Filename And Location field, locate the file to which you want to export your data and click Save. You can enter the name of a new file, and select the type of text delimited format, (TXT or CSV) from the "Save as type" dropdown list, and ACT! will create the new file for you.

4. Click Next. The next Export Wizard panel asks what kinds of data you want to export. You can export contact records or group records, but you cannot export both record types at the same time. If you want to export both record types, you will have to go through the export process twice by first saving and exporting contact records, then saving and exporting group records.

5. Specify whether to export contact records or group records.

6. To specify how ACT! exports the data, click Options. The Export Options dialog box appears.

7. Specify the field separator that you want to use when creating your export file, and specify whether to export field names, then click OK. By default, ACT! uses a comma to separate fields when it creates a delimited text file. If the application into which you plan to import the file requires tab-separated fields, select Tab. If you select the Export Field Names option, the first line of the export file will contain the ACT! field names. This can be useful for mapping fields when you import the file into another application.

8. Click Next in the wizard panel. The next Export Wizard panel asks you which contact or group records you want to export.

9. Specify whether to export the current record, the current lookup, or all records in the database, and click Next.

10. The next Export Wizard panel asks you to specify the order in which contact fields from the currently open database will appear in the delimited text file. You can save the field order you specify as a field map that you can reuse when you export data in the future. For email address, be sure to use "Email Login".

When you have saved your file on your hard drive, go to Excel and follow the dotCal mail instructions for Excel.



Unsubscribe and Profile Update  

The 3 features in this area of the List Settings page relate to handling your recipients unsubscribing and updating their profiles by clicking on a link automatically placed at the bottom of your email.

1. Allow email recipients to unsubscribe and/or update their profiles. This is a feature you are strongly encouraged to have, since people always want the freedom to unsubscribe from your email list. Note that if you are broadcasting an email to over 100 recipients, the unsubscribe link is automatically added to your email. You are given two styles of footer and one type of header selectable in the drop down menu. Footer #2 is a little more more concise than Footer #1.

Footer 1 language: This dotCal mail was sent to you on behalf of your company name. You can take your email address off your company name's email list, or update your profile and/or send comments to your company name. If you request to be taken off your company name's email list, we will honor your request pursuant to dotCal mail's permission-based email terms and conditions.

Footer 2 language: This dotCal mail was sent to you on behalf of your company name. Leave this mailing list, or modify your profile. If you request to be taken off this email list, your company name will honor your request pursuant to dotCal mail's permission-based email terms and conditions.

Header language: If you elect to add a "header", this language will preface your email:
Click here to view this email as a webpage.

followed by:
Click here if you would like to update your profile or take yourself off this email list.

2. Send confirmation to Administrative Email of unsubscribes. When recipients unsubscribe, you can elect the option to receive an email notification when they do. In either case, your Master List will be updated automatically -- check the Email Format field for the unsubscribed recipient.

3. List Owner - this is the name of the company or organization that owns the list. The unsubscribe language in the footer of your emails will reference this person. Note that if this is blank, the footer will reference the


 

SalesForce PlugIn: Object Mapping  

This is where you will map your SalesForce fields to your dotCal mail CRM fields. The "Remote" column are SalesForce fields and the "Local" column are your dotCal mail CRM fields.

You must define at least one field mapping as the "primary key", which is used as the unique value that the two records share. It is strongly recommended that you use the SalesForce Object's ID mapped to a user defined field as your primary key. This will ensure the most reliable synchronization.

You may define the priority that you would like to assign each field. These priorities are:

  • Remote: Always use the value found in SalesForce
  • Local: Always use the value found in dotCal mail
  • Lastmod: Use the value from the field that was modified most recently

 

NOTE: It is strongly recommended that you give priority to "Remote" for the primary key mapping.

There are a few special functions that are available to you. These take multivalue fields in dotCal mail and map them to true/false (or boolean fields) in SalesForce. This is extremely useful if you want to map the EmailFormat field to a field in SalesForce such as "opted-out" or "emailable" or "bounced." These functions are:

  • FUNC: Unsubscribed -- Takes an EmailFormat value of "Unsubscribed" and turns it into a "true" value. It turns any other values found in the EmailFormat field into "false" values. For use with mapping to SalesForce fields such as "opted-out" or "unsubscribed."
  • FUNC: Bounced -- Takes an EmailFormat value of "Bounced" and turns it into a "true" value. It turns any other values found in the EmailFormat field into "false" values. For use with mapping to SalesForce fields such as "bounced."
  • FUNC: Emailable -- Takes an EmailFormat value of "Multi-Part," "HTML Only" or "Text Only" and turns it into a "true" value. It turns any other values found in the EmailFormat field (ie "Unsubscribed" or "Bounced") into "false" values. For use with mapping to SalesForce fields such as "emailable."

 "Remote" column are SalesForce fields and the "Local" column are your __PORTAL_PRODUCT



Maintain Duplicates for Textfile Import  

When you import a tab-delimited textfile into dotCal mail, you can choose to have the existing contacts always take precedence. These 2 checkboxes preserve any CRM data associated with the contact - the top checkbox preserves data about the contact, the bottom checkbox preserves mailing list assignments (if the box is checked, you can only add to the existing mailing lists, if UNchecked, you are redefining the mailing lists).

If the top "Maintain Existing Data" checkbox is not checked, the import file will always take precedence, so that if you have a blank field for an existing contact that you are uploading in your upload file, that blank field will take precedence and overwrite (delete) any data that exists in dotCal mail.

One way this is useful is if you want to clear out all data from a particular field (e.g., remove all data for your contacts' User1 fields). If you uncheck this box, you can also use this to remove data. For example, if you uploaded a text file with a blank User1 column (a column with User1 at the top and no User1 data for any uploaded contact) and unchecked this box, it would clear out the User1 data for each contact that was uploaded.

The Maintain Mailing List data checkbox allows you to upload a redefinition of Mailing Lists. If this box is not checked, your upload file will define the Mailing Lists that each contact is on. If the box IS checked, you will only be able to add to the existing lists (thereby preserving the lists your contacts are already on).

  


 

How the Master CRM Works  

The Master CRM (CRM stands for Customer Relationship Management) is a complete contact management system. Think of the Master CRM as an umbrella over all of your mailing lists. Your contacts (and recipients of your emails) can be in as many mailing lists as you would like, but the Master CRM is the central location to find out about those contacts.

In the Master CRM, you can store a contact's personal information (name, address, phone numbers), demographic information (age, gender), other contact information (where you met the contact, notes), and up to 50 user-definable fields. To view all of your contacts, click on the "View All" button on the left side of the Master CRM screen. To bring up the detailed contact record, simply click on the contact's email address.

With Shared Access (under the My Account tab), you can also control who "owns" each contact. You can use Shared Access to set up contacts associated with members of your team (e.g., salespeople) and then track each team member's progress.

Each contact has 4 CRM tools associated with the contact:

  • Events - these are emails scheduled for delivery to that contact
  • Activities - these are date/time-based activities between you and the contact (e.g., meetings, phone calls, emails sent)
  • Prospect/Sales Tracking - this keeps track of the sales cycle with the contact
  • Billing - accounts payable and receivable for this contact

You can also get detailed reporting for your Master CRM database by clicking on the "Reports" tab. This is useful for viewing trends in your contacts (e.g., Top 25 email domains), detailed company information (i.e., summary information for all contacts from a company), or team member performance.

Finally, you should become familiar with the various Utilities:

  • Import/export - get your contacts' data in and out of dotCal mail with XML or textfiles
  • User fields - define your User1-9 fields, and determine if you want to display them in your detailed contact record screen


How to cancel a broadcast  

When you broadcast an edition to a mailing list, it gets queued up in our servers for delivery. Delivery cycles run every 20 minutes, so the longest your email should wait in the queue to be delivered is about that much time, except in the highest traffic times, where your email may be behind other broadcasts in the queue (other broadcasts should never delay your email more than a few minutes).

If, after you click the "Send Now" button, you would like to cancel your broadcast, you can return to the "Send" page and use the "Cancel Broadcast" button next to the progress meter of your broadcast, at the bottom of that page.

It should be noted that canceling a broadcast in the middle of a processing queue is dangerous, as you will lose record of who will have already been delivered the email. If your email is in process of being delivered, only cancel your broadcast in case of extreme emergency.

Also important to note is that when you send a broadcast, it can only be canceled from the Send page. As a convenience, you can see a record of all of your broadcasts in the MasterCRM Calendar, but deleting the Broadcast activity from the Calendar will NOT cancel the broadcast.



AntiSpam Notice  

Rule Number 1: Thou Shalt Not Spam. Spam is generally defined as an unsolicited email advertisement. dotCal mail is to be used to send emails to people who have "opted-in" to receive your message. This means that you may use dotCal mail to send your email only if the intended recipients of your email have advised you that they want to hear from you.

You may also consider using an
Opening Paragraph to better communicate with your recipients, and reading our General Email Marketing Tips.

To broadcast an email using dotCal mail, the sender must confirm and certify that the email complies with all applicable laws regarding email deliveries (a partial list is available at spamlaws.com) as well as the Terms of Use, Privacy Policy and Anti-Spam Policy of dotCal mail.

Among other items, US Federal law (effective January 1, 2004) requires commercial email messages to include the following (you can review/modify these on the List Settings screen):

1) accurate "from" and "subject" lines;
2) clear and conspicuous identification that the message is an advertisement or solicitation;
3) a proper unsubscribe mechanism such as a valid return email address and/or unsubscribe link; and
4) a valid physical postal address of the sender


For more information, please consult your legal counsel.



How To Use Shared Access  

The Shared Access page allows you to create sub-accounts inside a single account, and provide different permissions to different users in that account. Each user uses the same username, but enters a different password. Once logged in, that user will be able to access only the parts of the account that the administrator grants access to.

For the most part, the table is self-explanatory. If you check a box, that user will be able to access that particular function. There are a few things you should be aware of.

The "Mastercontacts" permission has 3 possible values - View All, Edit User's, and Edit All. If the View All box is checked, this user will be able to view all of the contacts, including all of the stats associated with those contacts, and (if Broadcasts are granted) be able to broadcasts emails to those contacts. If you have only the "Edit User's" box checked, this sub-account will only be able to access contacts that that contact "owns". Contact ownership is defined in the Master Contact List with a field called "ContactOwner". The last box, "Edit All" will give the subaccount to all information for all contacts in the Master List.

The top section "All_Lists" applies to all individual lists, and takes provides for those permissions on ALL mailing lists.

If you allow a user to create new mailing lists, that user will have full permissions for the new lists created.



Approval For Mass Email  

To prevent unauthorized use of the dotCal mail system, if you are going to send to a large list, we require that you be approved for mass exports.
This is a quick process - just send an email to approvals@emailer.dotcal.com. In the email, include the following information:
• Your account username
• Your company name
• Your email list policy (how you get your lists)
• By sending this email, you are acknowledging you have read and agree to our "Anti-Spam" and "Terms of Use" policies
Important Note: If you rented, purchased, or traded for a list, you should not use this software. We charge $20-$50 per spam complaint if you do not have a legitimate opt-in record (proof of business relationship and approval to send email) for the complainer. Repeat offenders will have their license to use this software revoked. We do this to protect your ability to send messages to your clients, and to maintain our position in the industry as being 100% spam free.


 

Problems with quotes and apostrophes in your email  

Some word processing programs (e.g., MS Word) will create special angled quotes and apostrophes; this causes a problem with the ASCII character set, which you can set using the Template Manager. dotCal mails default to send emails in the Western European (ISO-8859-1) character set, which should alleviate the problem of some of your recipients seeing funny characters instead of the quotes and apostrophes you copied and pasted into your dotCal mail. The UTF-8 character set encompasses more characters than the US-ASCII and Western European, and may prove to be a better solution, particularly if you are including accented letters.

You have 3 remedies for this:

  • Do not write your content in your word processor
  • Select the Western European character set in your List Settings page. This does affect the ability for some recipients on older email servers to receive your message
  • Select the UTF-8 character set in your List Settings page. This is a newer standard, and may not be compatible with some legacy systems, but should display most of the characters you are trying to show.


Note that subject lines cannot contain accented characters.




Creating Dynamic Effects in Email
 

There are many ways that people can create dynamic effects with email, mostly having to do with mouse rollover effects. Of the two popular methods, JavaScript and cascading stylesheets (CSS), CSS is by far the preferred method.

Using JavaScript in the body of an email message will greatly reduce the effectiveness of your email. This is because Javascript can be used by less scrupulous programmers to create pop-up windows, mess with your browser settings, and various things you don't want to happen in an email. For this reason, most email programs will either treat JavaScript-embedded emails as viruses (and not deliver them), or disable the JavaScript in the delivered message. It is strongly encouraged that you not use JavaScript in your message.

Stylesheets can be used to create all kinds of rollover effects, but are limited in what they can do with images (usually, your rollovers will change a font color, background color, or text style). The only limitation with this is that some older email programs may not be able to fully display your stylesheet. Be sure to put your stylesheet in line with your message, and not use a HTML tag.

 


 

Send To A Friend  

This feature, accessible on the List Settings page for any mailing list, allows you to put a link or a small form at the bottom of your email, so that recipients can forward on the email to their friends. For privacy reasons, the recipient of the Send-to-a-Friend message is not automatically added to your CRM until the friend opts-in using the link at the top of the message he or she receives.

The type of Send To A Friend options are:

  • Large - a 2-part form, where the recipient can add their friend's email address and a message to their friend
  • Small - a one-line form with a space for the friend's email address
  • Link - a small graphic that is linked to a webpage where they fill out a form with their friend's email address and a message to their friend
    http://emailer.dotcal.com/images/sendafriend.gif
  • Link Colleague - another small graphic, this one is more applicable to a B2B list
    http://emailer.dotcal.com/images/sendafriend2.gif


The Thank You URL is a special page that can come up after the forwarder sends the message to his/her friend. This is useful when combining with promotions, encouraging people to forward your message to as many friends as possible. You can also put a website profile update form on this page, encouraging users to update their profile after they receive the send-to-a-friend email.

The Large Form Message applies if you have selected the Large Send-to-a-Friend Form. This message will appear in the textbox. In the case of the Link send-to-a-friend options, this message will appear as the default text in the page that the recipient sees after clicking on the send-to-a-friend link.

 



Email programs that block reads
 

Some email programs, like recent versions of Outlook and Outlook Express, will by default block all external content from emails sent by people not identified as "trusted senders". Since this is the default for all senders, you may notice in your testing that you see your emails in the preview pane with a message that says "Rick-click here to download pictures. To help protect your privacy, Outlook prevented automatic download of this picture from the Internet".

For dotCal mail to register a "Read" by a recipient, those images have to load. This means that if the email is deleted before the user right-clicks to allow download of images, it will not register as a read.

Unfortunately, there is nothing that can be done about this. Since it is controlled by the user, it is entirely up to the user's discretion to accept images being downloaded from your email. This is one reason why it's important to put compelling content in text near the top of your message.



Sent Graph On Tracking Page  

The number of emails sent on the first graph on the tracking page represents the number of email successfully delivered to your list. This is an important distinction, as when you first delivered your message, it gave you a number of valid emails in your list that you were sending to before bounces and unsubscribes were registered. As an example, you may have sent 1000 emails out on a broadcast, but 100 may have bounced and 50 may have been unsubscribes. In this case, the graph would display 850 Sent, as 850 were successfully sent to valid recipients.

Because our email servers deliver their messages so quickly, there is a short delay between when the message was sent and when your data tables mark recipients as "Sent". With very long broadcasts, this can take as long as 30 minutes - please be patient after you broadcast your email, and give our servers a chance to update your database with all the "Sent" tags for your edition.

 


 

 Why dotCal mail does not support attachments  

There are a number of reasons why we do not allow for attachments in emails you send out.

1. Attachments make your messages "heavy", meaning that all of your recipients would now receive more than just a small email message. This would greatly irritate someone on a dialup connection, as well as slow down our ability to deliver messages to your recipients.

2. Many viruses are sent through attachments. The virus threat causes many recipients, particularly corporate recipients, to completely filter out messages with attachments.

3. Even if you sent an attachment with your email, it would not be trackable. One of the great strengths of this system is the ability to track what links people click on. Due to the nature of attachments, you would not be able to track them.

Therefore, it is in everyone's best interest for you to create a link to a file, rather than attach the file to an email. If you need to put your file on the web, consider using our Document Library (included with every paying account).



Relative Read and Click Rates  

The Relative Read Rate and Relative Click Rate numbers (shown below the bar graphs on the Campaign Statistics page) are a rough estimate of how well your campaign went.

IMPORTANT NOTE: Every campaign is different, with different intentions and different measures of effectiveness - this is only a rough guide and a good way to compare and track your various campaigns.

Relative Read Rate is the ratio of the total number of reads over the total number of emails sent. Relative Click Rate is based on a ratio of clicks with respect to the number of reads.

 


Auto Hard Bounce Domains  

Question: I set my "Number of Bounces until Contact is Hard Bounced" setting to X. Why are some email addresses hard bounced after the first bounce?

Answer: Some domains (yahoo.com, earthlink.net, hotmail.com, and others) require us to hard bounce after the first "mailbox not found" error to ensure our customer's emails are delivered as quickly and with as little mail filtering as possible. This is because many email harvesters will perform "dictionary attacks" against major domains to obtain valid email addresses. That is, the email harvester has a predefined list of email prefixes (the "username" from "username@yahoo.com") that have a high probability of being valid and will email a domain with these, removing those which bounce from the list, and thus end up with a large number of valid email address which can be sold off or spammed directly by them.

  


 

Contact Information  

The Contact Information area on the List Settings page defines the list manager for all editions sent to this mailing list.

These three fields are very important, since they identify you, the sender and are required to be accurate to be in compliance with the law. Your email's "From" name and email address are defined by these two fields. The Contact Email is your email's "From". When your recipients reply to your email, they will send their reply to this email address.

The Administrative Email is NOT displayed to your recipients (this is helpful if you are managing the email broadcasting for another client). The Administrative Email is the email address that will receive all system notifications, such as Send-to-a-Friend, and Unsubscribes, and Broadcast Confirmations.

As of Jan 1st 2004, an email sender's Physical Postal Address is a requirement for all commercial email originating in the US or being delivered to US recipients. This address is an active, valid mailing address where your organization can receive mail and will appear at the bottom of the email you send.



Alternative Browser Compatibility with dotCal mail  

When will dotCal mail be compatible with alternative browsers, like Mozilla, Safari and FireFox?

It's not a matter of dotCal mail being compatible with Mozilla, it's a question of when Mozilla will bring their JavaScript technology up-to-date.

Just like Apple's Mac browsers, Mozilla's browsers have severe limitations in what kind of JavaScript they can render while you are working within dotCal mail. The WYSIWYG Edition Editor, and the text modification buttons (bold, italics, etc) in the form-based Edition Editor will not work because Mozilla does not support inline frames and dynamic content very well. We are all hoping that Mozilla improves their browser soon to resolve this.




Character Set
 

Defined on the List Settings page for a mailing list, the character set defines the alphabet that the recipient's email program will display. Of the languages available, the most compatible is Western European (the default). Western European is similar to US ASCII, with a few extra characters (note that a small percentage of old email servers will have problems with the Western European character set). If you are using angled apostrophes, quotes, bullets, or accented characters, and are having issues with formatting, you may want to switch your character set to UTF-8.

The other languages should be used when you are sure the recipients are all using that language.

The automatic spellcheck only works with messages set to US ASCII or Western European.

The new UTF-8 Unicode format is the most compatible with all languages. Most modern mail servers and email programs are compliant with this standard; however, some legacy systems may not be able to read emails in this format.



Maximizing Deliverability  

At dotCal mail, we try to provide you with the tools to maximize the deliverability of your email. If you see issues with deliverability (e.g., emails being put directly into your recipients' spam folder, or an inordinate number of bounces), there are a few things you can do:

1. Use the Preview page for your edition to check spelling and the use of spamtrap keywords. The bottom line - if your email looks like spam, it may be filtered like spam.

2. Encourage your recipients to add your "From" email address to their address book. Most email filters check their address book first, particularly users of AOL, Hotmail, and MSN.

3. Check the MasterCRM record for the contacts that bounced or were filtered. There should be some clues for you that describe what happened to cause this. The recipient server may have been down, or the recipient may have changed email addresses, or there may have been a network outage at the time of delivery.

It's a good idea to be familiar with the Bounce codes on the Manage Contacts page for your mailing list. Refer to the Tips button on that page to see what Bounce-A/B/C/D/E means.

If you have any questions about this process or would like to report any problems that you see to us, please do not hesitate to do so. We have industry-leading email deliverability and work every day to preserve this capability for you.



Outlook creates exclamation point in message  

If any line of your email is longer than 255 characters, Outlook will force a line wrap. Unfortunately, Outlook doesn't do this very nicely - it will add an exclamation point (!) and a space at that line break.

The best way to fix this is to break up your line with a space (use the space bar). This will allow Outlook to wrap the line on its own.

Note this 255 character wrapping includes all your HTML tags and text. If you add the space any place that can break up the continuous unbroken characters, it will fix the problem.

 


 

Recommended Opening Paragraph  

Here at dotCal mail, we have worked hard with ISP's around the world to ensure your message gets through to your recipients. We have very strict anti-spam policies, and it is against the dotCal mail's Terms of Use for you to send unsolicited commercial email (spam) using the dotCal mail system.

We also understand that you may have people on your list that may not remember who you are. To prevent irritating those individuals who might think you are spamming them, we recommend using the following introductory message (opening paragraph) near the top of your email. The following is an example you can modify to suit your needs:

Welcome to your company's monthly promotions email for July 2002. You're receiving this email because you are either an existing customer or have requested information from us. Take a look at our Privacy Policy (put a link here). At your company name, we don't send unsolicited emails. If you think you've received this email in error or do not wish to receive future emails from us, feel free to unsubscribe. Simply scroll to the end of this email and follow the instructions.

 


 

How to manually unsubscribe a contact  

You can manually mark someone as Unsubscribed two ways. This is important to do, as it will prevent further emailing to the contact. DO NOT REMOVE THE CONTACT FROM YOUR MASTER CRM - if you remove the contact from the CRM and then re-upload the contact into your CRM or into any mailing list, it won't be marked in the CRM as an unsubscriber, and will therefore be sent to again.

The two ways are:

1) You can change the email format in the MasterCRM to "Unsubscribed"

2) You can also upload a list of Unsubscribers to your MasterCRM. In the EmailFormat column place the word "Unsubscribed"

 



Bounces  

In managing your email lists you may notice that certain emails have bounced. Here are the codes for the reasons messages most often bounce:

  • A - User unknown or recipient mail configuration error
  • B - Bad domain (mail host does not exist)
  • C - Connection problem with mail host
  • D - Filtered, most likely by a content-based spam filter (check your edition content for spam-ish keywords)
  • E - Mailbox full, or other temporary warning that the message couldn't be delivered.
  • U or None - An unknown or no reason given for bounce

 

If we get a response from a mail server that would normally be categorized as a bounce type "C" (i.e. the server is busy or unavailable), we will continue to attempt deliveries for up to three days. If after that time we cannot deliver the email, it will then be recorded as a bounce "C". Once the bounce has been recorded, the system will not automatically attempt to resend and you must manually resend in a subsequent broadcast.

 An e-mail address that is flagged as a Bounce-A or B is not e-mailed to again once the "Number of Hard Bounces until a Contact is Marked as Bounced" (defined on the My Account screen) has been met or exceeded. The only exception to this setting is for our "Auto Hard Bounce" domains, for which we mark the contact as bounced after the first bounce type "A" or "B". Search for "Auto Hard Bounce" for more detailed information on this topic.

 Bounce codes "C," "D," "E" and "U" are usually temporary states, and will not be emailed to again once the "Number of Soft Bounces until a Contact is Marked as Bounced" (also as defined on the My Account screen) has been met or exceeded.

In all cases, a short transcript of the bounce reason we received from the recipient's server is available in the Master CRM record for that contact.



Adding contacts without email addresses  

You can add contacts without email addresses into the dotCal mail system in two ways. In all cases, if you have a contact that does not have an email address, that contact will be identified in the CRM as ###@noemail.com, where ### represents a unique identifying number.

You can import contacts without email addresses into the CRM like any other file import. If the email address is a blank field, we will automatically assign one to it in the format described above (###@noemail.com).



Ωhat is a Spamtrap?  

A spamtrap is an email address that email blacklisting services use to identify spammers. If one of the email addresses in your list is identified as a possible spamtrap, take it very seriously - there is a good chance that address could result in a spam complaint (something you want to avoid at all costs). Be extra sure that those contacts are indeed real people and that you have a double-opt-in record for them.



Change Name Or Layout  

Changing edition names is good if you need a better summary of the content of the page. HOWEVER, be very careful. You should not change the name of an edition after you send it - you will lose the ability to track that edition if you do.

You can override the default layout (set in your "List Settings" page) by selecting a new layout here, or with the "Layout" link in the navigation menu.

 



Using the Link Library  

The Link Library is a collection of every link we have recorded you sending in an edition plus any additional links you have stored for future use in emails to be sent using dotCal mail.

Each link can be removed from this page, but if it is, it will remove all tracking information associated with it, so be careful when you do this.

The Notification Options column is a way for you to keep informed of activity by your recipients. When either threshold is reached, a notification email will be sent to the email address specified. The Threshold for All Clicks is a global check for the total number of clicks made to this link from any edition you have sent out. It's a good way to inform yourself when your emails have hit certain activity milestones. The Threshold for Recipient is useful for following up with a recipient of one of your emails, so if you need to know immediately when someone has clicked on a certain link, you can enter a number here and be immediately contacted. Note that this Threshold for Recipient adds the number of times a recipient has clicked on a link inside that edition only (it is NOT a global check for every time that recipient has clicked on the link).

At the bottom of this screen is an easy way to add links to your Link Library. You can either add them one at a time by filling out the top text field and clicking "Add Link", or you can add many domains at once using the Crawl function at the bottom of the page. The Crawl function can add a substantial number of links to your Link Library, so read the crawling options carefully before crawling a website.


  

Managing Your Email List  

The Manage Email List page provides you with detailed information about the contacts in one specific mailing list. To help you understand the performance of your campaigns, this legend provides some useful information:

No Contact - the email edition has NOT been sent.

Sent - the email edition has successfully been sent (the number represents the number of times sent).

Read - the email edition has been read (the number represents the number of times read).

Survey - the recipient answered your survey (if a number is indicated, that is the answer the recipient chose).

Bounce - the email was not successfully delivered.

Find out more about
bounces.

An important note about deleting contacts:
When you delete a contact from this mailing list, the contact still exists in your Master List. If you want to make sure someone doesn't receive another email from you, go to the Master List and change that contact's Email Format to "Unsubscribed".


 
Document Library  

The Document Library is a place where you can store files (i.e., images and documents) for use in your email editions. Since it is impractical to send documents as attachments to big lists of people, we make it easy for you to make those attachments available in a single click to download. Getting started is easy - just click on the folder name on the left side of the screen.

After selecting a folder, use the form at the bottom of the page to upload any file from your hard drive and provide this information:

  • Choose New File or Replace and existing file
  • Description - information about the file
  • Sharing options - if you have Shared Access enabled and choose "Owner Only", other Shared Access Users will not be able to see the file you uploaded
  • Folder - which folder to put it in (or create a new folder).


Any link to that file from a dotCal mail will be tracked, so you will know how many people have downloaded your file.



Document Library Storage

Your storage space in the document library expands as your subscription level increases. Each account is allocated storage space based on the following formula:

20kbytes x Monthly Subscription.

So, if you are subscribed for the $39.95 plan, your document library can hold up to 799 kbytes of data (20 kbytes x 39.95 =799 kbytes)

Files must be under 2 Megabytes to be included in the document library.

To add additional Storage Space to your account click on "Add space to your Document Library" from within your Document Library. Storage is added in increments of 10MB for $10/month.




How to Reduce Your Bounces
 

Bounces occur for a variety of reasons, the most common of which is that the recipient does not exist (invalid email address). However, some bounces are the result of filters or blocks placed on your recipients' email servers.

Getting around those filters and blocks can be tricky, but a few steps may go a long way toward helping you be a more effective email marketer:

  • Try changing your recipients' Email Format (in the Master List) to "HTML Only" - some older email servers don't understand the dotCal mail format, which is "multipart/alternative". Older email programs, like Lotus Notes and PINE should be set to "Text Only", as they are not capable of interpreting HTML email.
  • Don't make your email look like spam - if you have all kinds of gaudy, big-bold-text annoucements about free this or limited time that, it'll probably get picked up by a spam filter (and ignored by your recipients).
  • Whenever possible, put your recipients' Firstname and Lastname into your Master List. Having names associated with your list makes it appear like you really know who your recipients are.
  • If your ISP is still blocking your legitimate messages, contact your ISP and find out what rules they have set up for email filtering and how you can control them. It may be that the ISP has set up a spam filter that also filters out legitimate emails from your friends, family, and business contacts (unfortunately, this is an all-too-common occurrence).

 

At dotCal mail, we work very hard to ensure your messages get through to their recipients.

More information about this subject is available through http://www.talkbiz.com/assassin.html

Remember, above all, do not spam!



External Interface To Document Library  

This Knowledge Base file describes how to interface with the Document Library using an external HTTP POST.

To upload a new file into the Document Library, you must supply the following name/value pairs:

  • Username - the account username
  • Password - the administrator password for the account
  • ExternalPost - set this to any non-blank value

To add a file to the Document Library, send the following data:

  • newlibfile - this is the raw (binary) data of the uploaded file
  • newfilenum - set this to a number of an existing library file, or "new" if it's a new file
  • newdescription - this is the description of the file
  • Sharing - the owner of the file, matching the name of the contact as defined in the Shared Access screen
  • Directory - the directory in the document library to put the file
  • newfoldername (optional) - to put the file in a new folder (use a slash to separate subdirectories

 

Limitations of Macintosh with dotCal mail  

Apple's Macintosh is a great computer platform; unfortunately, some Mac browsers have severe limitations in what kind of JavaScript they can render while you are working within dotCal mail. The WYSIWYG Edition Editor, and the text modification buttons (bold, italics, etc) in the form-based Edition Editor will not work in these browsers because they do not support inline frames and dynamic content very well. Internet Explorer, and some versions of Firefox have demonstrated this.

Fortunately, this problem can be overcome. You have three options:

  • Virtual PC, a program available for Macintosh users
  • Safari, the latest versions of this browser appear to support all of the latest Javascript functionality
  • Switch to PC, using Internet Explorer for the PC, which allows you to use the dotCal mail platform to its fullest capacity



Require Captcha Authentication for Single Opt Ins
 

Utilizing single optin scripts opens your account to unscrupulous Internet users who have "bot" scripts that search the web and add bogus email address to legitimate lists. If you have set your account to Allow Single Opt In Signups, it is strongly recommended that you require Captcha authentication. Once this setting has been checked, you will need to insert the following code into each of your signup forms:

<img src="http://emailer.dotcal.com/captcha.pl?username=careoregon"> <input type=text name=captcha_value value="">


Delayed Broadcast Billing  & Delayed Broadcast
Question: I have a question about the feature that allows us to delay the sending of email batches. If we have a batch that we want to work on today (the last day of the month) and want to press the send button today but actually will schedule the sending for tomorrow (the first day of next month), what month will the emails be attributed to (this month or next month)?

Answer: The emails are counted when they are queued up - so if you hit the "Send" button today, the emails would be added to this months total notwithstanding the fact that the emails are actually scheduled to go out at a later date.



Why some recipients have high read numbers  

Some of the recipients of your emails may show very high numbers of reads. There are some reasons for this:

  • They are very interested in your email and want to read it again and again (kudos to you!)
  • Your email is sitting at the top of their inbox. This is important, particularly if they have a Preview Pane. Every time that Preview Pane loads, it loads the read registration image, which tells our server that your email was read again.
  • It was forwarded on to someone else using their "forward" button. When someone forwards an email to a friend with their email program's "forward" button, it sends the entire email (usually intact) to someone else. This means the read registration email is unchanged when the recipient of the forwarded message opens it. For this reason, every opened email that the email was forwarded to marks as a read to the original recipient.



Text Only Message Does Not Display Line Breaks in Outlook
 

If you are designing a Text Only message, you may run into problems when viewing your edition in Outlook 2003. This is because Outlook 2003 removes all line breaks it thinks are unnecessary in the display of the message.

By default, most email programs wrap text messages at 72 characters. Recent versions of Outlook do not do this, preferring to let a text message wrap at the edge of your preview pane.

If your text message has newlines at other locations, Outlook may reformat your text message. To see it accurately, click on the "This message has extra line breaks" bar at the top of your message while in the Outlook preview pane. From there you can restore the line breaks and see how it will look on all other email programs.



Setting Up Triggers and Auto-Responders  

Setting up an auto-responder is a simple task with dotCal mail. Under the "Help" tab, or on any mailing list's Contacts page, you can get to the website signup form page. From there, there are two ways to set up your autoresponder.

You can use the Auto-Subscribe Wizard, which walk you through a 5 step process to create your website signup form, and in one of the steps you will be asked for the mailing list and edition you would like to have triggered, or activated with a delayed trigger (we call auto-responders "triggered emails"). In the wizard, you can define an immediate trigger (useful if you want to make a "thank you for signing up for our list" email to be sent to your new subscriber), as well as up to 2 delayed followups.

If you would like more delayed triggered emails (auto-responders), you can look at the "Special Options", at the bottom of the main Website Signup Form page.

Since this capability ties directly in with your Master CRM, you can look in there at any time to see the emails that are scheduled to be sent to any of your new subscribers under the "Events" section in the detailed record for the contact.



DeDupe Against Other Lists  

From the "Manage Email List" screen, you can click on the "Clean List" button to access this feature which enables you to remove email addresses which are in another list. If you wanted to make sure that a certain contact was only in List #1 and NOT in List #2, you would:

a) go to List #1's Manage Email List;

b) click the Clean List button;

c) select List #2 from the dropdown menu;

d) select the radio button indicating that List 1 has priority; and

e) click the De-Dupe Against This List button.

This process would automatically remove the duplicate from the second list and update the Master List.

In the case of a duplicate email address, the address remains in whichever list has "Priority" and is removed from the other list. If you want to de-dupe against more than one list, go in order of priority. Example: if you want to make sure a contact is in only one of List #1, List #2, and List #3, and List #1 is higher priority than List #2, which is higher priority than List #3, simply run the De-Dupe Against List #2 first and then List #3.

 



Embedding Link to Webpage In Message  

Every time you send a dotCal mail, the dotCal mail system automatically creates a webpage for you. We create this page for your recipients that had a problem viewing the HTML version of your email. By allowing them to click on a link to the webpage, you can track their reads and clicks, and provide them with the intended version of your message.

If you would like to include a link to this webpage in your email, you can do so by adding the following URL to your email:

http://emailer.dotcal.com/r.pl?SessionKey_Placeholder_mrecEnc_Placeholder

This link is automatically included at the top of all "text-only" messages you send out. If you would like to include this this link your HTML messages as well, simply create a link (<a href=>) to the URL provided above.

In the Template Manager/List Settings page, you can also select "Header+Footer" in the Unsubscribe/Profile Update options, which will include this link at the top of the HTML part of your message.

This feature allows you to track when a text-only recipient clicks on the link to your webpage and on any link on the webpage its in.



 

Searching Master CRM With A Wildcard  

To search the Master CRM for anything in a field, use the asterisk (*). Example: to find all the contacts with anything (not a blank field) in the Company field, type * into the search field and select Company from the drop down menu.

You can also search the Master CRM for any fields that are blank. Use the tilde (~) by itself in the Search textbox to do this.



Extended Story  

The Extended Story feature allows you to create a shortened version of an article in your email, with a link to the full story. This link is trackable, and will open a web browser that displays the entire email, with all of the extended stories in it.

The 2 placeholders you need are ExtendedStoryStart_Placeholder and ExtendedStoryStop_Placeholder. Between these placeholders, dotCal mail will create a link in the email that looks like
More..., which will link to the full story when clicked on. These placeholders can be inserted into your HTML with the "Include" button (form-based Edition Editor), or the special character button (WYSIWYG Edition Editor), or embedded directly in your uploaded HTML.

Below is an example of what your message body would like (in your Edition Editor):

This is a paragraph about some product or service you want to sell. This product is really great and you should buy it from us. ExtendedStoryStart_Placeholder We have over 100 widgets in stock, and they're on $10 each. We make widgets in our plant every day.ExtendedStoryStop_Placeholder

In the email you sent out, you would see this:

This is a paragraph about some product or service you want to sell. This product is really great and you should buy it from us.
More...

Once the recipient clicked on the "More..." link, a web browser would open and would show the entire email:

This is a paragraph about some product or service you want to sell. This product is really great and you should buy it from us. We have over 100 widgets in stock, and they're on $10 each. We make widgets in our plant every day.

Note that the Extended Story feature has to be tested in the email you receive. In the Preview screen, you will see your entire message, not the version with the "More..." link in it. You can send yourself a test message using the Send screen to make sure it is working as you want it to.




General Content Tips
 

Now that you can design and send out a newsletter, you need to fill it with content that your audience will want to read. If you are promoting a business through your newsletter, you want to express a sense of community, of shared interests, of an accessible, customer-oriented company. Some ideas that will enhance the readability and interest from your readers are:

  • Announcements:  There are ways to announce new web site content, sales, and upcoming contests without sounding like a pushy ad. Emphasize the benefits of promotions by naming prizes that can be won from your site. Subtly highlight discounts and new product lines without resorting to a hard-sell.
  • News:  Find interesting tidbits or news regarding your market sector. For example, if you have a skiing newsletter, you could include a short, fun history of the sport. Make it informative and different.
  • Links:  Give links to helpful and/or site-related information, or choose a "Link of the Month." For more exposure, consider trading newsletter links with another partner site. For more information on how to insert links into your page, read the tutorial on embedding HTML.
  • Various fun stuff:  Anything goes, as long as it is entertaining, cool, and has at least a tenuous relationship to your site. Recipes, famous quotes, funny anecdotes, jokes, and surveys are all good ideas. Be creative and readers will keep coming back.


Articles and More Information
 

Tips for Writing Better Emails

Articles about Email Marketing

  • "RE: Email Subject Lines That Work?" by Bryan Eisenberg, ClickZ, 21 May 2001
  • "12 Common Mistakes in Email Marketing" by GrokDotCom

 

DomainKeys  

DomainKeys is Yahoo's email authentication protocol. It is licensed under the GPL version 2.0 and is seeing fairly wide adoption throughout the industry.

How it works

When an email is sent, the mail server digitally signs the message with a private key. When a DomainKeys compliant receiving mail server accepts the message it uses the public key to decode the digital signature and determine if the message is valid.

 

What you need to do

You simply need to publish the correct DomainKeys public key in your DNS record for your sending domain. Your "sending domain" is defined as the domain portion of the email address used as the "From:" address on the list settings page for each list. For example, if your "From:" address is "myname@mycompany.com" your sending domain is "mycompany.com".

 

Visit our Domain Authentication page (found in the Help section) to obtain the most up to date DomainKeys record and ask your domain administrator to publish this in your domain's DNS record. Once published, you may submit your domain for testing by our system. Once your domain passes the tests, your emails will be DomainKeys compliant.

Please Note: For full authentication compliance you will need to have your administrator publish our Sender-ID record, which is also available on the Domain Authentication page.

 


 

TextOnly Message  

Most emails that are sent to your recipients will be formatted in "Multipart", which means that those recipients will be delivered the highest-caliber email possible. Not all of your recipients will be able to receive HTML email (there are many reasons for this, including network firewalls, or individuals using older email programs). You can override the email format for any recipient using the Master CRM.

In case someone can only receive a text message, the textbox at the bottom of the Preview screen for your edition will be delivered to that recipient's inbox. dotCal mail has 2 settings - if you see "Automatically Generated" in the textbox on the Edition Editor page, dotCal mail will attempt to convert any text you have entered into a nice, reader-friendly text format. If you would like to modify the text message, you can put whatever you like in that textbox. Remember, modifications have to be done in the Edition Editor. You may find it helpful to copy the TextOnly part here, and then paste it into the Edition Editor for modification.

At the Preview page, you will see what exactly the text-only version of your email looks like.

If you change the Text-Only Message part, but then would like to revert back to an automatically-generated text version, all you have to do is delete everything in this text box on the Edition Editor.

Note that tracking information and stats for text-only messages is disabled, due to restrictions on line length.



Using anchors or targets to reference articles  

You can easily create links to other parts of your email using "anchor" (also refered to as "target") tags. These links reference various locations in your message marked with <a name="something">. To link to this location in your email, simply create a link that looks like this: <a href="#something">click here</a>.

This will create a clickable link that will instantly move the page to wherever the < a name="something"> marker is.

Please note: The clickable link location begins with a '#' whereas the target link does not.



You can embed the Send-to-a-Friend form into a dotCal mail with a form like this:

<table> <form method="post" action="http://emailer.dotcal.com/send2friend.ice?tag=Unique_Placeholder&sentby=Email_Placeholder" target="_blank"><tr><td><font color="#000000"><b>Send this email to a friend:</b></font></td></tr><tr><td><input type=text size=20 maxlength=50 name="email" value="Enter Email Address"> <input type=submit value="Send" style="background:#9997fd; color:darkred; font-weight:bold"></td></tr><tr><td align=center><textarea rows=3 cols=24 name="comment">Check out this email!</textarea></td></tr><input type="hidden" name="tag" value="Unique_Placeholder"><input type="hidden" name="sentby" value="Email_Placeholder"></form> </table>

To add a link send-to-a-friend, you use this:
<a href="http://emailer.dotcal.com/send2friend.ice?tag=Unique_Placeholder&sentby=Email_Placeholder">Send this email to a friend</a>



Use dotCal mail to Coordinate Events  

Ever wanted to use a simple tool to tell people about an event and follow up with them? With dotCal mail, it's easy.

You can direct people to a website with an auto-subscribe box, and have them sign up for a list, and then have them receive up to 2 follow-up emails. On your website signup form (see this on the "auto-subscribe" page on your Manage Email List page), all you have to do is add these two lines:

<input type=hidden name="delay1days" value="10">
<input type=hidden name="delay1edition" value="CoolerTips_7feb02">

which will send out that MailingList_Edition 10 days after the individual signed up.

You can also manually add events into the Master List. You can easily send a reminder dotCal mail to that contact by setting the edition and the date of the reminder email on the Event #1 and Event #2 fields in your Master List.



Salutation  

Defined in the List Settings, your salutation will go above the graphical part of your email. This is how you personalize your email. We will put the recipient's name (defined in your Email List) after the 'Prefix', if you have defined it. If not, we will put the 'Addressee' in the salutation.

Example: if you have your 'Prefix' defined as 'Dear', all emails you send out will have a 'Dear Joe' or 'Dear Mary' at the top of the email; if you have your 'Addressee' defined as 'Valued Customer', any recipients you did not supply a name for will receive their email addressed as 'Dear Valued Customer'.

You can also embed the Addressee field inside your email using the 'Addressee_Placeholder' string. This will display the recipient's Firstname (if you have it) or the Addressee you define here (if you don't) in place of the Addressee_Placeholder string.



Embedding Profile Update or Unsubscribe In Email Body  

You can embed an "Update Your Profile" link (which also includes the Unsubscribe option for recipients) in the middle of your email using this link:

http://emailer.dotcal.com/un.ice?Unique_Placeholder&Email_Placeholder&rec_Placeholder

Anyone that clicks on the link to that URL will be taken to the standard unsubscribe/profile update page. Your settings for that page are defined on the Manage Email List page.

On some text-only recipients, this link can be too long. To use a shorter link you can use this:

http://emailer.dotcal.com/un.ice?Unique_Placeholder&ToEmailPrefix_Placeholder&rec_Placeholder

We also provide these pages in Spanish and French. To make the unsubscribe/profile update in these languages, append this to the end of the links above:

&Espanol (for Spanish)
&Francais (for French)


 

Recipient mail program crashes  

Occasionally we hear about recipients of emails sent out of our server causing a recipient email program to crash. This is almost always due to software being out of date (not having a recent version) or other conflicts with HTML email rendering programs. Since it is impossible to get on every recipient's computer to fix it, the easiest solution is to convert the recipient's EmailFormat in the MasterCRM to "Text Only".

The only email programs we know of that have this problem are Outlook and Outlook Express from before 1997, old versions of Lotus Notes (version 4), and old versions of Eudora (from before 1998).

 


 

How do Gmail users view emails?  

If you send your email to a recipient on Google's Gmail service, you have nothing to fear. Gmail works almost identically to Outlook 2003, in that it by default will not load images. On one hand this may reduce your readability, as images are required to load for a "Read" to register. On the other hand, if you are writing truly compelling content, it is easy for the Gmail user to click on a link that says "Load External Images" to download all the images in your email.

If you do not want Gmail users to go through this, you can always set their EmailFormat to "Text Only" in the MasterCRM; however, it is probably in your best interest to keep the message with the standard EmailFormat in your Master CRM.



Import Email List From Excel  

This instructions apply when you are importing using the quick import on the Manage Contacts page. Note: this is a different import process than if you are importing with the Master CRM screen.

Start Excel. Open the spreadsheet file (.xls) that has your contacts.

Your file can have a header, or label, row (it's optional). The spreadsheet should only contain contact data. Column A should have names, Column B should have company names, and Column C should have email addresses.

Select File, Save As.

At the bottom of the Save As dialog box, set the "Save As Type" option to Text (Tab delimited) (*.txt).

Enter the file name you want to save it as (like mainlist.txt) for the export file and click Save. Remember where you saved it, because you'll have to upload it to dotCal mail later.

You will probably see a warning about the destination file type not supporting multiple sheets or formatting - click OK.

Bring up your dotCal mail window and select the file you just exported (e.g., mainlist1.txt).

dotCal mail will handle the rest of the import for you!

 



How to make Flash more effective  

Not all of your recipients will be able to display any Flash in your dotCal mail. Since JavaScript is disabled in most email programs, you can't run any of the standard website-based Flash detection scripts. So what do you do?
We discovered a cool way to do this, which is likely to be beneficial to you. Since Flash will display as a transparent image, you need to put an image behind it that people can see if the Flash movie does not play. Here is some sample HTML:

<table width="100%" cellpadding="0" cellspacing="0">
<tr>
<td width="500" height="375" background="http://www.stadis.net/images/flashbg.gif">
<embed src="http://emailer.dotcal.com/presentation/intro.swf" border=0 width=500 height=375>
</td>
</tr>
</table>

Currently this technique can only be used on imported HTML files (not through the dotCal mail templates)



Sender-ID  

Sender ID is Microsoft's email authentication protocol. Though Microsoft hopes to have the protocol adopted industry wide, it has not seen wide spread adoption due to licensing concerns.

How it works :

Sender ID works by determining if the sending mail server is authorized to send email on behalf of the purported sender of an email, as defined by the value of the "From:" header of an email message. An existing Internet protocol, Domain Name Service (DNS) is used as a database and query mechanism to obtain the authoritative information needed to pass judgement on each message.

 

What You Need to Do:

You simply need to publish the correct Sender-ID record in your DNS record for your sending domain. Your "sending domain" is defined as the domain portion of the email address used as the "From:" address on the list settings page for each list. For example, if your "From:" address is "myname@mycompany.com" your sending domain is "mycompany.com".

Visit our Domain Authentication page (found in the Help section) to obtain the most up to date Sender ID record and ask your domain administrator to publish this in your domain's DNS record. Once published, you may submit your domain for testing by our system. Once your domain passes the tests, your emails will be Sender ID compliant.

Please Note: For full authentication compliance you will need to have your administrator publish our DomainKeys public key, which is also available on the Domain Authentication page.

 

 


 

Who received text vs HTML email

By default, dotCal mail sends out email in multipart format, meaning that your recipients get both a text and an HTML version of the email you are sending out.

HTML email provides for the ability to display colors and images, and it also allows us to track when your recipients open their emails. Only HTML email does this - since there are no images in text emails, there is no way to track opened emails.

When you look at your realtime statistics, you will see a percentage of your recipients are confirmed as having Read the email - usually between 20-60%, depending on your relationship with your recipients and the content of your email. The remainder of your list did not receive HTML email. This could be for a variety of reasons:

Because there is no way to determine which of the above happened, there is no way to confirm the number of text readers vs deleters. Anyone that tells you otherwise is lying to you (this is a limitation of how email technology works).



Send Webpage to a Friend or Colleague  

The best use of this function is to encourage visitors to your website to tell their friends about your site. You can add a link on your website to Send Webpage to a Friend to any place on your site.

The format for the link is:
<a href="http://emailer.dotcal.com/sendWebpage.ice?username&MailingList" target="_blank">Send this page to a friend</a>

The username is your username. The Mailing List defines the email settings to be used in the confirmation emails.




Setting Date Placeholders  

You can set mail merge placeholders in your email edition that correspond to the full date or parts of it. The date is determined by the actual delivery date, as that is when your message is assembled for final delivery to your recipients.

These date fields are:




Working with images in the Document Library  

You can use our built-in image manipulation program to modify images you upload into your Document Library.

Simply click on the link to any GIF, PNG, or JPG image to bring up the form that can be used to modify the image.

You can resize, crop, sharpen, enhance, and adjust contrast to your image with this form. All changes made are instantly reflected in the file in your Document Library.

If you need to do really advanced functions with your image, we strongly recommend you use a PC- or Mac-based graphics manipulation program like Corel Photo-Paint or Adobe Photoshop (or Elements, for a less expensive option).

Note that when you're building your email, you only want to use GIF, PNG, or JPG images. Do NOT use bitmaps (BMP), or uncompressed graphics files (like TIF's).




Adding Forms in Emails  

As a general rule, if you provide a form in an email, you should also provide a link in the email that will allow the user to call up a separate webpage and fill out that form. This is because many email programs will disable forms. This behavior can be witnessed if the recipient receives a form, and when clicking on the "Submit" button for the form, nothing appears to happen.

The surveys and send-to-a-friend forms that you can generate using dotCal mail both provide these links beneath the forms. In case the form is disabled by the recipient's email program, the recipient can then click on the link to open the form in a separate webpage.




Using RSS Feeds with your emails  

Using the My Account - Update Account screen, you can set up an automatic RSS feed for emails you send out. When the "Create RSS XML File when Sending to Specified Lists" checkbox is checked, you will have a new checkbox at the top of your List Settings page. If that box is checked, all editions sent to that mailing list will be added as <item>s to the main RSS XML file (rssfeed.xml).

RSS, or RDF Site Summary, format is an easy way to generate standardized content that can be reproduced on other websites. One of the most useful functions for an RSS feed using your dotCal mail account is to create an archive of sent emails.

If you check the RSS box on the List Settings screen, you will turn on an automatic feature that will update an XML file that can be used for retrieving all emails you have sent from your account to that mailing list. This format, using RSS 2.0, is standard XML that can be read by any RSS reader. The subject line of the email message is the <title> of the <item>. Each edition you send out is given its own <item>.

Note that for your convenience, you will see the entire link to the RSS XML file after you click the Send Now button on the Send page.




Multiple email addresses for one contact  

If someone has more than one email address, each email address is treated as a separate contact.

The dotCal mail system uses the email address as the primary key, meaning it is the one thing that keeps each contact separate from all the rest.

 If you would like to use single opt-in scripts with dotCal mail, you may do so by checking this option. You will also have to replace the double opt-in script (multidouble.ice) in your signup form with the single opt-in script (multisubscribe.ice).

Please be aware that this will degrade your delivery classification as our primary sending pool is reserved for double opt-in form users only.

 

It is strongly suggested that you do not use single opt-in subscription forms as you have no way of knowing if the owner of the email address is actually the one signing up to receive emails from you. It is not uncommon for rogue individuals to add spamtraps or other questionable contacts to your list in hopes of causing you grief with SPAM complaints.

 

Further, many ISPs and black list operators (notably SpamHaus) will not accept single opt-in records to resolve SPAM complaints, effectively forcing the industry to move exclusively to confirmed opt-in records (also known as double opt-in).

 

If you must use single opt-in forms with your site it is also strongly recommended that you make use of our CAPTCHA authentication mechanism (search the help files for CAPTCHA for more information. In the future this may become a requirement for all single opt-in forms.

 

For those users who have been using the single opt-in form (multisubscribe.ice) but would like to quickly and easily convert their forms to confirmed opt-in (double opt-in), simply unchecking this box will cause all of your subscription requests to be turned into confirmed opt-ins!

 

 


 

Email Marketing Tips  

Here are a few tips to help you with email marketing.

1. Make your marketing e-mails inviting, stay away from SPAM words (sale, days left, etc)
2. Make your e-mail campaigns interactive so they have something to click on that can be tracked.
3. Let them know they are in control of being on or off your list.
4. If you're unsure...white background, dark border, and dark letters are safe for a professional e-newsletter.
5. Include bullet lists when you can to make your features or points clear.

Marketing tips provided by
Dan Lavelle, CCC



Can dotCal mail Send A Virus?  

You may run into a situation where a recipient believes you have sent him or her a virus.

This is always the result of a bad virus scanner or a virus scanner that is improperly configured.

Because dotCal mail does not receive emails, we cannot transmit a virus unless you intentionally put one in the message (which, of course, we know you would never do).

 


 

Disallow Legacy Reader Script  

The "view this email as a web page" (or "reader") script has been updated to require encrypted input. Some users may still be using the old script (reader.ice) within the body of their editions and this setting prevents those editions from breaking. On June 30th, 2007 we will be disabling the legacy reader script altogether and all editions must be updated with the new script:

http://emailer.dotcal.com/r.pl?SessionKey_Placeholder_mrecEnc_Placeholder




Bounces On Tracking Page  

dotCal mail registers bounces in two places - your Master List and the statistics for each individual mailing list. This allows you to track recipients who have bounced in a specific edition. When you compare the bounces on the Tracking page, you will most likely find a difference between the number here and the number on your Manage Email List page. This is because the Manage Email List page will display all bounces for all recipients in your mailing list, regardless of which edition they bounced. The graphs, on the other hand, only display bounce data for people that bounced on that specific edition.

Find out more about bounces by searching for the term "bounces" in the help section



Vew email as webpage  

View Email as a Webpage---If you would like to view your Email as a webpage, you do so by visiting the link automatically created immediately after you send your email.

After you send your email, you will see the website location (URL) of the page.




Why SMS may be useful to you  

SMS, or short message service, also known as "text messaging" for mobile phones, may be a good fit for your organization.

The most common use for SMS in business is for announcing time-sensitive information to an audience. For example, if an event you are producing is delayed, moved, or canceled, SMS is an ideal way to communicate this. SMS is also a good way to develop a sense of urgency in your clients - if you are running a limited time offer or sale, a reminder several hours before the end of the sale may stimulate demand for what you are selling.

Because SMS is also an unfiltered medium, your message will get through to your recipients. For VIPs in your contact database, this is a good way to ensure they get important messages from you.

More information on setting up and using SMS in your dotCal mail account is available in the Knowledge Base article "Marketing with SMS"



Recipient Challenge Response Filters  

Many recipients of your emails will have a challenge-response filter set up to protect themselves from spam. These require some form of human interaction to confirm that the sender is, in fact, a real person. Since most spammers send out emails by the millions and use fake sending email addresses, challenge-response filters are a good way for people to protect their email systems.

dotCal mail does not have any scripts designed to bypass these filtering systems. There are many reasons for this, but the most important is that our reputation in the email industry is strong because we do not allow spam to be sent through our servers and we respect the rights of recipients to control their inboxes (we all experience the same spam issues). As a sender, you are likely to receive a fair amount of these challenge response emails back in your inbox (the From email you define in your List Settings screen). If you are concerned with those recipients receiving your emails, take a couple minutes to go through those challenge-response emails and ensure they get delivered to your clients.



Generate Subscribe Code Multiple  

By placing the HTML displayed on the auto-subscribe page on your webpage, you can create an automatic signup box. This code is different than the code above in that it allows someone to sign up for multiple email lists in your account.

Just set the 'value' for each list (defined by names 'name0' through 'name9' as the names of the lists in your account - you can see these names by clicking on the Home button in the upper left corner of the interface).

You can replace all of the checkboxes with input type=hidden form fields.

As in the first signup box, the name and company fields are optional. The 'notification' hidden form field works to send you an email when someone signs up for your email list(s). If you leave it blank, you will not receive any email.

To have multiple people receive the notification that the signup has taken place, separate those email addresses with a comma.



Flash Display Question  

Question: We have a fantastic flash email we are sending through your email system. Some of the recipients get a warning message that "due to the security settings on your computer, this email may not display properly" (or something to that effect). They then click "OK", and can view the email, but the flash does not appear.

Answer: The reason some folks get this message is because their security settings are set to the highest level, which will not allow the Flash piece (or any Active X item). If the recipient simply chooses a security level of "medium" (within his/her email program), the flash should display correctly.



How To Embed A Target In A URL  

To allow users to jump up or down within your email, simply do this:

The link you click on:

<a href="#linkname">Click here to go up/down</a>

(The # means that this link goes to someplace on the same page)

Put this at the point where you want to scroll up or down to:

<a name="linkname">



Limitations of Preview With Stats  

Due to the nature of how data is shown on this screen, there are a few issues for you to be aware of when analyzing data using Preview With Stats. The following conditions will affect the accuracy of data shown here:

 


 

AB Split  

Access the A/B Split on the New List page, using the button on the Control Panel.

An A/B Split is a way you can generate a small test list and a main list at the same time. Commonly used to test the response of a particular message before sending to your main list, or to send two messages to two similar lists to measure their effectiveness, the A/B Split is a fast, convenient way to create 2 new lists at the same time from one larger list.

The names of the 2 lists created are based on the new Mailing List name you provide in the left column -- if you put "mylist" in the Mailing List Name, the 2 A/B Split lists created will be "mylista" and "mylistb".

Each new A/B Split list will be made up of randomly generated samples of your original mailing list's email list.



Copying Content from Microsoft Word  

When using the dotCal mail Editor version 1 or 2 we highly recommend that you do not paste any content directly from a Microsoft Word document into the dotCal mail Editor interface. Microsoft uses proprietary hidden formatting code that will be copied over with the content. You won't see the formatting when pasting but it's there if you look at the code of the Edition you are working on, and you can do that by clicking on the button labeled . The trouble becomes more apparent when you create a New Edition from a previous Edition that was created with Word pasted content. What you will think you are doing is simply copying and pasting new Word content over old Word content BUT the old content's hidden formatting is NOT removed but more hidden formatting code is added, thus you are unknowingly duplicating the formatting code and doubling the size of your Edition's HTML code.

If you choose to copy and paste content directly from Microsoft Word into the dotCal mail Editor it is at your own risk. Always copy Word content first into an ASCII editor like Notepad and then into the dotCal mail Editor interface. If you must paste directly from Word into the dotCal mail Editor, the best advice we can give is to always start your Edition from scratch and never duplicate a previous Edition to be used as a template to copy over the old content.

This tip is specific to the two versions of the dotCal mail Editor. Word content pastes much easier into our other templates but we still recommend pasting into a ASCII text editor like Notepad first and then into any of our Editors.

 



Submit to double Opt-In sytem via PHP  

If you would like to host your own signup form, but still use our double opt-in system, PHP offers a very easy solution. You must have Curl included in your PHP installation. Just include the below code in your form processing PHP script. Populate the $params array with a mix of information from the form submitted by the end user, and the specific dotCal Editor account and mailings which the end user is subscribing to. The specific mailling lists are set with the list0 - listN keys, The value returned by sendSubscription is simply the html returned, as if the user signed up using our hosted form.

$params = array(
'email' => 'SUBSCRIBER EMAIL ADDRESS',
'name' => 'SUBSCRIBER NAME',
'company' => 'SUBSCRIBER COMPANY',
'username' => 'careoregon',
'notification' => 'gormane@careoregon.org',
'contactemail' => 'gormane@careoregon.org',
'contactname' => 'CareOregon',
'list0' => 'FirstMailingList',
'list1' => 'SecondMailingList',
'list2' => 'ThirdMailingList',
);

$content = sendSubscription("http://emailer.dotcal.com/multidouble.ice", $params) ;

function sendSubscription ($url,$params) {
$ch = curl_init ($url) ;
curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1) ;
curl_setopt ($ch, CURLOPT_POST, 1) ;
curl_setopt ($ch, CURLOPT_POSTFIELDS, $params) ;
$res = curl_exec ($ch) ;
curl_close ($ch) ;
return ($res) ;
}

 


 

Dropping From Lists
To remove someone from a Mailing List, all you have to do is include this XML in the Record data:
<Droplists>List3</Droplists>



Event Triggers
You can even add event triggers like this:

<Event1date>04/15/2002</Event1date>
<Event1listedition>somelist_youredition</Event1listedition>



Generate Subscribe Code  

By placing the HTML provided on the auto-subscribe page (under the Help tab; use the Website Signup Form wizard or any of the examples given) on your webpage, you can create an automatic signup box. Simply copy and paste the HTML in blue!

The name and company fields are optional. If you do not want to receive an email when someone signs up, don't add the 'notification' hidden form field.

If you want several people to receive emails when someone signs up, put a comma between the notification email addresses.

Note that page to generate the website signup form is a button from your Manage Email List (Contacts) page for any mailing list.

It may be easiest for you to start off using the Wizard (the button to start the Wizard is at the top of the Website Signup Form page).



The Interactive Tutorial  

Use the Help tab to find more information about how to use the dotCal mail system. In the sub-navigation on this screen, you will find a link to our interactive tutorial.

If you are new to dotCal mail, or would like to learn about more advanced capabilities of the dotCal mail software system, you can watch the tutorial. The entire tutorial takes about 30 minutes, but is separated into many chapters, including a short Getting Started section.




New List Who is in your list  

In the middle column of the "New List" screen, you define which contacts will be in the new mailing list you are creating. Here you have several options available to you:

 


 


How to integrate Impact Engine  

Impact Engine provides do-it-yourself templates to create Flash presentations for your dotCal mails. Once you have created your Flash presentation using Impact Engine's software, you can include it using this procedure:

Log into your Impact Engine Account & click on the "More Features" button. From there, click the "Create Signature File" button. This will generate a text code that, when copied & pasted into your dotCal mail, will display as a VIEW button linking recipients to your Impact Engine Presentation.


 

Exporting your contacts  

There are two ways to export your contacts, both export to a tab delimited text file.

1. Exporting your entire contact database – Select MasterCRM > Utilities > select Export. You also have the option on this same page to re-export your list using various filters, example: to export everyone in your database that has unsubscribed you can use the filter to re-export everyone that has "Unsubscribed" in the "Email Format" field.

2. Exporting a specific MailingList – From your Control Panel select "Contacts" under the MailingList > Export > select the fields you would like to export > select Export Now. You also have the option on this same page to export your MailingList contacts with the tracking included for pasts broadcasts sent to this list, this is done by selecting Yes under Include Stats?.

If you would like to convert the exported tab delimited text file into an Excel file this can be done from within the exported file by selecting File > Save As > finish by updating the file format field to reflect Excel.




No Read Tracking  

Possible Reasons:

1. Your Edition is a Text-Only message. Your Edition has to be HTML for any tracking of your Broadcast to occur.

2. You renamed your Edition AFTER you sent/broadcast it. Since tracking is tied to the Edition name, if that changes the system will not recognize any calls to the old name from your subscribers.

3. You deleted your Mailing List. Obvious but this is still asked. With your deleted Mailing List goes your Edition.

4. If there is no tracking for a specific subscriber, you may have them set to Text-Only or they have their graphics and/or hyperlinks turned off.



Import Email List From Palm Pilot  

Use HotSync to bring the contacts from your Palm III or your Palm Pilot with the Palm Desktop on your computer.

On the Palm Pilot, click the Address icon in the launch bar on the left edge of the window on your PC.

In the Address Book, select File, then Export.

Inside the "Export To File" dialog box, select the Export As... option to Tab Separated Values (*.tab;*txt).

Enter a file name (remember where you saved your file!), and click Export.

When the Specify Export Fields dialog box comes up, click OK without making any changes.

Import the file into Excel and follow the instructions for importing a list into dotCal mail from Excel.



Generate Website Profile Update  

Use this to allow recipients of your dotCal mails to update their profiles using a page on your website. Simply copy and paste the form you see here (on the Manage Email List - Auto-Subscribe page, and also under the Help tab) onto a page on your website to allow your users to check unsubscribe or manage their account profiles.

This form will send an email to the requestor, with a link that he or she can then click on to update their profile.



Viewing Master List of Contacts  

Use this screen in the Master CRM for a list view of all of your contacts.

When searching for contacts, enter any value into the "Search for" textbox and choose the field you would like to look in to find a match.

If you put an asterisk (*) in the Search textbox, it will look for ANY value. If you put a tilde (~) in the Search textbox, it will return results of all contacts that have a blank value in that field.



Import CRM Contacts Into Existing Mailing List  

In the Contacts screen for any mailing list, you can import contacts easily into your existing mailing list.

You can use this function to add contacts to your existing mailing list from the Master CRM. Choose any field as a criterion for selecting these contacts. If you want to select all contacts that have anything in a particular field, put a lone * (asterisk) in the text box.



ACT Synch Tool Errors  

The ACT! Synch tool is designed to be a robust way to keep your ACT! database in synch with your dotCal mail mailing lists.

We have found one instance of an issue that causes the synch tool to freeze or error out. If you are using CardScan or another automatic data input program, you may have some non-standard characters in your data. Take a look at the contact that is causing the program to freeze or generate the error and look for unrecognizable or graphical-looking characters. Remove them, and it should fix the problem.




Import Custom HTML Edition  

When you import an edition into dotCal mail using the "Import Your Own HTML file" template, you can either use the file upload (the "Browse" button) or the URL field to bring in your HTML file. dotCal mail tries to format the file as best as it can to be email spec compliant. It is always a good idea to test the email first before you send it out to a large group.

The footer that dotCal mail adds beneath your email (for the unsubscribe/profile update links and for the send-to-a-friend form) is by default left-justified. If you would like the footer centered, simply end your HTML file with an open <center> tag.

Pitfalls: just like the note says, do not use JavaScript. If you're going to use an ActiveX component (like Flash, Quicktime, or Windows Media) don't use the <object> tag; only use the <embed> tag. Use of <div> and <span> tags is also discouraged, as many email programs will improperly format those tags. These tags may also try to put layers in your HTML, which will move parts of your email around in ways you don't intend, since email clients render layers differently than web browsers. If in doubt, look at the Preview of your edition and send it to yourself in a test.

 


 

What are Hot Prospects  

Hot Prospects are an automatically-calculated way for you to determine the most interested recipients of your email campaigns. Each recipient is scored based on the number of reads, clicks, surveys, and send-to-friends. The total is then compared to the minimum score defined in your My Account - Update Account screen. Those that meet or exceed the minimum score are labeled as Hot Prospects.

Scoring:
Read = 1 point
Click = 3 points
Survey = 3 points
Send-to-Friend = 6 points



Embed Types  

Embedding multimedia is a single line of HTML code. You will see in the examples below, some options you can tweak to change how the multimedia is displayed:

  • Quicktime - <embed type="video/quicktime" src="your movie file here" controller="false" bgcolor="black" kioskmode="true" autoplay="true" loop="false" pluginspage="http://www.apple.com/quicktime/download/"></embed>
  • Real Media - <embed src="URL of your file here" autostart="true" controls="ImageWindow" console="one" width=200 height=150 type="audio/x-pn-realaudio-plugin"><br><embed type="audio/x-pn-realaudio-plugin" src="URL of your file here" WIDTH=200 HEIGHT=25 pluginspage="http://www.real.com/player/index.html" controls="ControlPanel" autostart="true" console=one nolabels=true NOJAVA="true"></embed>
  • Flash - <embed src="Insert URL of file here" quality=autohigh loop=false pluginspage="http://www.macromedia.com/shockwave/download/index.cgi?P1_Prod_Version=ShockwaveFlash" type="application/x-shockwave-flash"></embed>
  • Windows Media - <embed TYPE="application/x-mplayer2" pluginspage="http://www.microsoft.com/Windows/Downloads/Contents/Products/MediaPlayer/" src="URL of file goes here" Name="MediaPlayer" ShowControls="0" autostart="True"></embed>



How to E-Commerce-Enable Your Emails  

To e-commerce-enable your email, you must first have a web-enabled merchant account. Most banks offer this service, as well as third-party vendors like Authorize.net (www.authorizenet.com). You may also want to look into Paypal.

Web-based purchase forms usually work with HTML forms. Instructions for creating payment forms will be provided by your bank.



Fixing bad targets  

If the targets you are using are not working, there are a couple pitfalls to be aware of:

1. Make sure in the
<a href="#targetname"> tag, you do NOT put a target="x" switch in the tag.

2. Do not use a <base href="" target="x"> HTML tag anywhere in your email



 

Browsers and Caches  

Sometimes web browsers store the webpages you visit on your hard drive so they load faster. Since you will be constantly changing your content, you have to prevent your browser from doing this. If you're using Netscape, click "Edit - Preferences - Advanced - Cache" and click the radio button for "Document in cache is compared to document on network - Every Time". If you're on MSIE, click "Tools - Internet Options", and in the General toolbar, in "Temporary Internet Files" click the "Settings" box; make sure the "Check for newer versions of stored pages:" radio button is set to "Every visit to the page".



Why You Should Use Double and Not Single Opt Ins  

While convenient, single opt in forms offer no protection against unscrupulous individuals adding email addresses to your list that they do not own. This is because a single opt in form is not what is known as a "closed loop subscription." This means that there is no confirmation that the owner of the email address wants to be on the list in question. As a result, you may see spam complaints for which you have no valid opt-in record.

A double opt in form is a "closed loop subscription" and therefore is not spoofable, as it sends the owner an email requesting that they click on the included link to confirm their subscription.

 

We recommend you switch to a double opt in form and disable single opt in forms on the Update Account section of your account to prevent any access to these scripts for your user account.

 



Do Not Email Domains  

You can include a list of domains you do not want to send any emails to using the Update Account screen under the My Account tab. This Do Not Email Domains list is a comma-separated list of domains that will never be sent to. This is helpful if you want to exclude competitors or any groups of people that are not friendly to you.



Valid Subscription Form Domains  

For improved security, you can limit the domains that your website signup forms work with. This ensures that your website signup form is not copied to other websites and used without your permission.

Under the My Account - Update Account screen, you get define the valid domains where your website signup form may reside. If a request comes from an invalid domain, the user will see this message:

This subscription is not coming from a valid domain and can't be processed.

 



Outlook Plugin and Microsoft Exchange  

In order for the Outlook Plug-in to function properly when the Outlook client is being used with a Microsoft Exchange server it may be necessary to flag the Contacts folder as "off-line" prior to performing a contacts synchronization operation. When the Outlook Plug-in synchronization has finished, mark the Contacts folder as "on-line" and Exchange will synchronize with its contact database.

 




Redirect Host  

You may specify your own host name in all of your links by utilizing your own domain name for click through redirections. This is good from a "branding" perspective, as it projects a more professional image to your email recipients and it is also good from a deliverability stand point by ensuring that your redirection host has the same domain as the final destination.

Without using this feature a link in an email you send through dotCal mail may look like:

http://emailer.dotcal.com/go2.shtml

After properly setting up a redirect host, your links will look like this:

http://myhost.mydomain.com/go2.shtml

Note: the host "myhost.mydomain.com" will be replaced with what you've specified in the My Account screen.

Before you can specify a host name, you must first ensure that DNS has been properly setup. You must have your host configured in DNS with an "A" record of 67.207.220.41. If you do not know what an "A" record is, or do not have access to the name service records for your domain, you will need to contact the technical administrator of your domain.

 

 



Template Layouts  

Choose from any of the layouts available to you for each edition using the "Layout" link or the dropdown menu on the Edition Editor. Layouts with more than one column will tend to be wider.

Your banner, logo, page headline and intro paragraph are all placed in the "Header" seciton.



How to use a global suppression list  

You can use your own suppression list from another application to prevent yourself from using dotCal mail to send messages to people that have already opted out of receiving your messages. Simple upload a file into the Master CRM with the EmailFormat field set to "Unsubscribed". This will prevent anyone on this imported list from being contacted through your dotCal mail account.



Queued/0 in the Broadcast Progress  

If after you broadcast a campaign, you see a Queued/0 on the Send page, the most likely culprit is that your import file included invalid EmailFormat information. Re-import your master list so that the EmailFormat contains valid settings only.



GIF Images and Outlook 2007  

When using GIF images in your HTML emails, it is important that your GIFs be saved with a 256 color palette. If you use less than 256 colors (even if your GIF image has less than 256 colors in it), Outlook 2007 will render that image as a broken image (the dreaded red X).

 




Media Feature  

The Media Feature field allows you to add a special feature to your image, movie, or sound. This feature appears once you have uploaded something to the "Image or Multimedia" field just above it.

 


 

Multipart email  

A multipart email message is a specialized email message that delivers an HTML version to those recipients who can receive HTML emails and a text version to those who cannot.

 



Company Name  

Company Name is set on the List Settings page. All editions sent to this mailing list will be "From" this.

This is the name of the organization or person sending the email. It will appear in the 'From' field and at the bottom of the email.

 



Generate Referral Subscribe Code  

Under the Help tab, you can see where you generate your Website Signup Form and Referral Forms.

The HTML code shown on the auto-subscribe page allows people to refer others to your Mailing List. You can have up to 9 friends on a single form.

Like the other forms, you can change those checkboxes to
input type=hidden fields.

 



How to put HTML into FrontPage  

If you are using FrontPage to design a website signup form and are trying to copy and paste the website signup form or any other HTML into your FrontPage webpage, you have to use the "Paste Special" to do it.

First, copy (right-click, or Ctrl-C) the HTML source provided by dotCal mail. Then switch your Frontpage window and right-click where you want to place the HTML. A small dialog will open up when you right click - select "Paste Special" and then choose the radio button labeled "Treat as HTML".

This will display the form in the Normal View, HTML code in the HTML View, and the form as it is supposed to look when you view it in a browser window.

 


 

How to make links in text messages  

Making a link in a text message is a little different than in HTML messages, but it's very straightforward.

On a line by itself, but the link between < and > like this:

<http://www.somesite.com/somepage.html>


The WYSIWYG Editor allows you to add a target using the "S" button at the top of the interface. If you add a target, it will not be visible in the WYSIWYG Editor - only when you click on the "H" button to see the HTML. The target, although invisible on the editor, will still exist and to link to it, you can simply make that target a link like any other target link.

The target will look like this:
<a name="targetname">

The link to the target will look like:
<a href="#targetname">Click here to go to the target</a>


 


Recipients Receive Multiple Copies of Email  

One of my recipients claims to have received the email several times---is that even possible?

For each of your broadcasts, dotCal mail sends exactly one email to each of your recipients. If a recipient claims to have received an email more than once, it most likely a result of a faulty connection between his POP account and his providers mail server (usually the result of a slow or ineffective virus or spam filter) --- you can be confident though that you did not send the message more than once.

 


 


Preventing Tracking Of Links  

Preventing tracking of links is a very simple task. In the HTML in the body of your email, simply put the word "notrack" before the http or mailto:

<a href="notrackhttp://www.yoursite.com">

OR

<a href="notrackmailto:youremail@somesite.com">

This works with the dotCal mail templates, as well as if you import your own HTML email.

Important note: do not use "notrack" with targets. All targets must have something like this:
<a name="something"> to define them, and
<a href="#something">linked text</a> to link to that target

Tracking Options Query Strings  This feature, when turned on in the List Settings screen, will track click-throughs to URL's with query strings. If someone clicks on a link in your email to (example below):

 



SalesForce PlugIn: Logging In  

Enter your SalesForce username and password into the boxes provided within the Credentials area of the SalesForce PlugIn.

If you are having difficulty logging in, first double check the spelling and case of your username and password. Be aware, however, that SalesForce often requires that you use a security token appended to the end of your password.

To receive a new security token, log in to Salesforce at http://www.salesforce.com and click Setup | My Personal Information | Reset Security Token.

 

 



Incorrect image rendering in Outlook 2007  

Outlook 2007 does not support the use of background images in tables in HTML email. This means that any tables using the "background" function will not render an image in the background. Note that this applies to all table elements, table/tr/td tags are all affected. You cannot bypass this with CSS styles.

We are unsure as to the reasoning behind the Microsoft decision to not support these very basic HTML elements, and we are unable to determine whether or not this will be fixed.

 



Username Error  

Question: I keep getting the following error whenever I click on any button after I get logged in:"You must enter a valid username. Go back and fix it." Am I doing something wrong?

Answer: It has to do with the Internet Security Settings/Cookie Settings on your computer. If you can please check/modify your internet security/cookie settings so that your system allows "third-party cookies" (the setting is "medium" on IE), everything should work again. The other fix is to add emailer.dotcal.com as a "Trusted Zone" to IE. Bottom line, for security reasons, our system needs to verify that is actually you trying to get into the system before it will grant access to your data.

 



Website Tracking Hints  

If you are enabling website tracking with webtracks, be sure to do the following to ensure it works:

  • Use the root domain if you want to track everything coming in to a site. For example, if you want to track yoursite.com and www.yoursite.com, be sure to put BOTH domains in the webtracks Domains area of the webtracks page.
  • Make sure the javascript you post on every webpage looks exactly like it does in the instructions - do not insert any line breaks into that javascript.



 


Page Sub-headline  

This goes right below the Page Headline. It should be slightly more descriptive, but again is trying to encourage your readers to spend more time on this page.

 



Type of List  

This defines the type of list you would like this Mailing List to be - public, private, or hidden.

Public Public lists can be subscribed to by anyone that is a member of any other list.

Private lists can not be subscribed to without your permission. Recipients CAN unsubscribe themselves from these lists.

Hidden - hidden lists are lists that your recipients do not know they are on. The only way to unsubscribe from a hidden list is to unsubscribe from ALL of your lists.

The ability for a recipient to voluntarily add him/herself to another list is handled with the "update your account profile" link at the bottom of every email you send out.

The
Brief Description of This List is a short description that the recipient will see when reviewing the different lists available from you.

The
User-Update Fields are fields that you allow your recipients to update on their own.

The User field values are defined using the link on the Master List front page.




Import Email List From Outlook  

Click on the File menu and select "Import and Export". Choose "Export to a File", and click Next.

It will then ask you for a format - choose Tab Separated Values (Windows).

Then choose Contacts. You will then save the file someplace on your hard drive - make sure you remember where you saved it!

Once you save it, open the file up in Excel and change it so the fields line up with Column A for Name, Column B for Company, and Column C for Email. Follow instructions for importing from Excel from there.



Generate Double Optin Subscribe Code  

This signup box works similarly to the other auto-subscribe boxes. The difference is that an email is sent to the new subscriber, confirming that the person that filled out the form is at the email address supplied to you.

Double Opt-In is a more secure method of ensuring your subscribers actually signed up to be on your list (since anyone can access your auto-subscribe form on your website). Double Opt-In does require more work on the part of your subscribers (they have to click on a button provided in their email instead of the instant gratification of signing up through the website).

 



How to create trouble ticket or support request system  

You can create your own trouble ticketing / support request management system, and have it integrated into your dotCal mail account. Go to the Help tab, and click on the Website Signup Form page. There you will see instructions on how to create a form to put on your website for your clients to create support requests.

Support requests require the user to already be in your Master CRM. Their email address acts as the main index for tracking each support request.

 



Page Headline  

This is a big, bold statement that you will use to entice your readers to spend more time on the site.

 



Import Email List From Outlook Express  

In Outlook Express™, select "File" in the Menu Bar, then "Export", and then "Address Book".

When the Address Book Export Tool dialog box comes up, select the "Text File (Comma Separated Values)" option, and click the "Export" button.

In the CSV Export dialog box, enter a name for the export file (such as maillist.csv), and click "Browse" to save this file somewhere on your computer (remember where you saved it!), then click "Next".

Check the Name, Company, E-Mail Address boxes. Then click "Finish" to complete the export.

Then open the file up in Excel and follow the Excel instructions.


http://www.yoursite.com/somepage.cgi?
UserID=1234&Name=Mary

The bolded text above (everything after the question mark) is the query string. If the Query String option is off (default), dotCal mail tracks the click-thru as:

http://www.yoursite.com/somepage.cgi

By turning this feature on, dotCal mail will track the query strings in your clicked-through URL's. Turn this on using the Query Strings dropdown menu on the List Settings for each list that has editions which contain links with query strings.

 




Email Subject Line

This is the subject of the email, set in the Edition Editor. It's important to make your subject line something catchy, but not something that your users will think is just another piece of junk mail.

Make sure your subject line is relevant and that your subject line accurately reflects the intent and content of the email.

Also note that accented characters may not be used in subject lines.



How to remove cookies  

If you are having problems logging in and out of your sessions in dotCal mail, you may have some lingering cookie issues. At a minimum, make sure you use the "Log Out" tab and close any windows you may have opened during your session (particularly your stats or MasterCRM windows). If you are still having issues, you may have to close all your browser windows and log in again.

Just to be sure, you may also want to remove all the cookies from your web browser. You can do this in Internet Explorer through Tools - Internet Options - Delete Cookies. In Safari for the Mac, use Preference



Banner/Logo Link URL  

This URL is set in the Edition Editor. The Banner/Logo Link URL is the link that goes on your banner and logo. Every time someone clicks on your banner or your logo, it will open up a browser window and take them to this website address.

This link is also used in linking to your company's website in the footer of emails you send out.

You can upload your banner and/or logo using the List Settings screen.

 


 

Article Colors  

You define Article Colors while you are building your email edition in the Edition Editor.

These are colors that override the default settings specified in your Template. Note that on Netscape Messenger, the background color will not override a background texture that you chose in your Template Manager.

 



Edition Width

The width of your edition, chosen in the WYSIWYG Editor (the first selection when you choose your edition's Layout), is very important. You want your edition to be as NARROW as possible, for maximum readability.

Some email programs, particularly AOL Anywhere, have narrow email display windows. For maximum compatibility, keep your editions under 600 pixels wide. If you are sure your clients have higher-end systems (like most corporate systems), you can go with wider editions.

Like anything, test your editions on as many email programs as possible to make sure your edition looks good on as many recipients' computers as possible.



Master CRM will not open its pop-up window  

Some pop-up blockers may interfere with the dotCal mail interface. Be sure you allow popups for the domain that you see when you log in. Sometimes other pop-up blockers run in the background, such as the Yahoo! toolbar pop-up blocker. Be sure you check all of these and allow your login domain to pop-up windows.



Recipients with Eudora  

Users reading HTML emails in Eudora may need to adjust their viewing preferences in order to view images correctly. If pictures appear garbled, in Eudora suggest that your subscribers go to Tools > Options, select Viewing Mail and click to select "Use Microsoft's viewer."



Exclude List

Manage Email List - Import - Exclude List

Also known as a Suppression List or Suppression File, you can exclude a list of recipients from a single mailing list by importing a file of email addresses. This file must be a single column of email addresses, saved as a text file. Once imported, this exclusion list will remove each email address from the Mailing List you are working with.

Note this list must be a single column, where each email address is on its own line, with each line separated with a newline.

Also known as a Suppression List or Suppression File, you can exclude a list of recipients from a single mailing list by importing a file of email addresses. This file must be a single column of email addresses, saved as a textfile. Once imported, this exclusion list will remove each email address from the Mailing List you are working with.

Note this list must be a single column, where each email address is on its own line, with each line separated with a newline.



Playing Embedded Sound or Music in Outlook  

In its out-of-the-box configuration, Outlook 2003 will not play music or sound. This is because its "Security Zone" setting is by default set to "Restricted". If you would like to instruct your clients to be able to play music or sounds within an email, have them go to Tools - Options, the Security Tab, and change Security Zone to "Internet".

 



Dynamic Filter for Sections  

This row allows you to set a dynamic rule for the entire section. This section will only be sent to contacts that meet the criterion you set here.

To set a criterion for a CRM field having "any" value, simply put a period (.) in the text field.

 



Imported HTML Looks Different In Email Client  

Check your HTML source and make sure you are not linking to your style sheets via a .css file.

Example Of What
NOT To Have in Your HTML:

<link href="styles.css" rel="stylesheet" type="text/css">.

Embed all your style sheets into the top portion of your HTML before importing. Check with your web designer if you are not sure.



Line spacing issues with WYSIWYG Editor  

Web browsers will sometimes add extra line spaces when you are modifying your email with the WYSIWYG Editor. To avoid extra line spaces when you press the ENTER key, simply hold down the shift when you press enter. This will force it to be a single line space.



Export  

The "Export" or "Prepare to Send" screen is where you determine which edition you would like to send, and where you would like to send that edition. For testing purposes, it is a good idea to enter in your own email address here first to make sure the edition looks right on your email program. You can also add someone to your email list by sending an edition to someone not already on your list (a new subscriber).

When sending emails with the test "Send edition to only" field, you can enter multiple email addresses. Separate each recipient's address with a comma.



Suppression Lists  

When creating a supression list or External Opt-out list, do not remove these contacts from the MasterCRM. Instead they should be marked "Unsubscribed" under the EmailFormat so they will not be e-mailed to again.
It doesn't matter whether or not they're assigned to a mailing list or just in the MasterCRM, the important part is they're marked as Unsubscribed.
This is the ideal method rather than deleteing them from the account altogether.



How to reset bounces  

If you want to reset all of the bounces in a list, it's an easy process.

Go to the Manage Email List (Contacts) page for the mailing list you are working with. Click on "Clean List" (left side of screen). You will see various options there you can choose that help you clean your list. The button to Reset Bounces is there.

Clicking this button will convert all Bounced contacts to the default email format (multipart, text and HTML together).



Importing Text File into Excel  

dotCal mail exports text delimited files which can be easily imported into Microsoft Excel (or other similar application). Excel provides two mechanisms for importing text delimited data, which are outlined below.


Method 1:

  • Save text file to desktop
  • Open excel
  • From the "File" menu click on "Open"
  • On the file selection screen, change the "Files of type" menu to read "All Files"
  • Select text file from desktop
  • Follow import instructions

 Method 2:

  • Save text file to desktop
  • Open excel
  • Click on the "Data" menu
  • Click on the "Get External Data" sub menu
  • Select "Import Text File"
  • On the file selection screen, change the "Files of type" menu to read "All Files"
  • Select text file from desktop



Permissions  

Each user has a set list of permissions available for each database and table. For the database given to you when you signed up, you have complete access. You can restrict others' access to your database by clicking on the Modify This Table button.

Unsubscribed through ISP in CRM  

Some of your contacts may unsubscribe themselves through a method that originates from their recipient mail server's ISP. The most common ISP that allows this is AOL, which will send an email to our mail server when someone clicks the "Report this as Spam" button. Anyone that uses their ISP to send an unsubscribe email to our mail server will be automatically unsubscribed.

 



Merge Combine  

How to merge (or combine) mailing lists.

If you would like to "merge" (or combine) two or more mailing lists:

1. From the control panel, click on the "new list" button.

2 In the first column, choose a name for your new mailing list (e.g., "MergedList)

3. In the second column, indicate the lists you want to include in the merge lists

4. Create the new list.

5. (optional) After the new list has successfully been created, you can delete the original lists if you would like.





Forgot Password

In case you forgot your password, you can get a new "randomly" generated password by filling out this form. The new password will be sent to your email account within a minute of your request.


 

Footer Text  

Set in your Edition Editor, the text you put here goes at the very bottom of your page. A good way to close your reader's attention is to remind them of the central message of this page here.



Use Editor Version 2  

This setting controls whether your account is set to use the new WYSIWYG editor, or the old version.