Download and upgrade instructions 

Engine General Availability Versions

tyGraph Pages Engine v1.7.0.42

Logger Version - 20230519.0

Changes

• Now supports unbofuscation of external users for tenants with obfuscation set to none

tyGraph Pages Engine v1.7.0.41

Logger Version - 20230511.0

Changes

• Collect TopicId and TopicType on Viva Topics topic page

tyGraph Pages Engine v1.7.0.40

Logger Version - 20230110.1

Changes

• Collection of single value managed metadata (taxonomy) fields
• Support for capture of new list fields include content version, moderation status, Comment Count and Like Count

tyGraph Pages Engine v1.7.0.39

Logger Version - 20221129.0

Changes

• Reduced telemetry in additional scenarios

tyGraph Pages Engine v1.7.0.37

Logger Version - 20221116.1

Changes

• Fixed issue with list item details due to change in dependencies
• Reduced telemetry in some scenarios for ingestion optimization

tyGraph Pages Engine v1.7.0.35

Logger Version - 20221109.1

Changes

• Fixed issue with list item details after navigating between sites
• Adjusted link tracking logic to more accurately detect web parts such as Hero
• Upgraded dependencies

tyGraph Pages Engine v1.7.0.34

Logger Version - 20220909.2

Changes

• Implemented retries for supplemental list and hub site information
• Upgraded dependencies

tyGraph Pages Engine v1.7.0.31

Logger Version - 20220510.0

Changes

• Removed legacy license check URL
• Captured new button types for Microsoft Lists and Create button on the App Bar
• Upgraded dependencies
• Added UpnUid field to customMetrics

tyGraph Pages Engine v1.7.0.29

Logger Version - 20220302.0

Changes

• Added delay to Microsoft Graph calls that aren't successful

tyGraph Pages Engine v1.7.0.28

Logger Version - 20220228.0

Changes

• Added new fields to CDN configuration for user profile field obfuscation
• Capture adaptive card clicks (preview)
• Improved tracking of search results links including breadcrumbs and buttons
• Resolved field issue when tracking events
• Removed unused fields from page views
• Corrected issue with empty TopicName / VivaTopics field
• Built with SPFx 1.14.0
• Minor bug fixes and improvements

tyGraph Pages Engine v1.7.0.24

Logger Version - 20220207.1

Changes

• Disabled built-in Application Insights automatic exception tracking to reduce data ingestion volumes

tyGraph Pages Engine v1.7.0.20

Logger Version - 20220117.1

Changes

• Improved Atlas site detection
• Collapsible Section tracking
• Upgrade of Application Insights SDK to 2.7.2
• Resolved issue with PageLayoutType field not being populated
• New capture of Author Byline field
• Identification of Teams Web usage  
• Improvements to ensure reliability of UserUid field
• Minor bug fixes and improvements

tyGraph Pages Engine v1.7.0.18 - December 2021 Release

Logger Version - 20211213.0

Changes

• Increased timeout before sending telemetry to improve Viva Topics and Search query logging
• Increase in timeout when checking for Search queries with no results
• Remove Graph /me API call from external users and anonymous users for non-obfuscated tenants
• Resolved an issue where the previous search query was tracked instead of the current one in some cases
• Resolve issue with UsageLocation logging as undefined

tyGraph Pages Engine v1.7.0.12 - October 2021 Release

Logger Version - 20211102.0

Changes

• Ability to track custom list columns on pages
• Tracking of pages that have been boosted
• Tracking of SharePoint Spaces pages
• Tracking of searches that don't return any results
• Tracking of ContentType and ContentTypeId columns
• Additional handling of users without E-mail addresses
• Built with SPFx 1.13.0

tyGraph Pages Engine v1.7.0.5 - September 2021 Release

Logger Version - 20210928.0

Changes

• Enhanced user attributes collection (Preview)
• Valo integration
• Search tracking improvements in SharePoint
• Addition of ModerationStatus field
• Addition of LegacyUserUid field to address changes in UserUid affecting those upgrading from older versions of the tyGraph Pages Engine

tyGraph Pages Engine v1.7.0.1 - August 2021 Release

Logger Version - 20210728.0

Changes

• Additional button tracking
• Enhanced tracking for Atlas sites
• Bug fixes

tyGraph Pages Engine v1.7.0.0 - July 2021 Release

Logger Version - 20210628.0

Changes

