Difference between revisions of "SUNScholar/Google/Analytics"

From Libopedia
Jump to navigation Jump to search
m
m
 
(14 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
<center>
 
<center>
  '''[[SUNScholar/Google|Back to Google]]'''
+
  '''[[SUNScholar/Google|BACK TO GOOGLE]]'''
 +
'''[[SUNScholar/Statistics|BACK TO STATISTICS]]'''
 
</center>
 
</center>
  
==Using Google Analytics==
+
==Introduction==
Open your main DSpace config file and look for:
+
There are now two steps/options to enabling Google Analytics.
'''xmlui.google.analytics.key'''
 
Enter your google analytics key.
 
  
==Using Piwik==
+
First you have to update the external GA database, then you have to configure DSpace to read data from the external database.
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.
+
==Step 1 - [[SUNScholar/Google/Analytics/External|Update external GA database]]==
 
+
==Step 2 - [[SUNScholar/Google_Analytics|Enable internal GA reporting]]==
We were sent the following javascript code snippet to add to the XSL stylesheet file:<br> '''<tt>/home/dspace/source/dspace/modules/xmlui/src/main/webapp/themes/Mirage-SUNScholar/lib/xsl/core/page-structure.xsl'''
+
[[Category:Customisation]]
<pre>
+
[[Category:Operations]]
        <!-- 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>
 
</pre>
 
 
 
;Please note
 
#Google analytics must be enabled in the '''dspace.cfg''' file. Just use a fictitious code number.
 
#You must comment out the google analytics JavaScript code in the file and paste in the Piwik JavaScript code in it's place.
 
==References==
 
*https://wiki.duraspace.org/display/DSDOC4x/XMLUI+Configuration+and+Customization
 
*https://wiki.duraspace.org/display/DSDOC3x/XMLUI+Configuration+and+Customization
 
*https://wiki.duraspace.org/display/DSDOC18/Configuration#Configuration-XMLUISpecificConfiguration
 

Latest revision as of 16:08, 29 May 2016

BACK TO GOOGLE
BACK TO STATISTICS

Introduction

There are now two steps/options to enabling Google Analytics.

First you have to update the external GA database, then you have to configure DSpace to read data from the external database.

Step 1 - Update external GA database

Step 2 - Enable internal GA reporting