middleman-google-analytics

middleman-google-analytics is a Middleman extension that generates Google Analytics tracking code, and keeps your config in config.rb, where it belongs.

Installation

Specify the dependency in your project's Gemfile:

  # Gemfile
  gem "middleman-google-analytics"

Activate the Google Analytics extension in your project's config.rb:

  # config.rb
  activate :google_analytics do |ga|
    ga.tracking_id = 'UA-XXXXXXX-X' # Replace with your property ID.
  end

In your layout, after your footer, call google_analytics_tag or google_analytics_universal_tag and include the results in the page:

Haml:

  # Google Analytics
  = google_analytics_tag

  # Universal Analytics
  = google_analytics_universal_tag

ERB:

  # Google Analytics
  <%= google_analytics_tag %>

  # Universal Analytics
  <%= google_analytics_universal_tag %>

Configuration

activate :google_analytics do |ga|
  # Property ID (default = nil)
  ga.tracking_id = 'UA-XXXXXXX-X'

  # Removing the last octet of the IP address (default = false)
  ga.anonymize_ip = false

  # Tracking across a domain and its subdomains (default = nil)
  ga.domain_name = 'example.com'

  # Tracking across multiple domains and subdomains (default = false)
  ga.allow_linker = false

  # Tracking Code Debugger (default = false)
  ga.debug = false

  # Tracking in development environment (default = true)
  ga.development = true

  # Compress the JavaScript code (default = false)
  ga.minify = false
end

Usage

Once you've bundled you should be able to run middleman as normal, and have it display the GA tracking code.

Special Thanks

Jon Frisby (@MrJoy)
- For the initial code.
Atsushi Nagase (@ngs)
- Cucumber tests and "Universal Analytics" support.
Contributors

Contributing