Merge remote-tracking branch 'origin/master'

Author: pmeisen

documentation/api.md

@@ -117,7 +117,7 @@ This documentation is organized as following:
 
   **Parameters**:
 
-  {object} **user**: A plain object specifying the user information the activity belongs to. More information about the structure can be found [here](TODO).
+  {object} **user**: A plain object specifying the user information the activity belongs to. More information about the structure can be found [here](./user.md).
 
   {string|null} **type**: The type of the activity collected, i.e., one of *search*, *login*, *logout*, *addToCart*, *removeFromCart*, *checkOut*, *selectProduct*, or *other*. If not specified, the default *other* will be used.
 

documentation/user.md

@@ -0,0 +1,76 @@
+## User Field Documentation
+
+Breinify supports various user properties that you can include in the analytics.
+
+### Example of full user info
+
+```javascript
+var user = {
+    'email' : 'johndoe@gmail.com',
+    'firstName' : 'John',
+    'lastName' : 'Doe',
+    'dateOfBirth' : new Date(1985,6,30),
+    'deviceId' : 'AAAAAAAAA-BBBB-CCCC-1111-222222220000',
+    'md5Email' : '761cd16b141770ecb0bbb8a4e5962d16',
+    'sessionId' : 'SID:ANON:w3.org:j6oAOxCWZ'
+}
+```
+
+### Fields
+
+#### Email
+
+Attribute key: `email`
+
+Example value: `johndoe@gmail.com`
+
+Description: The email address of the current user, if known.
+
+#### First Name
+
+Attribute key: `firstName`
+
+Example value: `John`
+
+Description: The first name of the current user, if known.
+
+#### Last Name
+
+Attribute String: `lastName`
+
+Example: `Doe`
+
+Description: The last name of the current user, if known.
+
+#### Date of Birth
+
+Attribute key: `dateOfBirth`
+
+Example value: `new Date(1985, 6, 30)`
+
+Description: The email address of the current user, if known.
+
+#### Device ID
+
+Attribute key: `deviceId`
+
+Example value: `AAAAAAAAA-BBBB-CCCC-1111-222222220000`
+
+Description: The current user's device's id, if known.
+
+#### MD5 Email
+
+Attribute key: `md5Email`
+
+Example value: `761cd16b141770ecb0bbb8a4e5962d16`
+
+Description: A hashed version of the user's email address.
+
+
+#### Session ID
+
+Attribute key: `sessionId`
+
+Example value: `SID:ANON:w3.org:j6oAOxCWZ`
+
+Description: The user's [Session Id](https://en.wikipedia.org/wiki/Session_ID).