https://github.com/hybridgroup/gabba

Simple way to send server-side notifications to Google Analytics
https://github.com/hybridgroup/gabba

Last synced: about 1 month ago
JSON representation

Simple way to send server-side notifications to Google Analytics

• Host: GitHub
• URL: https://github.com/hybridgroup/gabba
• Owner: hybridgroup
• License: other
• Created: 2010-11-27T03:57:27.000Z (about 14 years ago)
• Default Branch: master
• Last Pushed: 2014-05-22T02:03:15.000Z (over 10 years ago)
• Last Synced: 2024-05-11T21:20:59.321Z (7 months ago)
• Language: Ruby
• Homepage:
• Size: 427 KB
• Stars: 462
• Watchers: 29
• Forks: 54
• Open Issues: 10
• Metadata Files:
  • Readme: Readme.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-ruby - Gabba - Simple way to send server-side notifications to Google Analytics. (Analytics)

README

        
# Gabba

[![Build Status](https://travis-ci.org/hybridgroup/gabba.png)](https://travis-ci.org/hybridgroup/gabba)

Simple class to send custom server-side events to Google Analytics

Heavily influenced by the [serversidegoogleanalytics][] project.

## Examples

### Track page views

```ruby

Gabba::Gabba.new("UT-1234", "mydomain.com").page_view("something", "track/me")

```

### Track custom events

```ruby

Gabba::Gabba.new("UT-1234", "mydomain.com").event("Videos", "Play", "ID", "123", true)

```

### Works with existing client-side Google Analytics cookies

```ruby

gabba = Gabba::Gabba.new("UT-1234", "mydomain.com")

# grab the __utma and (optionally) __utmz unique identifiers

gabba.identify_user(cookies[:__utma], cookies[:__utmz])

# trigger actions as normal

gabba.page_view("something", "track/me")

```

### Setting custom vars

```ruby

# Index: 1 through 50

index = 1

# Scope: VISITOR, SESSION or PAGE

scope = Gabba::Gabba::VISITOR

# Set var

gabba.set_custom_var(index, 'Name', 'Value', scope)

# Track the event (all vars will be included)

gabba.event(...)

# Track the page view (all vars will be included)

gabba.page_view(...)

```

### Removing custom vars

```ruby

# Index: 1 through 50

index = 1

# Delete var with this index

gabba.delete_custom_var index

```

### Track ecommerce transactions

```ruby

g = Gabba::Gabba.new("UT-6666", "myawesomeshop.net")

g.transaction("123456789", "1000.00", 'Acme Clothing', '1.29', '5.00', 'Los Angeles', 'California', 'USA')

```

### License

Gabba is released under the [MIT License](http://opensource.org/licenses/MIT).

[serversidegoogleanalytics]: http://code.google.com/p/serversidegoogleanalytics