collective.gacontext 0.2.1

Abstract

Add Google Analytics context dependent to your Plone Site

Introduction

Google Analytics can cope with different URLs of a site, e.g. with http://plone.org and http://plone.org/products. So if you have a hierarchical structure of your site and you want to analyze it with Google Analytics, you need different ga-code-snippets per URL. With this package you can handle it.

Usage

There is a formlib form registered on the interface collective.gacontext.interfaces.IGAContextMarker. Each context which is marked with that Interface becomes Google Analytics aware. A new object tab is displayed where you can edit a ga-code-snippet.

A viewlet, registered for PortalFooter, will find the responsible code snippet for it. It calls a utility which walks the acquisition chain up for the next object which provides the IGAContextMarker Interface and returns its code snippet (if there is one set).

Example:

• http://plone.org is marked with IGAContextMarker and has the following ga code:

  <script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
  </script>
  <script type="text/javascript">
  _uacct = "UA-00000-0";
  urchinTracker();
  </script>

• http://plone.org/events will find the same code snippet:

  <script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
  </script>
  <script type="text/javascript">
  _uacct = "UA-00000-0";
  urchinTracker();
  </script>

• If http://plone.org/events/conferences is marked with a IGAContextMarker and has the following ga code:

  <script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
  </script>
  <script type="text/javascript">
  _uacct = "UA-99999-9";
  urchinTracker();
  </script>

• Then http://plone.org/events/conferences/2008-location-tbd will find the code snippet from http://plone.org/events/conferences:

  <script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
  </script>
  <script type="text/javascript">
  _uacct = "UA-99999-9";
  urchinTracker();
  </script>

vim: set ft=rst tw=75 nocin nosi ai sw=4 ts=4 expandtab spell spelllang=en: