SUNScholar/Google/Analytics/External

BACK TO GOOGLE ANALYTICS

Requirements

You need to create a Google Analytics account so that you can obtain a Google Analytics key.

See: https://www.google.com/analytics

Enable external update of Google Analytics data

Edit the following file:

nano $HOME/source/dspace/config/dspace.cfg

Search for the following:

xmlui.google.analytics.key

Enter your google analytics key.

See example below.

# If you would like to use Google Analytics to track general website statistics then
# use the following parameter to provide your Analytics key. First sign up for an
# account at http://analytics.google.com, then create an entry for your repository
# website. Analytics will give you a snipet of JavaScript code to place on your site,
# inside that snipet is your Google Analytics key usually found in this line:
# _uacct = "UA-XXXXXXX-X"
# Take this key (just the UA-XXXXXX-X part) and place it here in this parameter.
xmlui.google.analytics.key=UA-13284371-1

Using Piwik

An alternative is to use your own Piwik statistics server. See: http://piwik.org. Our campus server is available at: http://piwik.sun.ac.za. The administrator setup an account for us and added http://scholar.sun.ac.za as a service.

Please note

1. Google analytics must be enabled in the dspace.cfg file. Just use a fictitious code number.
2. You must comment out the google analytics JavaScript code in the file and paste in the Piwik JavaScript code in it's place.

We were sent the following javascript code snippet and added/merged it into the following XSL stylesheet file:
$HOME/source/dspace/modules/xmlui/src/main/webapp/themes/Mirage-SUNScholar/lib/xsl/core/page-structure.xsl

        <!-- Add a google analytics script if the key is present
        <xsl:if test="/dri:document/dri:meta/dri:pageMeta/dri:metadata[@element='google'][@qualifier='analytics']">
            <script type="text/javascript"><xsl:text>
                   var _gaq = _gaq || [];
                   _gaq.push(['_setAccount', '</xsl:text><xsl:value-of select="/dri:document/dri:meta/dri:pageMeta/dri:metadata[@element='google'][@qualifier='analytics']"/><xsl:text>']);
                   _gaq.push(['_trackPageview']);

                   (function() {
                       var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
                       ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
                       var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
                   })();
           </xsl:text></script>
        </xsl:if>
	-->

	<!-- Piwik W Klapwijk 2012-01 -->
        <xsl:if test="/dri:document/dri:meta/dri:pageMeta/dri:metadata[@element='google'][@qualifier='analytics']">
	     <script type="text/javascript">
        	 <xsl:text>var pkBaseURL = (("https:" == document.location.protocol) ? "https://piwik.sun.ac.za/" : "http://piwik.sun.ac.za/");</xsl:text>
	         <xsl:text>document.write(unescape("%3Cscript src='" + pkBaseURL + "piwik.js' type='text/javascript'%3E%3C/script%3E"));</xsl:text>
	     </script>
 
	<script type="text/javascript">
	    <xsl:text>
	     try {
	       </xsl:text>
	       <xsl:text>var piwikTracker = Piwik.getTracker(pkBaseURL + "piwik.php", 3); </xsl:text>
	       <xsl:text>piwikTracker.trackPageView();</xsl:text>
	       <xsl:text>piwikTracker.enableLinkTracking();</xsl:text>
	       <xsl:text>
	     }
     	catch( err ) {
	     }
	       </xsl:text>
	</script>
        </xsl:if>