Loading...
  • Customer Experience
    Customer Experience
  • Employee Experience
    Employee Experience
  • Brand Experience
    Brand Experience
  • Product Experience
    Product Experience
  • Core XM
    Core XM

Calculate Metric Task

What's on This Page:


Was this helpful?


The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!


About the Calculate Metric Task

The calculate metric task in Actions allows you to trigger a response to aggregate metrics observed in a dataset over a period of time. In other words, it provides a way to set up automated workflows based on trends or events you observe in experience data. The results of your calculate metric task can be used to trigger  other tasks within your workflow. For example, you could use the calculate metric task to notify your marketing team’s Slack channel when your brand NPS dips by 10% within a period of a week, or you could create a follow-up ticket for your team if more than 100 opt-outs occurred from XM Directory within a week.

Setting Up a Calculate Metric Task

  1. Follow the directions to set up a scheduled action.
  2. Click Add new to create a task.Add new button highlighted with Task below
  3. Select Calculate metric.Calculate metric task selection
  4. Select your Data Source. Here, you’ll specify the Source, the Metric Type, and the Metric Field.Calculate metric window with Data Source, Calculation Type, Filters, and the Save Button
    • Source: The survey that hosts the data you will be calculating your metric from. All of your available surveys will appear in the dropdown.
    • Metric Type: The type of metric you’ll be calculating based on. Choose from the following metric types:
      • Count of records: Display response counts from the selected fields (i.e., number of respondents choosing a value in a five-point scale).
      • Average: Exhibit the average value for a selected field.
      • NPS: Net Promoter Score. Identify the Detractors, Passives, and Promoters from NPS questions.
    • Metric Field: The specific field or question you will be calculating your metric on.
  5. Choose the Calculation Type. Calculation Types:
    • Single Time Period: The metric will be calculated using data from the chosen time period.Single Time Period section underneath Calculation type
    • Change over a period of time: You will be asked to set an initial period and a time period to compare it to. This will show a comparison of the metric’s relative change from the specified time period to the present.Change over a period of time under calculation type
  6. If desired, add Filters. This can be used if you’d like to have the metric calculate on a subset of your data. You can filter based on one of the data source’s survey questions or one of your survey’s Embedded Data fields. For more information on setting conditions in filters, visit Creating Conditions.Filters conditions are specified with the Save button indicated at the bottom
    Attention: Some of the resources for condition-building use examples in data filtering instead of Actions. However, the logic behind these conditions are the same.
  7. Click Save.
Attention: After completing the above steps, you must create subsequent tasks in order to use the results of the calculate metric task.

Adding Subsequent Tasks & Conditions

After setting up your calculate metric task, add subsequent tasks and conditions in order to use the results of your calculations.

Qtip: It is not necessary to create a condition underneath a calculate metric task. For example, if you wanted to create a weekly report with the results of your calculate metric task, you wouldn’t need to add a condition.
  1. If desired, click Add new to create a Condition underneath your calculate metric task.Clicking Add New underneath the calculate metric task in order to create a condition.
  2. Click Condition to begin specifying your conditionsClicking condition under the Any of the following are true dropdown.
  3. Click Select Condition Type and select Tasks.Condition has been created, with Tasks, T2 Calculate metric, and Select option Dropdown selected
  4. Click Select Action to select the Calculate metric task.
  5. Click Select Option to select the desired calculation period or change.
  6. If desired, Add new subsequent tasks to be triggered based on your Calculate metric condition.Adding additional tasks with the Add New button
    Qtip: Each task will be labeled with a unique ID (e.g., “T2”) for easier identification and organization. If you add a Calculate metric task after an email task, but you are piping the results of the calculate metric task into your email task, the tasks will be automatically reordered so that they are in the correct order.T1 and T2 indicating when the tasks will be triggered
Qtip: You can also use piped text to report the results from the calculate metric task in subsequent tasks. For example, if you wanted to include information about your calculate metric task in a subsequent email task, the results from the calculate metric task will be available in the piped text portion of the rich content editor.Rich Content Editor and the calculate metric piped text

When Calculate Metric Tasks Are Completed

All types of survey responses can cause changes to the metrics calculated in a Calculate metric task. This will cause subsequent tasks to trigger under certain conditions.

  • Initial period: If you configure your calculate metric task with the Change over a period of time option, this will be the output values from the initial time period you set in your task.
  • Subsequent period: If you configure the calculate metric task with the Change over a period of time option, this is the group of output values from the second time period you set in your task.
  • Absolute change: The aggregate data from the first time period subtracted from the aggregate from the second time period.
  • Relative change (percent): The aggregate data from the first time period subtracted from the aggregate from the second time period, divided by your aggregate from the second time period.
Qtip: If you decide to select either the Initial or Subsequent period, you can then select to use the Count, NPS, or Standard Deviation as your metric.Additional options when hovering over the Initial and Subsequent Period metric
Attention: Once an action is completed, the scheduled task will not be able to be deleted. For example, if a response just submitted meets the condition of an email task, and you go to delete the email task, the email for that response is still scheduled.

Troubleshooting Calculate Metric Tasks

This section has links to additional resources that can help you troubleshoot issues related to email tasks.

Qtip: Some of the resources for condition-building use examples in data filtering instead of Actions. However, the logic behind these conditions are the same.