app-usage-stats

A convention for tracking javascript application usage, making full use of custom dimensions and metrics.

Example

const UsageStats = require('app-usage-stats')
const stats = new UsageStats('UA-987654321')

• app-usage-stats
  • AppUsageStats ⇐ UsageStats ⏏
    • new AppUsageStats(tid, [options])
    • .unsent : Array.<object>
    • .sent : Array.<object>
    • .queuePath : string
    • .hit(dimension, metric, [options])
    • .save()
    • .saveSync()
    • .load()
    • .loadSync()
    • .send([options])

AppUsageStats ⇐ UsageStats ⏏

Kind: Exported class
Extends: UsageStats

new AppUsageStats(tid, [options])

Param	Type	Description
tid	string	Google Analytics tracking ID
[options]	object
[options.dimensionMap]	object	A custom dimension name to ID Map.
[options.metricMap]	object	A custom metric name to ID Map.
[options.sendInterval]	object	If specified, stats will be sent no more frequently than this period.

usage.unsent : Array.<object>

Stats not yet sent.

Kind: instance property of AppUsageStats

usage.sent : Array.<object>

Stats sent.

Kind: instance property of AppUsageStats

usage.queuePath : string

Queued stats path. Defaults to ~/.usage-stats/${trackingId}-unsent.json.

Kind: instance property of AppUsageStats

usage.hit(dimension, metric, [options])

Track a hit. The magic dimension name will be mapped to a GA screenView.

Kind: instance method of AppUsageStats

Param	Type	Description
dimension	Array.<object>	dimension-value maps
metric	Array.<object>	metric-value maps
[options]	object
[options.timeout]	number	A maxium wait period in ms, after which any pending requests will be aborted.
[options.send]	number	Each hit will be sent.

usage.save()

Save stats

Kind: instance method of AppUsageStats

usage.saveSync()

Save stats sync.

Kind: instance method of AppUsageStats

usage.load()

Load stats

Kind: instance method of AppUsageStats

usage.loadSync()

Loads stats sync.

Kind: instance method of AppUsageStats

usage.send([options])

Send and reset stats.

Kind: instance method of AppUsageStats

Param	Type	Description
[options]	object
[options.timeout]	number	A maxium wait period in ms, after which any pending requests will be aborted.

---

© 2016-17 Lloyd Brookes <75pound@gmail.com>. Documented by jsdoc-to-markdown.