Changed author
[project/google_analytics.git] / README.txt
CommitLineData
8afc0408 1// $Id$
2
3Module: Google Analytics
4Author: Mike Carter <www.ixis.co.uk/contact>
5
6
7Description
8===========
9Adds the Google Analytics tracking system to your website.
10
11Requirements
12============
13
14* Google Analytics user account
15
16
17Installation
18============
19* Copy the 'googleanalytics' module directory in to your Drupal
20sites/all/modules directory as usual.
21
22
23Usage
24=====
25In the settings page enter your Google Analytics account number.
26
27You can also track the username and/or user ID who visits each page.
28This data will be visible in Google Analytics as segmentation data.
29If you enable the profile.module you can also add more detailed
30information about each user to the segmentation tracking.
31
32All pages will now have the required JavaScript added to the
33HTML footer can confirm this by viewing the page source from
34your browser.
35
36New approach to page tracking in 5.x-1.5 and 6.x-1.1
37====================================================
38With 5.x-1.5 and 6.x-1.1 there are new settings on the settings page at
39admin/settings/googleanalytics. The "Page specific tracking" area now
40comes with an interface that copies Drupal's block visibility settings.
41
42The default is set to "Add to every page except the listed pages". By
43default the following pages are listed for exclusion:
44
45admin
46admin/*
47user/*/*
48node/add*
49node/*/*
50
51These defaults are changeable by the website administrator or any other
52user with 'administer google analytics' permission.
53
54Like the blocks visibility settings in Drupal core, there is now a
55choice for "Add if the following PHP code returns TRUE." Sample PHP snippets
56that can be used in this textarea can be found on the handbook page
57"Overview-approach to block visibility" at http://drupal.org/node/64135.
58
59A code snippet that creates opt-out by role functionality for unchecked roles
60can be found in the Google Analytics handbook at http://drupal.org/node/261997.
61
62Advanced Settings
63=================
64You can include additional JavaScript snippets in the custom javascript
65code textarea. These can be found on the official Google Analytics pages
66and a few examples at http://drupal.org/node/248699. Support is not
67provided for any customisations you include.
68
69To speed up page loading you may also cache the Analytics ga.js
70file locally. You need to make sure the site file system is in public
71download mode.