<%@LANGUAGE="VBSCRIPT"%> <% '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ' Spd E-Letter v4 ' © 2001, 2002 PensaWorks, inc. ' For help with this program, please visit http://www.pensaworks.com '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' %> <% if (request("faqid") <> "" AND IsNumeric(request("faqid"))) then faqid = cint(request("faqid")) else faqid = 0 %> Spd E-Letter FAQ's

<%if faqid = 0 then%> No FAQ Requested. <%elseif faqid = 1 then%> What is the Username?
<%elseif faqid = 2 then%> What does 'Admin Abilities' mean?
<%elseif faqid = 3 then%> What does 'Preference Abilities' mean?
<%elseif faqid = 4 then%> What does 'Broadcast Abilities' mean?
<%elseif faqid = 5 then%> What is the default List?
<%elseif faqid = 6 then%> How do I customize my broadcasts?
<%elseif faqid = 7 then%> What does 'List ID mean?
<%elseif faqid = 8 then%> What does 'List Name' mean?
<%elseif faqid = 9 then%> What does 'Public List' mean?
<%elseif faqid = 10 then%> What does 'Subscribers' mean?
<%elseif faqid = 11 then%> What does 'Subscribed Since' mean?
<%elseif faqid = 12 then%> What does 'Subscribed After' mean?
<%elseif faqid = 13 then%> What is the Version Number?
<%elseif faqid = 14 then%> What is the 'Root URL' ?
<%elseif faqid = 15 then%> What is the 'Action URL' ?
<%elseif faqid = 16 then%> What is the 'Redirect URL' ?
<%elseif faqid = 17 then%> What is the 'Refer URL' ?
<%elseif faqid = 18 then%> What does 'Navigation Bar' do?
<%elseif faqid = 19 then%> What does 'Remember Pass' do?
<%elseif faqid = 20 then%> What is the 'Default Email Address' ?
<%elseif faqid = 21 then%> What is 'Mailer Program' ?
<%elseif faqid = 22 then%> What is the 'mailer path' ?
<%elseif faqid = 23 then%> What is the 'port number' ?
<%elseif faqid = 24 then%> What is the 'Broadcast Number' ?
<%elseif faqid = 25 then%> What is 'X Subscribers per page' ?
<%elseif faqid = 26 then%> What is 'Footer HTML' ?
<%elseif faqid = 27 then%> What does 'Subscriber Email Address' mean?
<%elseif faqid = 28 then%> What does 'Subscriber Name' mean?
<%elseif faqid = 29 then%> What does 'Format' mean?
<%elseif faqid = 30 then%> What does 'Priority' mean?
<%elseif faqid = 31 then%> What does 'Clicks/Reads' mean?
<%elseif faqid = 32 then%> What is 'URL Tracking'?
<%elseif faqid = 33 then%> What are 'Automated Emails' ?
<%elseif faqid = 34 then%> What is the 'Footer HTML' ?
<%elseif faqid = 35 then%> What is 'Debug Mode' ?
<%elseif faqid = 36 then%> How do I enable the 'Automated Features' ?
<%elseif faqid = 37 then%> How are Newsletter Reads tracked ?
<%elseif faqid = 38 then%> What is 'Advanced Click Through Tracking' ?
<%elseif faqid = 39 then%> What is the 'Admin URL' ?
<%elseif faqid = 40 then%> What is the 'Read Tracking URL' ?
<%elseif faqid = 41 then%> What are 'Content Snippets' ?
<%elseif faqid = 42 then%> How do I use 'Content Snippets' ?
<%elseif faqid = 43 then%> What is the 'Snippet Code' ?
<%elseif faqid = 44 then%> What is the 'Snippet Name' ?
<%elseif faqid = 45 then%> How do I use the 'Mail Merge' features?
<% end if %>

<%if faqid = 0 then %> No FAQ Requested.

<%elseif faqid = 1 then %> The Username stores all the information about that particular Admin and determines which features they have access to. It is used during the login to validate a person's ability to access the Spd E-Letter and is also stored for other aspects of the program such as who broadcasted a specific message, who created a list, and more.

<%elseif faqid = 2 then %> Admin abilities is a special function of the program to secure certain sections from unwanted visitors or other Admins with limited capabilities. Admin abilities include access to the add other User's/Admins, Delete/Edit User's/Admins, and Add/Delete/Modify Lists sections of the program.

