Identifying unique users in Whatfix Analytics
- 16 Nov 2023
- 3 Minutes To Read
-
Print
-
DarkLight
-
PDF
Identifying unique users in Whatfix Analytics
- Updated On 16 Nov 2023
- 3 Minutes To Read
-
Print
-
DarkLight
-
PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
User Identification
User Identification, as the name suggests, is the process of uniquely identifying users that interact with Whatfix content. Whatfix Desktop uses a combination of parameters, like the user machine’s domain name or username, to uniquely identify a user.
Whatfix provides an API to accurately set and pass the user information. However, if the user information is not configured, then we use browser local storage and cookies to identify a user.
User Identification Method
We recommend using user information so that we can correctly identify users and provide more accurate analytics. User information can be set using wfx_settings. This can also be used along with extra values to segment user behavior.
Note
Usernames and extra information are considered Personally Identifiable Information (PII) and therefore are encrypted throughout - in transit and on rest. So anything that is passed as user information or user segmentation information is secure.
User Identification from PC
Whatfix uses the current user’s ID as the Username. This username is constant across desktop applications and is used to uniquely identify the user.
Info
The User ID's data is captured in the format, Userdomain-Username.
Use the following steps to obtain the User ID data for your device,
-
Go to the Command Prompt.
-
Paste either one of the following code and press Enter,
whoamiecho %USERDOMAIN%%USERNAME%
your title goes here
The output is the User ID. For example, here the ID is csedektop-csedesktop.
Cookie Method
If User Identification for users using desktop is not set up, Whatfix, by default, uses cookies to identify them. When Whatfix is loaded on an application page, a randomly generated value, i.e. a cookie, is set to identify the user. The value of this cookie is passed with every call sent to Analytics along with the user information mentioned.
Note
Cookie values expire periodically, and each user is then assigned a new value. This leads to incorrect data being captured and inaccurate analytics numbers.
Advantages of User Identification
With User Identification you can identify,
- Users’ engagement rate with your content
- Unique users and their behavior
- Users’ content completion rate
- Weak points in your content
- The type of content segmentation required based on User roles etc.
Note
All the User IDs are encrypted in an alphanumeric format when captured. They are decrypted for use in Analytics reports only after your approval.
How do we identify users?
Whatfix uses a combination of cookies and the user API to identify a user. We first try to use user information, if it’s present. For events where user information is not available, we rely on the value of the unique cookie set in the event.
Example
Let’s assume that a user, John, is logged in on three different desktop PCs. His user information is available on the first two devices but not on the third.
| Device | Is User Info Present | Unique Cookie Value | User info resolved |
|---|---|---|---|
| Desktop 1 | Yes (John) | rand_val_1 | John |
| Desktop 2 | Yes (John) | rand_val_2 | John |
| Desktop 3 | No | rand_val_3 | rand_val_3 |
| Unique Users Detected | 3 | 2 |
Whatfix is able to retrieve and use the username in the first two devices. However, in the third device, we do not know who the user is, and so we fall back to the unique cookie value.
The number of users detected by our algorithm is 2.
In case no user information is passed for the same example, the number of unique users detected completely relies on cookies and therefore is recorded as 3.
If user information is set in all the calls, then the user detected is 1.
Every time Whatfix loads, it looks up the unique cookie. If absent, a unique ID is generated and saved as a cookie. Subsequent sessions use the same cookie value to identify the user. This user ID is sent in all Analytics events.
Was this article helpful?