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