<%elseif faqid = 3 then%> Preference abilities is a special function of the program to secure certain sections from unwanted visitors or other Admins with limited capabilities. Preference abilities include access to change the mail server, mailer program, welcome email messages, unsubscribe email messages, List Name, and Default Email Address.

<%elseif faqid = 4 then%> Broadcast abilities is a special function of the program to secure certain sections from unwanted visitors or other Admins with limited capabilities. Broadcast abilities include access to compose a new E-Letter that is intended to reach one of the lists. "Broadcast" Admins are also able to delete send messages, as well as edit Pending Messages. This helps keep those who help you maintain the database that you don't want sending out emails. Can also be used so that all emails to be sent must be approved by the correct authority prior to being sent.

<%elseif faqid = 5 then%> After Version 1 of this program, the suggestion was made to add a "Default List" option. Whenever you add, view, delete subscribers, or compose and broadcast a message, the program asks which list you are going to make changes to and displays the results for the list you are currently moderating. In Version 1, if you deleted an email address the program would return back to the View/Delete Subscribers page but you had to manually change to the list you wanted to edit. Now by selecting your "Default List", the program now knows which list you want to modify automatically.

<%elseif faqid = 6 then%> The Spd E-Letter mailing list is designed with your subscribers in mind. For this reason, a number of customizable features have been included to help you maximize the effectiveness of each mass mailing you send with the Spd E-Letter. The options for customization are the same for every mailer type (CDO, STMP, JMail, etc.) and are explained in detail below. The commands draw on your database to insert information into each email. For the technically inclined - the commands link information from your database into the message relative to the subscriber's E-mail address. More information can be found for URL Tracking and Content Snippets here. For more information about mail merge with your own stored data, click here.

#Name# - This command inserts the name of a subscriber into the email message. The individual will see his or her name as it appears in your database everywhere the #Name# command is used.

#FirstName# - This command inserts the first name of a subscriber into the email message. We do this by simply pulling apart the subscribers name by spaces, and using the first word.

#Email# - This command will insert the subscriber's email address into the email message. Particularly useful at the bottom of any broadcast to allow the user to see which email address he or she has subscribed to your mailing list with in case the user maintains more than one active E-mail address.

#Subscribed# - This command will insert the date the subscriber was added to your mailing list.

#Unsubscribe# - This command will insert the hyper link to unsubscribe from your mailing list.

#Format# - This command will insert which version (Text or HTML) of your mailing list a user is subscribed to receive.

#Listname# - This command will insert the name of the list the person is subscribing/subscribed to.

#ShortDate# - This command will insert the current time, in VBShortDate Format (ex: <%=FormatDateTime(Now,vbShortDate)%>).

#LongDate# - This command will insert the current time, in VBLongDate Format (ex: <%=FormatDateTime(Now,vbLongDate)%>).

#SubscriberID# - This command will insert the ID Number assigned to the subscriber.

#TrackReads# - This tag is used in HTML newsletters to track how many people are reading it. This tag will be converted into a 1x1 pixel transparent gif. Retrieving this image from the server will track the number of times it has been read which is specific to subscriber and newsletter. Tracking the number of reads from Text emails less accurate but automatically done via the URL Click Through tracking if you use it. Read More.

Hints and Tips:

For beginners and advanced users of mailing list programs alike, here are a few hints and tips to be aware of when broadcasting messages to large audiences.

1) Always include the link to unsubscribe from your mailing list in every broadcast. There is nothing more aggravating than being anonymously subscribed to a newsletter that you do not wish to receive. We all know how easy it is to get a hold of someone's E-mail address and how trying it is when unsolicited mail shows up in your box with no way for you to put a stop to it.

2) Using the #Name# command in every greeting will help users feel that your message is personal and will increase the chances that they read each message instead of automatically deleting it with other "junk" mail. Keep in mind that the mailing list only serves the purpose of sending out information to all of your subscribers - keeping the messages personal will do wonders to draw your audience in.

3) Sometimes adding facts like which version a subscriber is receiving and how long they have been subscribed to your mailing list can also help to personalize each message even more. The #Format# and #Subscribed# commands allow you to do just that - keep your messages personal.

