ms.date | title | ms.reviewer | ms.author | author | manager | audience | f1.keywords | ms.topic | ms.service | ms.localizationpriority | ms.collection | search.appverid | ms.custom | description | |||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
09/22/2023 |
Viva Connections analytics |
evanatkin |
AtkinE |
elizapo |
Admin |
|
article |
viva-connections |
high |
|
|
intro-overview |
View usage data for Viva Connections to learn more about usage trends. |
Understand how and when users engage with components of the Viva Connections experience by using Viva Connections analytics. Review the number of people who have viewed and engaged with your organization's Viva Connections experiences, the content types users engage with, and the platforms used to access Viva Connections.
Note
- Site member permissions (or higher) to your organization’s SharePoint home site or Viva Connections app are required to view usage analytics for Viva Connections.
- Currently, up to 30 days of usage data (if available) can be viewed in the analytics report or downloaded in an Excel (.xlxs) format.
- Usage reports are only supported for Worldwide Production Environments and for some Special Cloud deployments of Microsoft 365. Refer to the usage report section for details.
- For tenants that are setup for more than one region, the option to access analytics will have to be disabled for each region using the PowerShell command.
- Usage analytics data is aggregated and cannot be tracked to an individual user.
- The analytics feature and centralized Viva Connections administration in the Microsoft 365 Admin center are unavailable in GCC, GCC High, and DoD environments. Please refer to the list of service availability for more information.
People with site member (or higher) permissions to your organization’s SharePoint home site or Viva Connections app in Teams can view usage data.
-
Navigate to your organization’s SharePoint home site.
-
Select the Settings :::image type="icon" source="../media/connections/viva-connections-analytics/sharepoint-setting-icon.png"::: icon.
-
Then, select Manage Viva Connections.
-
Next, go to the Analytics section and select View report.
:::image type="content" source="../media/connections/viva-connections-analytics/access-analytics-from-sharepoint.png" alt-text="Screenshot showing the analytics section with view report highlighted.":::
-
Navigate to your organization’s Viva Connections app in Teams.
-
Select the ellipsis in the top-right corner.
-
Then, select View Analytics
:::image type="content" source="../media/connections/viva-connections-analytics/access-analytics-from-connections.png" alt-text="Screenshot showing options with view analytics highlighted.":::
The Analytics page contains charts and graphs providing information on overall traffic, usage, and engagement.
This section provides usage data for unique users, engaged users, total visits, and returning users. It also includes activity for desktop, web, and mobile usage; regardless of the platform.
-
Unique users: Total number of individual viewers across all Viva Connections apps and devices.
-
Engaged users: Total number of individual viewers who interact with Viva Connections components.
-
Total visits: Total number of all visits, aggregated across Viva Connections apps, devices, and components.
:::image type="content" source="../media/connections/viva-connections-analytics/analytics-usage-report.png" alt-text="Screenshot showing data covering overall traffic." lightbox="../media/connections/viva-connections-analytics/analytics-usage-report.png":::
This section breaks down usage data across apps and devices, and includes activity for the Dashboard, Feed, and Resources web parts.
- Total views by apps and devices: Includes views for desktop, web, and mobile usage.
- Engaged users by component: Includes number of engaged users for the Dashboard, Feed, and Resources web parts.
-
Dashboard: Includes usage from the Dashboard web part
-
Feed: Includes usage from the Feed web part
-
Resources: Includes usage from the tab in the mobile app and the desktop app (The global navigation bar in SharePoint isn't included).
:::image type="content" source="../media/connections/viva-connections-analytics/analytics-usage-details.png" alt-text="Screenshot showing data covering usage details." lightbox="../media/connections/viva-connections-analytics/analytics-usage-details.png":::
-
-
Engaged users by dashboard card: Includes usage data for each dashboard card on your dashboard, indicating how often each user engages with a card.
:::image type="content" source="../media/connections/viva-connections-analytics/analytics-engagement-details.png" alt-text="Screenshot showing data covering engagement details." lightbox="../media/connections/viva-connections-analytics/analytics-engagement-details.png":::
Reports can be filtered on the last seven days or the last 30 days. Select a range of days next to a graph to filter the data.
:::image type="content" source="../media/connections/viva-connections-analytics/analytics-filter.png" alt-text="Screenshot showing data filtered by the last 30 days." lightbox="../media/connections/viva-connections-analytics/analytics-filter.png":::
Select Download report at the top of the analytics page to download an Excel spreadsheet that contains all the information on the analytics page across three separate tabs and sheets of data.
:::image type="content" source="../media/connections/viva-connections-analytics/vc-analytics-spreadsheet.png" alt-text="Screenshot showing downloaded analytics report in a spreadsheet." lightbox="../media/connections/viva-connections-analytics/vc-analytics-spreadsheet.png":::
Your organization might not want to see analytics data due to local data and compliance regulations or other reasons. The following steps can be followed to disable the Viva Connections analytics feature using PowerShell:
-
Download the latest SharePoint Online Management Shell.
[!NOTE]
- If you installed a previous version of SharePoint Online Management Shell, go to Add, or Remove programs and uninstall "SharePoint Online Management Shell".
- For tenants that are setup for more than one region, the option to access analytics will have to be disabled for each region using the PowerShell command.
-
Connect to SharePoint as a Global Administrator or SharePoint Administrator in Microsoft 365. To learn how, see Getting started with SharePoint Online Management Shell.
-
Connect to the tenant's SharePoint service by running the following command:
Run
Connect-SPOService -Url <sharepoint admin URL> -Credential <credentials>
-
Enter the password in the password prompt.
-
Run
Get-SPOTenant
to view the tenant admin Settings. -
Locate the "DisableVivaConnectionsAnalytics" setting.
-
Enable or disable the setting by running the following command:
Run
Set-SPOTenant -DisableVivaConnectionsAnalytics $True
-
Run
Get-SPOTenant
to confirm the setting is updated.
You may see an error in the Analytics section. Review common errors to learn more about how to resolve them so you can download reports to view usage data for Viva Connections.
This message displays if there isn't enough usage data to generate a report. Finish setting up Viva Connections and try to access the report again. Learn more about how to set up Viva Connections.
:::image type="content" source="../media/connections/viva-connections-analytics/lack-of-data-error.png" alt-text="Screenshot showing error when there isn't enough usage data.":::
Sometimes due to connectivity issues or other technical problems, the analytics report may not be available. Check your network connection, refresh the page, and try loading the report again.
:::image type="content" source="../media/connections/viva-connections-analytics/general-error.png" alt-text="Screenshot showing a general error when there's a problem generating a report.":::
Within the downloaded Excel report, you may notice that certain sections aren't available due to insufficient usage data. Learn more about how to amplify your organization’s instance of Viva Connections and the available Microsoft Viva adoption resources.
You may get the following message: "Viva Connections usage data has been disabled for your organization by your administrator." This message means you won't be able to access usage reports unless your admin enables the feature for your organization.
:::image type="content" source="../media/connections/viva-connections-analytics/data-disabled-error.png" alt-text="Screenshot showing error received when reports have been disabled.":::