Set up account-level reporting

With account-level reporting, you can set up aggregated, group-level analyses. This article explains the setup steps for each data source.

Before you begin

Before you use account-level reporting, instrument groups in your Amplitude project.

After you instrument groups, supported charts include a group dropdown in the chart control panel. Use the dropdown to choose whether the chart counts events by users or groups.

Amplitude has a limit of five group types per project.

SDKs

Follow instructions for each Amplitude SDK to enable and configure account-level reporting.

Identify API

If you send data to Amplitude server-side, use the groups key in your identification object. The groups key associates a user with a group. For more information about instrumenting groups with the Identify API, refer to the Identify API documentation.

HTTP API

If you send data to Amplitude server-side, use the groups key in your event object. The groups key adds event-level groups that persist only on that event. For more information about instrumenting groups with the HTTP API, refer to the HTTP API documentation.

Segment

To set group types in Amplitude through Segment, enable these Amplitude destination settings and provide the relevant values:

• Group Type Trait: The trait in your Segment group calls that contains the group type.
• Group Value Trait: The trait in your Segment group calls that contains the group value.

You can set groups and group properties using Segment's group call. Refer to Segment integration for more information about instrumenting groups with Segment.

Create groups using the Group Identify API

Using the Group Identify API, you can create a new group with expected group properties or update group properties for an existing group. In the example requests, parameters and keys appear in italics. Replace the underlined values with the parameters you need.

For more information about instrumenting groups with the Group Identify API, review the Group Identify API documentation.