New Chat Usage Analytics Updates for Admins and Developers
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:CategoryVariations# of messages sent by users of the organizationTotal number of messagesMessages sent by conversation type (direct message, group chat, space)Messages sent by type (regular, voice, video, huddle)Messages sent with or without attachmentMessages sent to conversations that contain or do not contain external users.# of spaces owned by organizationNumber of active spacesNumber of spaces created# of active users in your organization by level of activityNumber of engaged users (read at least one conversation or sent messages or reactions)Number of communicator users (sent at least one message or reaction)# of actions by specific users*Number of messages and reactions sentNumber of attachments uploadedNumber of spaces createdNumber of conversations readMost metrics are available for periods of 1, 7, and 28 days.*Available for 28 days onlyAdditional detailsWe’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 organizationExternally owned: conversation is owned by an external entityConversation type indicates the type of conversation where the event occurs:User-to-user direct messageUser-to-app direct messageGroup chatSpaceMessage type indicates type of the message in Message sent and Message edited events:Regular messageVoice messageVideo messageHuddleAttachment status indicates whether the message was sent with an attachment (image or file):Has attachmentNo attachmentAdditionally, 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 startedAdmins: 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 paceAvailable now.AvailabilityNew Chat usage metrics in Report API are available for all Google Workspace customers.The security investigation tool is available for Google WorkspaceEnterprise Standard and PlusEducation Standard and PlusEnterprise Essentials PlusFrontline StandardAnd Cloud Identity Premium customersResourcesDeveloper documentation: Reports API OverviewDeveloper Documentation: Google Chat Parameters: CustomerUsageReports.getDeveloper Documentation: Google Chat PArameters: UserUsageReport.getDeveloper Documentation: Chat Audit Activity EventsDeveloper Documentation: Admin SDK API developer platform release notesGoogle Workspace Admin Help: Understand Chat usage with analyticsGoogle Workspace Admin Help: View Apps reports for your organizationGoogle Workspace Admin Help: About the security investigation toolWorkspace Updates Blog: New Google Chat usage reports provide deeper insights into user engagement
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 |
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) |
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
Developer Documentation: Google Chat Parameters: CustomerUsageReports.get
Developer Documentation: Google Chat PArameters: UserUsageReport.get
Developer Documentation: Admin SDK API developer platform release notes
Google Workspace Admin Help: Understand Chat usage with analytics
Google Workspace Admin Help: View Apps reports for your organization
Google Workspace Admin Help: About the security investigation tool
Workspace Updates Blog: New Google Chat usage reports provide deeper insights into user engagement
.png)
