UTM Quick-Install (Apache)
This article authored by Panalysis, an Urchin Software Authorized Consultant
The following is intended as a quick run-through on installing the UTM for websites running on an Apache server on all platforms.
Step 1: Copy UTM files to website document root. The files, urchin.js and __utm.gif are located in the "util/utm" directory in the Urchin distribution. Copy these two files to the main directory of your website content.
Step 2: Reference UTM in your HTML. Enter the following line in all of your HTML pages. While it can go anywhere in the pages, we recommend putting it in the <head> section. If you use a common include or template, you can enter it there. IMPORTANT: the GIF filename begins with two underscores.
<script src="/urchin.js" type="text/javascript"></script>
<script type="text/javascript">
urchinTracker();
</script>
If you are using a package like "HTML Tidy", you may want to include the Javascript line in the HEAD area of your page, for instance:
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<script src="/urchin.js" type="text/javascript"></script>
<script type="text/javascript">
urchinTracker();
</script>
...
</head>
Step 3: Enable cookies in your Apache logging. If not already enabled, you can use the following httpd.conf example to enable cookie logging:
LogFormat "%h %v %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" \"%{Cookie}i\"" urchin
...
<VirtualHost 63.212.171.6>
ServerName www.mysite.com
DocumentRoot /www/www.mysite.com
CustomLog /var/logs/mysite.log urchin
</VirtualHost>
Step 4: Set Urchin Profile to use UTM. In the Urchin Administration interface, edit the profile in question and click on the Settings tab. Set the Visitor Tracking Method to Urchin Traffic Monitor (UTM). Set the UTM Domain to the address of your website without the www. Then choose default for the Report Set and click the Update button. That's it! Your website will now begin logging UTM data into your normal log file which will be identified the next time you run Urchin.
Is it working? To see if the UTM is successfully making entries to your log file, examine the log after you have installed the UTM and clicked on a few pages of the site. You should see an entry similar to the following at the end of the log file:
... "GET /__utm.gif?..." 200 ..."__utma=..."
If you don't see the __utma entries, be sure to check that cookies was enabled in the logging properly. If the status code is not 200 then check to make sure the files were properly copied to your document root.