Support

Submit a ticket My Tickets Login
Welcome
Login

User profile tracking in tyGraph Pages

By popular request, the tyGraph Pages Engine now collects limited user profile data including the following fields using the Microsoft Graph.  These fields will enable future filters in our Power BI reports allowing segmentation of data across various user and location attributes.  User profile tracking is available in Engine version 20210812.1 and newer.


What data do we track?

We track the following fields from the current user's profile from Azure Active Directory using the existing user.read permission scope that many customers have already granted to tyGraph Pages:


  • displayName
  • userPrincipalName
  • usageLocation
  • city
  • state
  • department 
  • officeLocation
  • jobTitle
  • id

In addition to the above fields, we also collect an anonymous identifier created by hashing the userPrincipalName.


How do I turn on user profile tracking?

For tenants currently using partial obfuscation, we will track user profiles automatically since we already have the necessary Microsoft Graph permissions to query the user data.  For tenants using none or all obfuscation, you will need to grant user.read permission in the SharePoint Admin center.  For details on how to enable this setting, refer to the Installation Guide.


Is user data obfuscated?

If you have enabled user data obfuscation, the displayName and userPrincipalName fields will be obfuscated using a hash of the userPrincipalName.  This allows tyGraph Pages to distinguish between individual users but not track who the individual user is.


How do I opt out?

A tenant may opt out of user profile tracking if they do not need or want this functionality.  For tenants not using partial obfuscation, you may simply remove the user.read Microsoft Graph permission scope from tyGraph Pages. For all tenants, you may also opt out by contacting tyGraph support.  Due to browser caches, it may take up to a day for the opt-out to take effect across your tenant.


When will user profile be available in reports?

We are currently in the first phase of user profile tracking in which the tyGraph Pages Engine collects it.  After we have validated the data we receive, we will look at how we can implement this data in future reports.