Further commands will come available with each revision of the Spd E-Letter. A new Read-Me file will also be distributed with each upgrade to make you aware of changes and additions to the program.

<%elseif faqid = 7 then%> The List ID is the autonumber assigned by the database. It helps keep track of which lists exist, its relationship to subscribers, and more. It is also used by the subscribe function to know which list the subscriber will be assigned to.

<%elseif faqid = 8 then%> The Listname is simply a text name given to an ID number to help better identify exactly which list is which. This can also be used as a personalization feature. Whenever you use #Listname# within the source of your text, it gets replaced by the actual name of the list they are subscribed or subscribing to.

<%elseif faqid = 9 then%> A public list is archived for the public to be able to view. If a list is made private then only an administrator can view it. Additionally, only Public lists are shown on the default subscribe form (mailinglist.asp) when called directly.

<%elseif faqid = 10 then%> This simply tells you how many email addresses are subscribed to the specified list.

<%elseif faqid = 11 then%> To help you keep better track of your lists, the database automatically inserts the date and time of when the person subscribed. This gives you the ability to use the "Subscribed Since" feature when sending out a newsletter and is available as a customization in sending out a newsletter. Inserting #Subscribed# into the source of a broadcasted newsletter will be replaced by the actual date and time the subscriber was added to that specific list.

<%elseif faqid = 12 then%> This will send the broadcast to the subscribers of a list after a predetermined amount of time. This is done in day units.

<%elseif faqid = 13 then%> The version number tells you the current version of Spd E-Letter currently in use.

<%elseif faqid = 14 then%> The Root URL is the main domain name where the list is being used, for example:
http://www.pensaworks.com

<%elseif faqid = 15 then%> The Action URL is the exact path of the mailinglist.asp file (that came in the program zip file) located on the server. This is needed for forms and other applications that interface with Spd-E Letter.

<%elseif faqid = 16 then%> The Redirect URL is used during the URL Tracking in the broadcast script. This value should be the full path to the redirect.asp file that is in the mailinglist folder on your site: ex: http://www.yourdomain.com/mailinglist/redirect.asp.

<%elseif faqid = 18 then%>The navigation bar function sets the default look for the administrator currently logged in.

<%elseif faqid = 19 then%> This sets whether your browser will remember the login to the mailing list administration.

<%elseif faqid = 20 then%> The default email address is the address where communications to the administrator of a list will be sent to.

<%elseif faqid = 21 then%> The mailer program is the program with which the server uses to send the broadcasted emails.

<%elseif faqid = 22 then%> The mailer path is the URL where the mailer program is located.

<%elseif faqid = 23 then%> The port number is the port that should be used for communicating with the mailer program, it defaults to 25. This is used by JMail when broadcasting.

<%elseif faqid = 24 then%> The broadcast number is how many emails to send in a single burst to avoid timeout issues.

<%elseif faqid = 25 then%> The number of subscribers per page controls how many individual subscribers are shown each page when editing or viewing a list.

<%elseif faqid = 26 then%> Footer HTML is the data that will be shown at the bottom left of every page in the Spd E-Letter Administration Section.

<%elseif faqid = 27 then%> This is simply the email address that the person chose to use to receive E-Letters from your mailing list.

<%elseif faqid = 28 then%> This is the name the subscriber entered to have their messages personalized. Whenever you send out a newsletter and use #Name# in any part of the text, it gets replaced with the name listed here.

<%elseif faqid = 29 then%> The Format that a subscriber chooses when they sign up is Text or HTML. Some email programs (such as AOL 5.0 and earlier) do not support HTML mail and when users receive it, all they see is a bunch of HTML code. This option allows a subscriber to choose whether they want the Text or HTML version of your newsletter. This can also be used as a personalization feature. Whenever you use #Format# within the source of your text, it inserts "Text" or "HTML" in its place.

<%elseif faqid = 30 then%> The Priority is a setting which is passed on to the mailer program. On some mail readers, an importance level can alert a user that a message is important and needs to be read as soon as possible. Most of the time the priority level is set to 3 (or Medium Importance) and the reader notices nothing different. It is recommended that you use a priority of 3, or medium importance for all of your newsletters.

<%elseif faqid = 31 then%> Ex: 5/23

The first part of this (5) is the number of URL's this subscriber has clicked on. This number is only accurate for the URL's of which you have used the 'URL Click Through Tracking'.

