Extension:Google Analytics Integration

MediaWiki extensions manual - list

Google Analytics Release status: stable
Implementation	User activity
Description	Automatically inserts Google Analytics tracking code at the bottom of MediaWiki pages
Author(s)	Tim Laquatalk
Last version	2.0.2 (2009-12-16)
MediaWiki	1.11+
License	GNU GPL, version 2 or later
Download	Download snapshot (Git master) Git [?]: repo summary tree code changes
Example	Wikimini (view page source at the bottom)
Parameters $wgGoogleAnalyticsAccount, $wgGoogleAnalyticsIgnoreSysops, $wgGoogleAnalyticsIgnoreBots, $wgGoogleAnalyticsAddASAC
Hooks used SkinAfterBottomScripts ParserAfterTidy
Check usage and version matrix

This extension inserts Google Analytics tracking code in every MediaWiki page that is viewed. The extension excludes pages being viewed by users with 'protect' privileges (sysops) and users with 'bot' privileges (bots) to prevent pollution of the statistics. To use a version that also ignores logged-in users, see the 'See also' section at the end of this page.

Download

You can download the extension directly from the MediaWiki source code repository (browse code). You can get:

One of the extensions tags

Not all extensions have tags. Some extensions have tags for each release, in which case those tags have the same stability as the release. To download a tag

• Go to the tags list
• Click the name of the tag you want to download
• Click "snapshot"

The latest version of one of the extensions branches

Each extension has a master branch containing the latest code (might be unstable). Extensions can have further branches as well.

• Go to the branches list
• Click the branch name
• Click "snapshot"

A snapshot made during the release of a MediaWiki version.

This might be unstable and is not guaranteed to work with the associated MediaWiki version.

• Download snapshot

After you've got the code, save it into the extensions/googleAnalytics directory of your wiki.

If you are familiar with git and have shell access to your server, you can obtain the extension, with all its tags and branches, as follows:

cd extensions
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/googleAnalytics.git

Installation

1. Create a new folder (directory) in the following location:
   wiki-install-folder/extensions/googleAnalytics
2. Download the extension from Git
3. Copy googleAnalytics.php and googleAnalytics.i18n.php in to the new googleAnalytics folder
   
4. Add the following line to your LocalSettings.php at the bottom:

require_once( "$IP/extensions/googleAnalytics/googleAnalytics.php" );

In the googleAnalytics folder, googleAnalytics.php you can find the following and edit as appropriate:

# Replace xxxxxxx-x with YOUR GoogleAnalytics UA number
$wgGoogleAnalyticsAccount = "UA-xxxxxxx-x";
 
# Optional Variables (both default to true)
$wgGoogleAnalyticsIgnoreSysops = false;
$wgGoogleAnalyticsIgnoreBots = false;
#If you use AdSense as well and have linked your accounts, to enable tracking set this to true
$wgGoogleAnalyticsAddASAC = false;

• NOTE: Backwards compatability has been removed - this extension now requires MediaWiki 1.11+
  For the last version supporting MW 1.10, see http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/googleAnalytics/?pathrev=29077
  • To see how to set the old version up, see an old version of this page.

Usage

1. Create a Google Analytics account
2. Locate your UA number
   • For the legacy code block, it can be found on the following line:

     _uacct="UA-xxxxxxx-x";
     

   • For the new ga.js code block, it can be found on the following line:

     var pageTracker = _gat._getTracker("UA-xxxxxxx-x");
     

3. Follow Installation Instructions
4. Google Analytics stats should start populating within 24-48 hours.

Bugs

• With PHP 5.3.2/5.3.3 on MediaWiki 1.16 or after use following fix. Your PHP version can be seen on the Special:Version page.

The error message before this fix is:

MediaWiki internal error. Exception caught inside exception handler.

• The googleAnalytics.php file will override your variables that were set in the LocalSettings.php file if you include it after you set these variables. It will appear to not work because you'll probably be logged in as a SysOp and it ignores you for the statistics by default. Solution: It should check the variables (isset)

See also

• Google Analytics - this same extension but also allows you to ignore logged in users (new variable is used, $wgGoogleAnalyticsIgnoreUsers). This is useful since if we want true visitors statistics, we want to ignore logged-in users who are often 'wiki-workers' and perhaps we dont want to include their stats since they could have lots of page views, like sysops.(If you use the "following fix" from Bugs (above), edit line 25 from your googleAnalytics.php.)
• User:Dantman/Analytics integration - Techniques on how to flexibly add analytics without using extensions.
• Extension:Open Web Analytics - Similar extension using Open Web Analytics.

Language:	English  • русский