connect-ganalytics

Ridiculously simple Google Analytics for Express.js.

Meta

• Author: Randall Degges
• Email: r@rdegges.com
• Twitter: @rdegges
• Site: http://www.rdegges.com
• Status: production ready

Installation

To install connect-ganalytics using npm, simply run:

$ npm install connect-ganalytics --save

In the root of your project directory.

Usage

Once you have connect-ganalytics installed, you can integrate it into your Express.js application easily.

The first step is to initialize the googleAnalytics middleware. Below is an example Express.js application which demonstrates how to configure the middleware -- simply pass it your Google Analytics Tracking ID (you can find this in your Google Analytics dashboard):

var express = require('express');
var googleAnalytics = require('connect-ganalytics');

var app = express();
app.use(googleAnalytics('UA-XXX-XX'));

Once the middleware is initialized as shown above, you can simply use the googleAnalyticsScript variable in your base template (regardless of what templating language you're using) -- just make sure to escape the output.

Here's an example layout.jade template which renders the Google Analytics script properly, using the Jade templating language:

html
  head.
    !{googleAnalyticsScript}
  body
    h1 Welcome!

NOTE: The !{} syntax in Jade means to output the contents of the variable, but to not escape the outputs. This is important, as if you have escaping enabled (which is the default behavior), your script will render as HTML, not an actual Javascript script.

Changelog

v0.0.1: 9-7-2014

- Fixing issue with template path.

v0.0.0: 9-7-2014

- First release!