• Ability to receive some updates automatically from the CDN without having to update the package
• Link tracking now captures additional telemetry from known web parts such as Hero
• Tracking of sites which have Atlas installed
• Improved referrer tracking between SharePoint pages
• Manual override of referrer available when referrer can't be tracked
• Improvement of PromotedState values for Home Pages
• Tracking of known utm paramters from E-mail links
• General availability of global navigation tracking
• Introduction of a Preview Ring
• Improvements to Viva Topic Card (annotations) tracking
• Bug fixes

tyGraph Pages Engine v1.6.0.13

Logger Version - 20210504.1

Changes

• Support for SPFx 1.12.1
• Change to CDN for license validation
• Preview of Viva Connections SharePoint App Bar tracking
• Preview of Viva Connections global navigation tracking
• Preview of SharePoint Syntex model tracking
• Consolidated list item API calls to improve date formatting in created / modified fields
• Support for Edge legacy versions 17 and 18
• Tracking whether the user is a Site Owner or Site Admin
• Tracking whether the site is archived
• Removed user page read percentage values of zero
• Updated classic web part group

tyGraph Pages Engine v1.5.0.26

Logger Version - 20210319.0

Changes

• Implemented new cache key for tenant information
• Added retry for license service when the API call is unsuccessful
• Added cache fallback for license checks
• Updated logic to retrieve Hub Site information due to changes in Microsoft 365 service.
• All customers are recommended to upgrade to this version to ensure Hub Site information is captured correctly.

tyGraph Pages Engine v1.5.0.22

Logger Version - 20210311.0

Changes

• Minor improvements to telemetry

tyGraph Pages Engine v1.5.0.21 - GA

Logger Version - 20210226.0

Changes

• Tracking browser user agent and client
• Collected additional data required for upcoming Time on Page report
• Resolves bugs related to tracking user page read percentage
• Preview of Developer API

tyGraph Pages Engine v1.5.0.13 - RC3

Logger Version - 20210202.1

Changes

• Tracking user page read percentage
• Corrected issue with PageViewTime metric
• Resolved issues with legacy versions of Safari

tyGraph Pages Engine v1.5.0.9 - RC2

Logger Version - 20210125.1

Changes

• Enhanced button tracking allowing capturing of telemetry on user events such as document downloads, deletes, views, sharing, link creation, and more.
• Link tracking allowing the capture of the HREF attribute on links
• Improved exception tracking
• Added Hub Site information to event tracking for use by Site Analytics web part
• Improved page read tracking for non-scrollable pages

tyGraph Pages Engine v1.4.0.12 - RC1

Logger Version - 20210111.0

Changes

• Switched to new configuration URL endpoint

tyGraph Pages Engine v1.4.0.11 - RC0

Logger Version - 20210104.0

Changes

• Added PageAbsoluteUrl to simplify Page Visit Time reporting
• Added operational telemetry to track engine version numbers

Engine Preview Ring versions

tyGraph Pages Engine v1.7.0.30

Logger Version - 20220321.0

Changes

• Removed backup call to home.tygraph.com for license information
• Support for capturing clicks for Microsoft Lists and Create in the App Bar
• Upgraded dependencies

tyGraph Pages Engine v1.7.0.25

Logger Version - 20220211.0

Changes

• Added new fields to CDN configuration for user profile field obfuscation
• Capture adaptive card clicks (preview)
• Resolved field issue when tracking events
• Removed unused fields from page views
• Minor bug fixes and improvements

tyGraph Pages Engine v1.7.0.20

Logger Version - 20220117.1

Changes

• Improved Atlas site detection
• Collapsible Section tracking
• Upgrade of Application Insights SDK to 2.7.2
• Resolved issue with PageLayoutType field not being populated
• New capture of Author Byline field
• Identification of Teams Web usage  
• Improvements to ensure reliability of UserUid field
• Minor bug fixes and improvements

tyGraph Pages Engine v1.6.0.9

Logger Version - 20210429.0

Changes

• Support for SPFx 1.12.1
• Preview of Viva Connections SharePoint App Bar tracking
• Preview of Viva Connections global navigation tracking

tyGraph Pages Engine v1.6.0.6

Logger Version - 20210420.0

Changes

• Support for SPFx 1.12.1rc2
• Enhancements for tyGraph Pages Health Check
• Preliminary support for Viva Topics
• Experimental support for some SharePoint Syntex training pages
• Removed user page read percentage values of zero

