https://github.com/danielbayerlein/middleman-google-analytics
📈 A @middleman plugin to handle generating your Google Analytics tracking code.
https://github.com/danielbayerlein/middleman-google-analytics
google-analytics middleman middleman-extension
Last synced: 5 months ago
JSON representation
📈 A @middleman plugin to handle generating your Google Analytics tracking code.
- Host: GitHub
- URL: https://github.com/danielbayerlein/middleman-google-analytics
- Owner: danielbayerlein
- License: mit
- Created: 2013-03-10T03:22:07.000Z (over 13 years ago)
- Default Branch: master
- Last Pushed: 2018-06-26T17:46:23.000Z (about 8 years ago)
- Last Synced: 2025-10-13T18:04:07.517Z (9 months ago)
- Topics: google-analytics, middleman, middleman-extension
- Language: Gherkin
- Homepage:
- Size: 117 KB
- Stars: 92
- Watchers: 2
- Forks: 19
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# middleman-google-analytics
[](http://badge.fury.io/rb/middleman-google-analytics)
[](https://travis-ci.org/danielbayerlein/middleman-google-analytics)
[](https://gemnasium.com/danielbayerlein/middleman-google-analytics)
[](https://coveralls.io/github/danielbayerlein/middleman-google-analytics?branch=master)
**middleman-google-analytics** is a [Middleman](https://middlemanapp.com)
extension that generates
[Google Analytics](https://www.google.de/intl/en/analytics/) tracking code, and
keeps your config in `config.rb`, where it belongs.
## Installation
1. Specify the dependency in your project's `Gemfile`:
```ruby
gem 'middleman-google-analytics', '~> 3.0'
```
2. Activate the Google Analytics extension in your project's `config.rb`:
```ruby
# config.rb
activate :google_analytics do |ga|
ga.tracking_id = 'UA-XXXXXXX-X' # Replace with your property ID.
end
```
3. In your layout, after your footer, call `google_analytics_tag` and include
the results in the page:
**Haml:**
```haml
= google_analytics_tag
```
**ERB:**
```erb
<%= google_analytics_tag %>
```
**JavaScript with ERB (js.erb):**
```erb
<%= google_analytics_tag %>
```
## Configuration
```ruby
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
# Enhanced Link Attribution (default = false)
ga.enhanced_link_attribution = false
# Container ID for Google Optimize (A/B Testing)
ga.optimize = 'GTM-123456'
# Log detail messages to the console (default = false)
ga.debug = false
# Trace debugging will output more verbose information to the console (default = false)
ga.debug_trace = false
# Disable extension (default = false)
ga.disable = true
# Testing your implementation without sending hits (default = true) in development
ga.test = true
# Compress the JavaScript code (default = false)
ga.minify = false
# Output style - :html includes tag (default = :html)
ga.output = :js
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)](https://github.com/MrJoy)
* For the initial code.
* [Atsushi Nagase (@ngs)](https://github.com/ngs)
* Cucumber tests and "Universal Analytics" support.
* [Thomas Reynolds (tdreyno)](https://github.com/tdreyno)
* For the great support.
* [Contributors](../../graphs/contributors)
## Contributing
1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new [Pull Request](../../pull/new/master)
## License
Copyright (c) 2014-present Daniel Bayerlein. See [LICENSE](./LICENSE.md) for details.
Copyright (c) 2013 Jon Frisby.