Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

...

Warning
titleGoogle Analytics API 2.3 Deprecated

The v2.3 API has been deprecated (see

Jira Legacy
serverJIRA (farcry.jira.com)
serverId7fe4aa00-e41b-37fc-85eb-78a6ea9adfbe
keyGA-4
). It is highly recommended you upgrade to the latest GA plugin which supports the v3.0 API.

Excerpt

Provides close integration for FarCry projects with the Google Analytics service v2.3 (warning: API deprecated)

Tip
titleLatest Release Google Analytics 2.0.0 (as at 21-Nov-2011)

Latest milestone build: milestone-2-0-0
SVN: https://farcry.jira.com/svn/GA/tags/milestone-2-0-0/
ZIP: https://farcry.jira.com/source/browse/~tarball=zip/GA/tags/milestone-2-0-0/milestone-2-0-0.zip
Certified for versions of 6.0.15+

Features include:

  • webtop overview integration; showing stats for individual pages directly in the webtop
  • support for downloads and external link reporting
  • a framework for tracking Google custom variables
  • popular content publishing rule

...

Screengrabs

Image Removed
Image Removed

Gallery

Installation

Checkout from source control

Code Block

svn checkout https://farcry.jira.com/svn/GA/trunk
to
./farcry/plugins/googleAnalytics

...

Copy the "www" folder to a "googleanalytics" folder under your project's webroot or create a web server alias (virtual directory on IIS) as "/googleanalytics" pointed at the plugin's www folder.

Update project constructor

Add googleAnalytics to the plugin list within ./www/farcryConstructor.cfm

Code Block
title./www/farcryConstructor.cfm

<!---// set plugin list--->
<cfset THIS.plugins = "farcrycms,googleMaps,googleAnalytics,farcrydoc" />

Deploy content types

Go into the webtop ADMIN > DEVELOPER TOOLS and deploy all the plugin content types.

Update Google Analytics configuration file

You will need to update the plugins configuration to include your projects specific Google Analytics URCHIN code.

Add GA custom tag to views

You will need to add the GA custom tag to all the relevant views you want to track. The best suggestion is to put the code into some sort of "footer" template that gets included on every page that visitors see.

Code Block

<!--- import tag library --->
<cfimport taglib="/farcry/plugins/googleAnalytics/tags" prefix="ga" />

<!--- add track tag; ideally just above the closing </body> --->
<ga:track stObject="#request.stObj#" />

...

This is found under the Content administration tab, in the Google Analytics dropdown.

You must nominate a matching domain to activate GA tracking. Note this feature allows you to nominate different urchin codes for different domains or none at all. For example, you might not want to track stats at all from developer and staging server machines.

Make sure active is always on; this property is deprecated.

Ignore Types for now; its an advanced option that needs a bit of fleshing out. Crawl through the code if you must.

The username and password for the GA API is entirely optional. It is used to pull statistics into the application on demand from Goolge. You require the GA login credentials in order to see stats in the GA webtop overview tab, or to use the "most popular" content publishing rule.

What else?

That's literally it. If GA Plugin detects that you are serving a page from one of the configured domains, it will automatically include the correct urchin code for your domain in the HEAD of your document.