https://github.com/umbrellio/ga-tracker
Google Analytics tracker
https://github.com/umbrellio/ga-tracker
Last synced: 7 months ago
JSON representation
Google Analytics tracker
- Host: GitHub
- URL: https://github.com/umbrellio/ga-tracker
- Owner: umbrellio
- Created: 2020-09-15T13:40:52.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2020-10-03T19:33:49.000Z (over 5 years ago)
- Last Synced: 2025-01-03T12:14:06.884Z (over 1 year ago)
- Language: JavaScript
- Size: 104 KB
- Stars: 1
- Watchers: 5
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# @umbrellio/ga-tracker
[](https://coveralls.io/github/umbrellio/ga-tracker?branch=master)
[](https://travis-ci.com/umbrellio/ga-tracker)
Google Analytics tracker for web env (no `window` object required).
## Install
```sh
$ yarn add @umbrellio/ga-tracker
```
## Usage
```js
import GATracker from "@umbrellio/ga-tracker"
const tracker = GATracker.create(trackingId)
tracker.pageview({ dp: "/contacts", dt: "Contacts" })
```
Where `trackingId` is your app tracking id (like `UA-XXXXXXXXX-X`).
Available methods:
- `set(key, value)` – set any global var (like [user params](https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters#user))
- `pageview({ dl, dh, dp, dt })` – track page viewing ([Docs](https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters#content))
- `timing({ utc, utv, utt, utl })` – track custom timings ([Docs](https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters#timing))
## Errors
#### NetworkError
```js
import GATracker from "@umbrellio/ga-tracker"
GATracker.Errors.NetworkError
```
Throws when there was an error while sending a http request.
#### ConnectionError
```js
import GATracker from "@umbrellio/ga-tracker"
GATracker.Errors.ConnectionError
```
Throws when unable to send a http request.
## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/umbrellio/ga-tracker.
## License
Released under MIT License.
## Authors
Created by [Aleksei Bespalov](https://github.com/nulldef),
