No results for ""
EXPAND ALL
  • Home
  • API docs

Metric groups

Read time: 2 minutes
Last edited: Dec 03, 2024

Overview

This topic explains what metric groups are and when to use them. A metric group is a reusable list of metrics you can use to standardize metrics across multiple flags or experiments.

For example, if you have a standard user sign-up flow, you could create four metrics that track customers clicking the sign up button, entering their personal information, adding payment information, and clicking the submit button. By combining these four metrics into a funnel metric group, you can then attach that group to all of your sign-up funnel experiments, ensuring you're tracking the correct metrics for each step within each funnel.

You can view your metric groups from the Metrics list:

The Metrics list.
The Metrics list.

To learn how to create and manage metric groups, read Creating and managing metric groups.

Metric group types

There are two types of metric groups: funnel metric groups and standard metric groups.

Funnel metric groups

Funnel metric groups are for use with funnel optimization experiments. A "funnel" is a marketing model that describes a customer's journey through your purchasing or conversion cycle, typically from the awareness stage to the purchasing stage. LaunchDarkly's funnel optimization experiments use multiple metrics to track the performance of each of the steps in your funnel over time.

The order of metrics within funnel metric groups affects how LaunchDarkly analyzes the metrics. When you create a funnel metric group, each metric should measure a required step in the user journey. Users should not be able to skip any steps the funnel group is measuring, or take any steps out of order. Doing so will skew your experiment results.

To include a metric in a funnel metric group, the metric must:

  • have a custom conversion binary, clicked or tapped, or page viewed type
  • use the "Occurrence" measurement method

You cannot include custom numeric metrics or custom conversion count metrics in a funnel metric group, and you cannot include any metrics that use the "Count" or "Value/size" measurement method in a funnel metric group.

To learn more, read Creating funnel experiments.

You cannot use funnel metric groups in feature change experiments. Instead, use a standard metric group.

Standard metric groups

Standard metric groups are for use with feature change experiments and guarded rollouts. Metrics in standard metric groups can appear in any order. To learn more, read Creating feature change experiments and Guarded rollouts.

You can also use the REST API: List metric groups

View a metric group

To view a metric group's details page, click on the metric group's name from the Metrics list. The metric group details page displays all of the metrics in the group.

The "Metric group connections" section includes information on any experiments or flags the metric group is connected to:

A metric group details page.
A metric group details page.

You can also use the REST API: Get metric group