81 lines
No EOL
2.5 KiB
Markdown
81 lines
No EOL
2.5 KiB
Markdown
## Go-ogle Analytics
|
|
|
|
Track and monitor your Go programs for free with Google Analytics
|
|
|
|
The `ga` package is essentially a Go wrapper around the [Google Analytics - Measurement Protocol](https://developers.google.com/analytics/devguides/collection/protocol/v1/reference)
|
|
|
|
**Warning** This package is 95% generated from the [Parameter Reference](https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters) so it may contain bugs - please report them. GA allows "10 million hits per month per property" and will reject requests after that.
|
|
|
|
### Install
|
|
|
|
```
|
|
go get -v github.com/jpillora/go-ogle-analytics
|
|
```
|
|
|
|
### API
|
|
|
|
Create a new `client` and `Send()` a 'pageview', 'screenview', 'event', 'transaction', 'item', 'social', 'exception' or 'timing' event.
|
|
|
|
#### http://godoc.org/github.com/jpillora/go-ogle-analytics
|
|
|
|
### Quick Usage
|
|
|
|
1. Log into GA and create a new property and note its Tracker ID
|
|
|
|
1. Create a `ga-test.go` file
|
|
|
|
``` go
|
|
package main
|
|
|
|
import "github.com/jpillora/go-ogle-analytics"
|
|
|
|
func main() {
|
|
client, err := ga.NewClient("UA-XXXXXXXX-Y")
|
|
if err != nil {
|
|
panic(err)
|
|
}
|
|
|
|
err = client.Send(ga.NewEvent("Foo", "Bar").Label("Bazz"))
|
|
if err != nil {
|
|
panic(err)
|
|
}
|
|
|
|
println("Event fired!")
|
|
}
|
|
```
|
|
|
|
1. In GA, go to Real-time > Events
|
|
|
|
1. Run `ga-test.go`
|
|
|
|
```
|
|
$ go run ga-test.go
|
|
Event fired!
|
|
```
|
|
|
|
1. Watch as your event appears
|
|
|
|
|
|
|
|
#### MIT License
|
|
|
|
Copyright © 2015 <dev@jpillora.com>
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining
|
|
a copy of this software and associated documentation files (the
|
|
'Software'), to deal in the Software without restriction, including
|
|
without limitation the rights to use, copy, modify, merge, publish,
|
|
distribute, sublicense, and/or sell copies of the Software, and to
|
|
permit persons to whom the Software is furnished to do so, subject to
|
|
the following conditions:
|
|
|
|
The above copyright notice and this permission notice shall be
|
|
included in all copies or substantial portions of the Software.
|
|
|
|
THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
|
|
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
|
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
|
|
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
|
|
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
|
|
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |