Clickthrough Tracking - clickthrough_tracking.cgi

clickthrough_tracking.cgi gives you the ability to track:


Obtaining The Program

The Click Through Tracking plugin is a part of the Magicbook, and can be found in the Magicbook distribution in the, plugins directory.


Installing clickthrough_tracking.cgi

clickthrough_tracking.cgi should be installed into your dada/plugins directory. Upload the script and change it's permissions to 755.

Add this entry to the $ADMIN_MENU array ref:

         {-Title          => 'Clickthrough Tracking', 
          -Title_URL      => $PLUGIN_URL."/clickthrough_tracking.cgi",
          -Function       => 'clickthrough_tracking',
          -Activated      => 1, 
          },

It's possible that this has already been added to $ADMIN_MENU and all you would need to do is uncomment this entry.


Using clickthrough_tracking.cgi

Creating clickthrough tracking links

Clickthrough tracking works by passing the URL you want to track to a script that keeps track of what URL gets clicked when, then redirecting the user to the real URL.

To use the clickthrough tracking capabilities, first visit clickthrough_tracking.cgi in your web browser and check, Enable Clickthrough Tracking

When you write a list message use the special [redirect] tag, instead of just a URL:

Instead of:

        http://yahoo.com

Write:

    [redirect=http://yahoo.com]

If you're are writing an HTML message,

Instead of:

        <a href="http://yahoo.com">http://yahoo.com</a>;

Write:

        <a href="[redirect=http://yahoo.com]">http://yahoo.com</a>;

Make sure:

Using Open Messages Logging

Be sure to check, Enable Open Messages Logging

Please understand what this feature does - and does not do.

When this option is checked, Dada Mail will track each time an email message is opened by a mail reader as long as:

Even if all these conditions are met, opens may not be logged correctly. Saying all this, you should not use this feature as a hard statistical number, but rather as a sort of barometer of how many people may be reading your message.

Viewing the message in Dada Mail's own archives will not be tracked.

The Open Message Logger only logs:

The Open Message Logger DOES NOT log:

We find the extremely important that no personal information is tracked. It's not something we'd personally want tracked if we were to be a subscriber to a mailing list.

To clarify how the message opener works, Dada Mail inserts a small image into the source of your HTML message. It looks something like this:

 <!--open_img-->
 <img src="example.com/cgi-bin/dada/mail.cgi/spacer_image/listshortname/1234/spacer.png" />
 <!--/open_img-->

Where, listshortname is your List Short Name and, 1234 is the Message-ID.

In our testing using SpamAssassin, this does not raise any flags with its mail filters, but please run your own tests to make sure that your subscribers will still receive your messages.

Using Subscriber Count Logging

Check, Enable Subscriber Count Logging

That's it! Nothing more has to be done.

Using ``Hard'' email Bounces Logging

If you have the, Mystery Girl Bounce Handler installed, just check,

Enable Bounce Logging

To clarify what this tells you - a brief tutorial on how messages are bounced:

There are roughly two different types of bounced messages: ``soft'' bounces - bounces that happen because a mailbox is full, or there's some sort of problem with mail delivery and, ``hard'' bounces - bounces because the subscriber's mail box just doesn't exist.

In the context of this tracker, only bounce emails that cause the Mystery Girl bounce handler to remove the address from the subscription list are counted.

This means, you may receive 100 bounces from your list, but only 10 that will be unsubscribed. Ten bounces will be shown to you when you view the logs.


Viewing Clickthrough Information

After a mailing list message has been sent out, the reports may be viewed by visiting clickthrough_tracking.cgi in your browser.


FAQ


COPYRIGHT

Copyright (c) 1999 - 2005

Justin Simoni

http://justinsimoni.com

All rights reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.