Home

Awesome

hubot-analytics

Build Status Codacy Badge

A hubot script to get google analytics reports

See src/analytics.js for full documentation.

Installation

In hubot project repo, run:

npm install hubot-analytics --save

Then add hubot-analytics to your external-scripts.json:

[
  "hubot-analytics"
]

Configuration

  1. Create a [https://console.developers.google.com/project](google project)
  2. Enable "Analytics API" in your project (https://console.developers.google.com/apis/)
  3. Create a service account https://console.developers.google.com/permissions/serviceaccounts and download JSON with private key
  4. Configure the followings environments variables in your hubot server:
GOOGLE_API_PRIVATE_KEY - look for 'private_key' in JSON
GOOGLE_API_CLIENT_EMAIL - look for 'client_email' in JSON

Sample Interaction

Run analytics help for full list of commands

Shows profiles to which the bot has access and store in hubot brain

User> analytics profiles
SpikeBot> @User:
114783908 - Project X
123511123 - Site Plan B
128210353 - Hubot Chat

Shows pageviews and visits of website with "Site Name or ID"

User> analytics pageviews "Site Name or ID"
SpikeBot> @User: SiteName: 6346 visits and 12317 pageviews.

Get percentage mobile x desktop access of website with "Site Name or ID"

User> analytics devices "Site Name or ID"
SpikeBot> @User: desktop - 1450 sessions (21.75%)
mobile - 4903 sessions (73.54%)
tablet - 314 sessions (4.71%)

Get browsers percentage access with "Site Name or ID"

User> analytics browser "Site Name or ID"
SpikeBot> @User: Chrome - 3885 sessions (75.68%)
Firefox - 290 sessions (21%)
Internet Explorer - 115 sessions (3.32%)

Contributing

  1. Fork it (https://github.com/PlanBCom/hubot-analytics/fork).
  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 a new Pull Request.