The Second part of this (23) is the number of times that this subscriber has read a Newsletter. This number is only accurate for emails of which you have used the 'Newsletter Read Tracking' on.


<%elseif faqid = 32 then%> [URL]http://www.domain.com[/URL] - The correct form for URL Tracking.

'URL Click Through Tracking' is a new feature in the Spd E-Letter. Now you have the ability to track any URLs that you would like to include with your newsletter removing the need for an ad tracking program outside of the Spd E-Letter. In any text message, simply enclose a URL in the special [URL], [/URL] tags like this:
    [URL]http://www.pensaworks.com[/URL]

In HTML newsletters, insert the URL tags inside of the link tags, like this:
    <a href="[URL]http://www.pensaworks.com[/URL]">Click Here</a>

The Spd E-Letter will take the above code, and modify it into a trackable one automatically when broadcasting a newsletter. See the reports to see how many clicks each link receives.

<%elseif faqid = 33 then%> Automated Emails are a new feature of Spd E-Letter v3.0. You can now specify a specific email to be sent out to a subscriber after they have been subscribed for a specific number of days. The potential of this is far reaching and not limited by any means. Say you integrate the Spd E-Letter into your shopping cart system. You setup a specific list and subscribe all those people who place an order to this list. You can then setup an 'Automated Email' to send them an email 14 days after their order asking them to fill out a customer service survey. Or maybe they purchase specific products that have warranties and you want to notify them a few weeks before the warranty becomes invalid. You can use this to send out a series of "Educational" material in a scheduled or sequenced manner.

In order to use the Automated Email feature, you must have an account setup with LiveTask. All new purchases of the Spd E-Letter come with a 2 month trial of LiveTask. You should receive your activation email after your purchase. If you did not receive this email, then please email support for your free trial. Please refer to the readme.html file that came with the Spd E-Letter for setup instructions.

<%elseif faqid = 34 then%> In an effort to give webmasters greater flexibility in customizing the Spd E-Letter, the "Footer HTML" has been implemented. This footer information will be presented on every page of the administration system at the bottom left. This special customization feature allows webmasters to add a "Powered By X Company" text or logo to each page and can be plain text, or HTML code.

<%elseif faqid = 35 then%> When Debug Mode is turned off, any errors that are encountered are ignored, the scripts move on, and the user never notices. Turning Debug Mode on is usually done by administrators when checking for errors in the program.

<%elseif faqid = 36 then%> To enable the 'Automated Features' of the Spd E-Letter, the "automated_tasks.asp" file located in the mailinglist/admin folder must be executed 4 times a day. This file checks for Automated Emails and Scheduled Broadcasts that need to be sent out.

The Spd E-Letter uses the LiveTask automation system to execute this file every 6 hours. There are other methods explained in the "readme.html" file found in the original download of this program, but LiveTask is the only supported method as it has many benefits over the other methods. You should have received a free 2 month membership with your purchase while you decide what method you want to use. For more information on how to set up the task on LiveTask, please refer to the readme.html file.

<%elseif faqid = 37 then%> Newsletter Read Tracking is a new feature in the Spd E-Letter and allows you to track exactly how many people are reading your newsletters. In order to use this feature, you must enable the 'Newsletter Read Tracking' from the site preferences by setting it to on. With this feature turned off, the total number of reads is stored per subscriber, no details. With this feature on, we can tell you exactly what Newsletters they have read, how many times, and when. The methods that used for tracking reads are different for Text & HTML subscribers.

HTML Newsletters: To track how many times each subscriber reads each newsletter, simply add in the custom tag of #TrackReads# where you want. When broadcasting the newsletter, the Spd E-Letter will turn this into a 1x1 pixel transparent gif. The code it generates will look like this: <img height=1 width=1 src="http://www.domain.com/mailinglist/read_tracking.asp?m=XX&i=YY">.

Text Newsletters: Since text newsletters do not offer the ability to add in images, an alternate approach has been taken and automatic so you do not need to use the custom tag used in the HTML Newsletter. In order to track reads from Text subscribers, you must use the URL Tracking in your newsletters. If a Text subscriber clicks on a Trackable URL, then they obviously have read at least a part of the newsletter. If 10 minutes have passed since a text subscriber clicked on a Trackable URL, the Spd E-Letter assumes that this is a new read and updates accordingly.

