GoogleAnalyticsPlugin < System

You are here: Foswiki>System Web>GoogleAnalyticsPlugin (28 Aug 2009, ProjectContributor) (raw view)EditAttach
---+!! Google Analytics Plugin
Adds Google Analytics javascript code to specified pages.

%TWISTY{
mode="div"
class="foswikiNotification"
showlink="&#9658; Changes in version 2.1..."
hidelink="&#9660; Close info"
remember="on"
firststart="show"
}%
Since version 2.1, this plugin reads settings from [[%SCRIPTURL{configure}%/#GoogleAnalyticsPlugin$Extensions][configure]]. It no longer uses a specific template or skin.

You now have the control which pages to track:
   * for specific users
      * for instance, do not track your own visits
   * for specific webs
      * for instance, do not track visits to System and Trash web
   * for bin scripts
      * for instance, do not track =login= pages

*If you are using a version of this plugin older than 2.1:* if you don't change anything, the plugin will continue to work as it did:
   * The previous setting =GOOGLESITEKEY= will be used as long as the new setting ={WebPropertyId}= in configure is not set
   * The skin setting =googleanalytics= will be ignored
%ENDTWISTY%

%TOC%

---++ About Google Analytics
[[http://www.google.com/analytics/][Google Analytics]] is a free statistics tool to track website visitors. While this service is especially meant to measure the effectiveness of !AdWords, it can be used for any site.

Google presents visitor data in a visually rich dashboard: %BR%
<a href="%ATTACHURLPATH%/Google_Analytics_Dashboard.png"><img style="margin:.5em 0; padding:4px; border:1px solid #ddd;" src="%ATTACHURLPATH%/Google_Analytics_Dashboard_small.gif" alt="Screenshot of Google Analytics application" width='501' height='400' /></a> %BR%
[[%ATTACHURLPATH%/Google_Analytics_Dashboard.png][view large image]]

---++ Settings
After installation, configure this plugin by changing settings in [[%SCRIPTURL{configure}%/#GoogleAnalyticsPlugin$Extensions][configure]].

---+++ Site ID
Google provides its users with a piece of html to copy-paste into pages. For this plugin you don't need that html, but the "Web Property ID" only. Enter this ID at ={WebPropertyId}=.

---+++ Tracking per web
Enable tracking with ={Tracking}{Enable}{Webs}=.
   * Enter =*= to track visits to topics in all webs (default value).
   * Enter specific web names to limit tracking to these webs only.

Disable tracking with ={Tracking}{Disable}{Webs}=.
   * Enter '' (nothing) to not disable tracking in any web (default value).
   * Enter specific web names to not track visits to these webs.

---+++ Tracking per user
Enable tracking with ={Tracking}{Enable}{Users}=.
   * Enter =*= to track visits by all users (default value).
   * Enter specific user (Wiki) names to limit tracking the visits by these users only.

Disable tracking with ={Tracking}{Disable}{Users}=.
   * Enter '' (nothing) to not disable tracking of any user (default value).
   * Enter specific user names to not track visits from these users.

---+++ Tracking per script
Enable tracking with ={Tracking}{Enable}{Scripts}=.
   * Enter =*= to track visits to topics from all scripts (default value).
   * Enter specific script names to limit tracking from these scripts only.

---++ Plugin Installation Instructions
You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server.

Open configure, and open the "Extensions" section. Use "Find More Extensions" to get a list of available extensions. Select "Install".

If you have any problems, or if the extension isn't available in =configure=, then you can still install manually from the command-line. See http://foswiki.org/Support/ManuallyInstallingExtensions for more help.

---++ Plugin Info

|  Authors: | Foswiki:Main.ArthurClemens |
|  Copyright &copy;: | 2006,2009 Arthur Clemens, 2009 Will Norris |
|  License: | [[http://www.gnu.org/copyleft/gpl.html][GPL]] |
|  Version: | 4729 |
|  Release: | 2.1.1 |
|  Change History: | <!-- versions below in reverse order -->&nbsp; |
|  27 Aug 2009 | 2.1 Arthur Clemens: Moved settings to configure. No longer uses a skin template. Tracking can be specified per web, user and script. |
|  26 Feb 2009 | 2.0.1 converted to skin template, increased apparent page rendering speed (Foswiki:Main.WillNorris) |
|  25 Feb 2009 | 2.0.0 Ported to ga.js (Foswiki:Main.WillNorris) |
|  24 Feb 2009 | 1.001 Ported to Foswiki (Foswiki:Main.WillNorris) |
|  21 Sep 2006 | 1.0.0 First Version |
|  Foswiki Dependency: | $Foswiki::Plugins::VERSION 2.0 |
|  CPAN Dependencies: | none |
|  Other Dependencies: | none |
|  Perl Version: | 5.005 |
|  Home: | http://foswiki.org/Extensions/%TOPIC% |
|  Support: | http://foswiki.org/Support/%TOPIC% |
|  Feedback: | http://foswiki.org/Extensions/%TOPIC%Dev |

__Related Topics:__ %SYSTEMWEB%.DefaultPreferences, %USERSWEB%.SitePreferences
Topic revision: r1 - 28 Aug 2009, ProjectContributor
System
Copyright © by the contributing authors. All material on this site is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback