UTM Quick-Install (IIS)
-
This article authored by EpikOne, an Urchin Software Authorized Consultant
The following is intended as a quick run-through on installing the UTM for websites running on a Microsoft IIS server on any Windows platform. For more detailed information on the UTM, please see the article entitled "Urchin Traffic Monitor (UTM)" found in this section.
Step 1: Copy UTM files to website document root. The files, urchin.js and __utm.gif are located in the "utils\utm" folder in the Urchin distribution. Copy these two files to the main folder of your website content. IMPORTANT: the GIF file starts with two underscore characters.
Step 2: Reference UTM in your website HTML. Enter the following line in all of your HTML pages. While it can go anywhere in the pages, we recommend putting it directly before the closing </body> tag. If you use a common include or template, you can enter it there.
<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 IIS logging. Open the IIS Manager and bring up the Properties window for your website. Make sure the logging is enabled and set to the W3C Extended format. Click the Properties button next to the format and under the Extended Properties Tab, check the box next to Cookie.
Step 4: Set Urchin Profile to use Urchin Traffic Monitor (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.