HISTORY.md

@@ -1,5 +1,18 @@
 # History
 
+## 0.4.18
+
+- Fixed package-lock.json bug
+- Updated request package
+
+## 0.4.17
+
+- Default to `https` instead of `http` when submitting data to Google Analytics
+- Switched from custom debugger to [debug](https://www.npmjs.com/package/debug) module
+
+Deprecated:
+- `.debug()` is now deprecated in favor of setting the DEBUG environment variable: `DEBUG=universal-analytics`
+
 ## 0.4.16
 
 - Removed async, underscore dependencies

README.md

@@ -5,7 +5,7 @@ A node module for Google's [Universal Analytics](http://support.google.com/analy
 
 This module allows tracking data (or rather, users) from within a Node.js application. Tracking is initiated on the server side and, if required, does not require any more tracking in the browser.
 
-[![Build Status](https://travis-ci.org/peaksandpies/universal-analytics.png?branch=master)](https://travis-ci.org/peaksandpies/universal-analytics)
+[![npm version](https://badge.fury.io/js/universal-analytics.svg)](https://www.npmjs.com/package/universal-analytics) [![Build Status](https://travis-ci.org/peaksandpies/universal-analytics.png?branch=master)](https://travis-ci.org/peaksandpies/universal-analytics)
 
 
 # Table of Contents
@@ -21,6 +21,7 @@ This module allows tracking data (or rather, users) from within a Node.js applic
     - [Transaction items](#transaction-item-tracking)
 - [Daisy-chaining tracking calls](#daisy-chaining-tracking-calls)
 - [Setting persistent parameters](#setting-persistent-parameters)
+- [Filter application tracking data](#filter-application-tracking-data)
 - [Session-based identification](#session-based-identification)
 - [Debug mode](#debug-mode)
 - [Request Options](#request-options)
@@ -38,6 +39,9 @@ $ npm install universal-analytics
 
 ```javascript
 var ua = require('universal-analytics');
+
+// Or with ES6 import
+import ua from 'universal-analytics'
 ```
 
 Initialization expects at least your Google Analytics account ID:
@@ -63,6 +67,13 @@ If you want to use Google Analytics in http protocol, just include it in the opt
 var visitor = ua('UA-XXXX-XX', {http: true});
 ```
 
+If you want to set User Id you can add it into options:
+```javascript
+var visitor = ua('UA-XXXX-XX', {uid: 'as8eknlll'});
+```
+[see about User Id](https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters#uid)
+
+
 Tracking a pageview without much else is now very simple:
 
 ```javascript
@@ -516,6 +527,18 @@ For custom dimensions, you will not pass `dimension#` rather `cd#`:
  visitor.set("cd[1-20]", "123456789"); // [1-20] will be the dimension number
 ```
 
+# Filter application tracking data
+
+Set a persistent parameter for [`Data Source`](https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters#ds) to `app` in order to mark tracking data as `Application`.
+
+```javascript
+ visitor.set("ds", "app"); // Allows filtering by the 'Application?' field in GA
+```
+
+Then create a new view in Google Analytics of type 'Application'. You will then need to filter the data for that view by creating a new filter that either includes or excludes `Application? Yes` (depending on if you want to show(includes) or hide(excludes) application analytics in a given view).
+
+![Google Analytics Setup](https://i.imgur.com/ZDZ3ZPO.png)
+
 # Session-based identification
 
 In order to make session-based apps easier to work with, `universal-analytics` also provides a middleware that works in an Expressjs-style fashion. It will try to detect a client ID based on the `_ga` cookie used by the analytics.js client-side tracking. Additionally it will store the detected client ID in the current session to recognize the visitor later.

package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-analytics",
-  "version": "0.4.17",
+  "version": "0.4.18",
   "description": "A node module for Google's Universal Analytics tracking",
   "main": "index.js",
   "scripts": {
@@ -18,7 +18,7 @@
   ],
   "dependencies": {
     "debug": "^3.0.0",
-    "request": "2.86.0",
+    "request": "^2.86.0",
     "uuid": "^3.0.0"
   },
   "devDependencies": {