New Chat Usage Analytics Updates for Admins and Developers

Written by Alfonso Martinez | Feb 21, 2025 6:34:00 PM

What’s changing

In December 2024, we introduced new, detailed usage reports for Google Chat. These reports help admins better understand how their teams are using Chat, allowing them to analyze engagement, drive adoption, configure safety features, and more. These reports aggregate data at the group and organization level, to provide relevant insights for Workspace admins while protecting individual privacy.

Starting today, customerUsageReports.get and userUsageReports.get for Google Chat are available via the Admin SDK Reports API for customers to use in their own customized dashboards and reporting tools. This gives admins more ways to analyze Chat usage data.

Please refer to the table below to learn about the metrics available to you:

Category	Variations
# of messages sent by users of the organization	Total number of messages
	Messages sent by conversation type (direct message, group chat, space)
	Messages sent by type (regular, voice, video, huddle)
	Messages sent with or without attachment
	Messages sent to conversations that contain or do not contain external users.
# of spaces owned by organization	Number of active spaces
# of spaces owned by organization	Number of spaces created
# of active users in your organization by level of activity	Number of engaged users (read at least one conversation or sent messages or reactions)
# of active users in your organization by level of activity	Number of communicator users (sent at least one message or reaction)
# of actions by specific users*	Number of messages and reactions sent Number of attachments uploaded Number of spaces created Number of conversations read

Most metrics are available for periods of 1, 7, and 28 days.

*Available for 28 days only

Additional details

We’ve also added four new fields and one additional event available in Chat Audit Logs and surfaced in the Security Investigation Tool. In addition to providing even more context on Chat usage, admins can leverage these additional data points in their own custom reporting.

The fields are:

Conversation ownership indicates whether the conversation, where a specific Chat event occurs, is owned by the organization or by an external entity. These possible values include:

Internally owned: conversation is owned by the admin’s organization
Externally owned: conversation is owned by an external entity

Conversation type indicates the type of conversation where the event occurs:

User-to-user direct message
User-to-app direct message
Group chat
Space

Message type indicates type of the message in Message sent and Message edited events:

Regular message
Voice message
Video message
Huddle

Attachment status indicates whether the message was sent with an attachment (image or file):

Has attachment
No attachment

Additionally, we’ve added a new event, “Conversation Read”. Every time a user opens a conversation and reads one or more unread messages, an event will be logged.

Getting started

Admins: Visit the Help Center to learn more about understanding Chat usage with analytics, viewing Apps reports for your organization and using the security investigation tool.
Developers: Check out our developer documentation for more information on Chat Audit Activity Events. and CustomerUsageReports.get and UserUsageReport.get.

Rollout pace

Available now.

Availability

New Chat usage metrics in Report API are available for all Google Workspace customers.
The security investigation tool is available for Google Workspace

Enterprise Standard and Plus
Education Standard and Plus
Enterprise Essentials Plus
Frontline Standard
And Cloud Identity Premium customers

Resources

View full post