<%elseif faqid = 38 then%> Advanced Click Through Tracking is now an integrated part of the Spd E-Letter. With this feature turned off, the total number of clicks per subscriber is stored. There are no details, just a basic overall number. With the Advanced Click Through Tracking turned on, the exact links a subscriber clicks on are recorded, how many times, and when. This data is used in the detailed statistics that tell you which URLs are most popular in what Newsletters with which format and more.

<%elseif faqid = 39 then%> The 'Admin URL' is simply the exact URL to the mailinglist admin directory.

Ex:
http://www.domain.com/mailinglist/admin

<%elseif faqid = 40 then%> The 'Read Tracking URL' is the exact path to the file named read_tracking.asp found in the mailinglist root folder.

Ex:
http://www.domain.com/mailinglist/read_tracking.asp



<%elseif faqid = 41 then%> "Content Snippets" are a new feature in the Spd E-Letter v4.0. Think of them as a kind of 'Server Side Includes' that cannot be executed (so no ASP code). These snippets allow you to create content once in Text or HTML format, then use it over and over without having to retype the code or text for it every time.

An example would be for your advertisers. Perhaps 'Joe's Coffee Shop' contacts you and wants to advertise in your newsletter. You happily oblige and create an ad for them that will run for 3 months. You can now take the code for that ad, and create a 'snippet' out of it. From now on, you can simply include the custom tags for that snippet instead of having to remember the code for that ad. Change advertisers with ease without the annoyance of modifying your HTML code.

Perhaps you have a standard subscription form that you include inside all of your HTML newsletters. Now you can simply take that code, add it as a "Content Snippet" and then reference it by it's new tag. The same logic can be applied to copyrights, slogans, headers or footers. Save it once, and use it as many times as you need.

For an explanation on using Content Snippets in your newsletters, click here.

<%elseif faqid = 42 then%> [snip]Snippet Code[/snip] - The correct format for using Content Snippets.

"Content Snippets" are used in a manner very similar to the URL Tracking. To use a snippet, simply start out with the tag [snip]. Then type in the "Snippet Code" that you used when creating the snippet. Follow it up by the closing snippet tag [/snip]. For example: if you create a content snippet and give it a code of "Ad_Joes_Coffee", then you would include that snippet in your newsletter by adding in the following code:

[snip]Ad_Joes_Coffee[/snip]

<%elseif faqid = 43 then%> The Snippet Code is a unique identifying value assigned by you when creating a snippet. This code is the value you use when including snippets in your newsletters and allows for much easier recall that using an ID Number. Naming conventions can be applied to these codes for easier organization [ex: Ads begin with 'Ad_', Templates begin with 'Template_', etc].

For an explanation on using Content Snippets in your newsletters, click here.

<%elseif faqid = 44 then%> The Snippet Name is much like the Snippet Code, but allows you to simply assign a name you want so you can easily remember or recall a snippet and what it's content is.

<%elseif faqid = 45 then%> The Spd E-Letter now has unlimited customization with complete mail merge capabilities for all of your data. You can store any data that you want for each subscribers by creating your own registration forms and then use that data in all of your broadcasts when needed. For a list of standard tags, click here. To use the mail merge capabilities, simply enclose the field name (used by the database) inside the # characters. Example:

#FieldName#

Here is a complete list of additional customization tags you can use (taken in real time from your database).

<% extraFields = 0 set showFields = mlConn.Execute("SELECT * FROM ML_Subscribers") if showFields.EOF then %> You mush have at least one (1) subscriber in order to see the additional customization tags.
<% else for each item in showFields.fields itemName = lcase(item.name) if itemName <> "subscriberid" AND itemName <> "name" AND itemName <> "subscribeddate" AND itemName <> "email" AND itemName <> "format" AND itemName <> "listid" AND itemName <> "numclicks" AND itemName <> "numreads" AND itemName <> "numbounces" AND itemName <> "numreplies" AND itemName <> "subremoved" AND itemName <> "subremoveddate" AND itemName <> "submessageid" then extraFields = extraFields + 1 %> <%=extraFields%>.)  #<%=item.name%>#
<% end if next end if if extraFields = 0 then %> Your have no additonal customization fields <% end if %>


<% end if %>

Close Window