Custom Metrics

About Custom Metrics

Custom metrics are created in the dashboard’s settings. Custom metrics are equations which are created, by the user, using math symbols and the metrics of either a single data field or multiple data fields. This is important because you can create a single custom metric that can be used in a widget, which pulls in data from various data fields of the settings of a single dashboard.

Note that custom metrics are not project-wide; they will only be available in the dashboard where you created them and in copies of that dashboard.

Feature Availability

Custom metrics are only available in the following types of dashboards:

• CX Dashboards
• 360 Dashboards
• BX Dashboards

Creating a Custom Metric

1. Click the settings gear.
   
2. Go to Custom Metrics.
   
3. Click Add Custom Metric.
4. Click on the left text box to name your custom metric.
5. Click on Construct Your Equation to begin to create the equation of your new custom metric.
6. At this point you can begin to construct your equation. In most situations, you will want to begin with adding a metric. To do this, click on the blue button that says Add Metric.
   
7. By default, a count metric will automatically be added to your equation. If you wish to use a metric besides count, click on Count to bring up the metric editing menu.
   
8. In the metric editing menu, click on the Metric dropdown box to choose a different metric.
   Attention: Do not select Subset Ratio from the Metric dropdown when you create a Custom Metric. Instead, see the linked section in order to add a Subset Ratio Metric.
9. If a metric is chosen that requires an additional field, be sure to choose the correct field that you want to be calculated in your new custom metric.
   
10. Continue to construct the custom metric by clicking on the different mathematical symbols and metrics that are needed to create your desired equation.
    
    Qtip: If you see a red triangle with a “!” inside of it, this means that the equation is currently invalid. Check to make sure you do not have unnecessary mathematical symbols or two metrics next to each other that are not separated by a mathematical symbol. Both of these instances could cause the equation to be invalid.
11. Click Save when your equation is complete.
    

Adding a Custom Metric to a Widget

1. Click the page editing icon.
   
2. For a widget you want to add a custom metric to, enter the widget editing pane in one of the following manners: either create a new widget or click on the Edit button of a pre-existing widget.
3. When you are in the widget editing pane, click the Add button in the Metrics section.
   
4. By default, the metric will be count. Click on the Count metric.
5. Select the Metric dropdown.
6. Hover over Custom metrics.
7. Select the custom metric you want to report on.

Subset Ratio Metric

If you would like to display a proportion of values in a line, bar, or table widget, we recommend that you use a subset ratio metric instead of a custom metric. Subset ratios are especially useful in Brand Experience dashboards and can help reduce load times.

Keep in mind that when selecting the numerator and denominator for the ratio, each respective field will be independent. The numerator will represent one count metric, regardless of the denominator you choose (although they can be related), and vice versa. In other words, the subset ratio metric can be thought of as (Item 1 count) / (Item 2 count), where Item 2 does not automatically tie Item 1 to the proportion.

When reporting on imagery attributes in line and bar charts, the base size needs to be set to the number of people who are aware of the brand. For example, you may want to create a custom metric that takes the number of people who selected a specific brand in an attribute question and divide by the number of respondents aware of the brand. The subset ratio metric makes it easy to calculate this proportion by automatically selecting the correct numerator and denominator.

Adding a Subset Ratio Metric to a Widget

1. Click the edit icon to start editing your dashboard.
2. Either add a new widget or click on the Edit button of a pre-existing widget.
   Qtip: The metric setup for line, bar, and table widgets will be the same.
3. When you are in the widget editing pane, click the Add button in the Metrics section.
4. The default metric is count. Click on the Count metric.
5. Under Metric, choose Subset Ratio.
6. Select your Numerator Field.
   Qtip: The numerator field should be the present values. In a Brand Experience project, this will be one of the imag questions.
7. Choose your Numerator Field Data.
   Qtip: These values will help you visualize the number of people who selected a specific answer choice. For example, we would choose the specific brands we’d like to analyze, Gartells and Jones.
8. Select the Denominator Field.
   Qtip: The denominator field should be the total values. In a Brand Experience project, this will be the aided question.
9. Choose the Denominator Field Data.
   Qtip: These values will help you visualize the number of people who were aware of a specific answer choice. For example, we would choose the same brands as the numerator values, Gartells and Jones.

Attention: If you are applying the subset ratio metric to a table widget, make sure to adjust the Decimal Places in the Options menu when configuring your metric. This will ensure that you can properly view the subset ratio in your widget.

Compatible Widgets

Below is a list of widgets that have a metrics field. If a widget has a metrics field, you can add your custom metric to it.

• Line
• Vertical bar
• Horizontal bar
• Table
• Number chart
• Donut / pie chart
• Gauge chart

Editing a Custom Metric on a Widget

1. Click to edit the widget.
2. Click on the custom metric in the Metrics section of the widget editing pane.
3. In the first tab named Metric, the label of the metric can be renamed.
   
4. In the second tab named Options, you can change the format and the amount of decimal places used when the metric is displayed in the widget. The three formats are number, percent, and currency.
   
5. In the Filters tab you can add a filter.
   Qtip: Please note that custom metric filters, much like regular metric filters, will override both page level filters and widget filters.

   

FAQs