Redmine

h1. Google Analytics Plugin

A plugin to insert the Google Analytics tracking code into Redmine based on user roles.

h2. Features

Adds your Google Analytics code to every pageview depending on your User roles; Anonymous user, Authenticated User, and Administrator.

h2. Screenshot:

!google_analytics_plugin_thumb.png!:/attachments/995/google_analytics_plugin.png

h2. Installation and Setup

# Download the plugin.  There are three supported ways:

#* Downloading the latest archive file from "Little Stream Software projects":https://projects.littlestreamsoftware.com/projects/list_files/redmine-analytics

#* Checkout the source from Git

       @git clone git://github.com/edavis10/redmine-google-analytics-plugin.git vendor/plugins/google_analytics_plugin@

#* Install it using Rail's plugin installer

       @script/plugin install git://github.com/edavis10/redmine-google-analytics-plugin.git@

# Login to your Redmine install as an Administrator.

# Configure your settings in Administration > Plugins > Configure

h2. News

"0.1.0 Release Announcement":http://theadmin.org/articles/2008/10/1/redmine-google-analytics-plugin

"0.2.0 Release Announcement":https://projects.littlestreamsoftware.com/news/49

h2. Hints and Tips

h3. Tracking Logged In Users

You may add logged in user name using __setCustomVar_ call just before __trackPageview_. Following Google Analytics code examples store user name in visitor-level slot !#1 named 'Login'. They were tested on Redmine 0.9.3.

* "traditional code":http://code.google.com/apis/analytics/docs/tracking/gaTrackingOverview.html#standardSetup:<pre>

...

pageTracker._setCustomVar(1, 'Login', document.getElementById('loggedas') != null

  ? document.getElementById('loggedas').childNodes[1].textContent : '(anonymous)', 1);

pageTracker._trackPageview();

...

</pre>

* "asynchronous code":http://code.google.com/apis/analytics/docs/tracking/asyncTracking.html: <pre>

...

_gaq.push(['_setCustomVar', 1, 'Login', document.getElementById('loggedas') != null

  ? document.getElementById('loggedas').childNodes[1].textContent : '(anonymous)', 1]);

_gaq.push(['_trackPageview']);

...

</pre>

Results will be available in "Visitors" -> "Custom Variables" -> "Login" report.

h3. Tracking Redmine Search Queries

Follow appropriate "Google Analytics Guide":http://www.google.com/support/analytics/bin/answer.py?hl=en&answer=75817 and use "q" (without quotes) as "Query Parameter". Results will be available in "Content" -> "Site Search" reports.