tyGraph Pages Engine v1.6.0.3

Logger Version - 20210408.0

Changes

• Preliminary support for SPFx 1.12 before it was deprecated
• Consolidated list item API calls to improve date formatting in created / modified fields
• Support for Edge legacy versions 17 and 18
• Tracking whether the user is a Site Owner or Site Admin
• Tracking whether the site is archived

tyGraph Pages Engine v1.5.0.10

Logger Version - 20210125.1

Changes

• Experimental - user page read percentage
• Corrected issue with some metadata in the PageViewTime event

tyGraph Pages Engine v1.5.0.1

Logger Version - 20210107.0

Changes

• Experimental - document library and list tracking
• Changed click tracking to send the nearest button details when present

Web Parts General Availability Versions

tyGraph Pages Web Parts v1.5.0.12

Logger Version - 20230712.0

Changes

• NEW! - drop down menu of new reports in Report Bar
• NEW! - Hub Site Analytics in Report Bar.  Activate from the drop down menu or the toggle in the Site Analytics report
• NEW! - Page Performance report in Report Bar
• NEW! - Engagement report preview in Report Bar.  Understand likes and comments on your site.
• Added toggle between site and hub site in Site Analytics report in Report Bar
• Updated Site Analytics report layout in Web Part
  • Replaced Button Activity report with Average Time on Site
  • Site scoped reports: replaced Top Sites report with Site Navigation
  • Hub site scoped reports: replaced Top Links with Hub Site Navigation
  • Tenant scoped reports: replaced Top Links report with Global Navigation
• Changed devices charts to horizontal bar using unique users
• Renamed Viva Connetions Summary to Unique Users vs Viva Connections
• Added Info icon to each report visual which explains how the report works
• Viva Connections - Topic Card Annotations general availability
• Renamed several report visuals to more accurately describe them
• Minor bug fixes and improvements

tyGraph Pages Web Parts v1.5.0.11

Logger Version - 20230607.0

Changes

• General availability of Heat Map in Report Bar
• Heat Map now redraws when the page is scrolled.
• Heat Map now supports highlighting some visible buttons on the page.
• Fixed issues with updating Heat Map and Link Reporting after navigating to another page.
• NEW - Broken Link scanning in Report Bar.  Find broken links on your page at the click of a button.
• Activate Report Bar functionality directly with new query string parameters: ?showHeatMap, ?enableLinkReporting, ?showSiteAnalytics, ?showBrokenLinks.
• Minor bug fixes and improvements

tyGraph Pages Web Parts v1.5.0.10

Logger Version - 20230510.3

Changes

• NEW! Calendar slicer in Site Analytics Web Part and Report Bar
• Corrected issues with date rendering in Site Analytics Web Part and Report Bar

tyGraph Pages Web Parts v1.5.0.7

Logger Version - 20221207.0

Changes

• Resolves issue with report rendering for some reports in Web Parts and Report Panel

tyGraph Pages Web Parts v1.5.0.5

Logger Version - 20221101.0

Changes

• Improvements to Top News report

tyGraph Pages Web Parts v1.5.0.4

Logger Version - 20221005.0

Changes

• Added support for configurable time zone offsets in web part
• tyGraph API Support (Preview)
• Corrected issue with day slicer and report layout controls not functioning
• Upgraded dependencies
• Corrected issue with report bar refreshing after navigation
• Minor bug fixes and improvements

tyGraph Pages Web Parts v1.4.0.25

Logger Version - 20220228.0

Changes

• Report Bar - click Page Views to toggle to Unique Users
• Report Bar - Site Analytics report - view site analytics from any page
• Report Bar button in Site Analytics web part
• Improved theme support for Microsoft Teams
• Improvements to button labels in Button report
• Localization updates

tyGraph Pages Web Parts v1.4.0.20

Logger Version - 20220114.0

Changes

• Link Reporting now supports Hero Web Parts
• Updated line colors and styles in charts
• New Viva Connections Report Layout
• Support for secondary datasets in reports
• Minor bug fixes and improvements

tyGraph Pages Web Parts v1.4.0.18

Logger Version - 20211102.0

Changes

• Preview of new Heat Map feature - visualize link performance right on the page
• Correction in Link Report values for Site and Hub Site navigation.  As a result, values may be lower than in the first preview.
• Progress indicator for Link Reporting with additional caching and performance improvements
• Performance improvements in links reports for high volume tenants
• New Expand button on report components to view data at full browser width
• Atlas Navigation report available whenever Atlas is available
• New lock icon on Report Bar indicating visibility
• Bug fixes
• Built on SPFx 1.13.0

tyGraph Pages Web Parts v1.4.0.8

Logger Version - 20210907.0

Changes

• Visual improvements for web part and report panel
• Improved visuals when used in Microsoft Teams
• On-page Link Reporting from Report Bar - view link and navigation performance in the context of the current page.
• Viva Topics Report visual (preview) in Web Part
• Button activity report (preview) - view number of button clicks such as Page Like, Page Edit, Share, etc.
• CDN-based updates - most releases won't require uploading a new package
• Web part link performance visual - view performance of links in web parts such as Hero or News
• Bug fixes

tyGraph Pages Web Parts v1.4.0.1

Logger Version - 20210624.0

Changes

• General availability of tenant-wide authentication
• General availability of in-page analytics using new Report Panel
• New filterable reports
• Button activity reports such as page edits, page publishes, and page likes (Preview)
•  Viva Topic Card (preview) in Report Panel
• Improved first-run experience with guided tour
• Demo data when web part hasn't been configured
• Integrated installation instructions for tyGraph Pages
• Removed Page Analytics web part

tyGraph Pages Web Parts v1.2.0.6

Logger Version - 20210503.0

Changes

• Added Global Navigation reporting when using the tenant data source.

tyGraph Pages Web Parts v1.1.0.14 - RC2

Web Part Version - 20210312.0

Changes

• New: Navigation and Client Type reports
• Improved first launch experience.

tyGraph Pages Web Parts v1.1.0.9 - RC1

Web Part Version - 20210312.0

Changes

• Report layouts with pre-configured reports
• Devices report layout
• Screen resolutions and browser sizes reports
• Improved chart loading experience
• Links report

tyGraph Pages Web Parts v1.1.0.1 - RC0

Web Part Version - 20210201.0

Changes

• Initial release

Web Parts Preview Ring versions

tyGraph Pages Web Parts v1.5.0.11

Logger Version - 20230606.0

Changes

• General availability of Heat Map in Report Bar
• Heat Map now redraws when the page is scrolled.
• Heat Map now supports highlighting some visible buttons on the page.
• Fixed issues with updating Heat Map and Link Reporting after navigating to another page.
• NEW - Broken Link scanning in Report Bar.  Find broken links on your page at the click of a button.
• Activate Report Bar functionality directly with new query string parameters: ?showHeatMap, ?enableLinkReporting, ?showSiteAnalytics, ?showBrokenLinks.
• Minor bug fixes and improvements

tyGraph Pages Web Parts v1.5.0.9

Logger Version - 20230412.1

Changes

• Removed tyGraph Pages Site Analytics as a full page app

tyGraph Pages Web Parts v1.5.0.6

Logger Version - 20221109.1

Changes

• Resolve issue with Link Reporting and Hero Web Parts
• Improved queries for Page Views to select most active link title
• Updated dependencies

tyGraph Pages Web Parts v1.5.0.6

Logger Version - 20221109.1

Changes

• Resolve issue with Link Reporting and Hero Web Parts
• Improved queries for Page Views to select most active link title
• Updated dependencies

tyGraph Pages Web Parts v1.5.0.1

Logger Version - 20220815.0

Changes

• Corrected issue with day slicer and report layout controls not functioning
• Updated dependencies
• Minor bug fixes and improvements

tyGraph Pages Web Parts v1.4.0.25

Logger Version - 20220224.0

Changes

• Report Bar - click Page Views to toggle to Unique Users
• Report Bar - Site Analytics report - view site analytics from any page
• Report Bar button in Site Analytics web part
• Improved theme support for Microsoft Teams
• Improvements to button labels in Button report
• Localization updates

tyGraph Pages Web Parts v1.4.0.20

Logger Version - 20220112.0

Changes

• New Viva Connections reports - view Viva Connections adoption by day or summary
• New Viva Connections report layout
• Updated color palette for reports
• Optimizations in Report component used by web parts and report panel
• Code optimizations and bug fixes
• Update of Application Insights SDK

tyGraph Pages Web Parts v1.6.0.9

Logger Version - 20210513.1

Changes

• Preview of tenant-wide authentication