Clicked or tapped conversion metrics

Overview

This topic explains how to create a clicked or tapped metric in LaunchDarkly. Clicked or tapped metrics track how often an end user interacts with an element of your product's UI.

For example, you can use clicked or tapped metrics to track:

• How often a customer clicks a "Save" button when it is red, versus how often a customer clicks the "Save" button when it is blue
• How often a customer clicks the same "Save" button across different URLs by tracking URLs based on substrings or simple matches

Clicked or tapped metrics must be used with with JavaScript-based SDKs.

CSS selectors

CSS selectors designate specific areas of your product UI, like buttons or images, that your end users can interact with. You can create a metric that monitors interaction with one or more CSS selectors.

For example, some CSS selectors include:

• #example-element-id
• .example-classname
• button.example-button
• .example-button, .example-button-alt

The CSS selector must be present in your application after the end user interacts with it in order for LaunchDarkly to record the metric. For example, if the end user clicks an element that is dynamically removed from your application in response to the click, then LaunchDarkly will not record the metric event.

If the CSS selector will not be present after the end user interacts with it, we recommend using a custom conversion binary metric instead. To learn more, read Custom conversion binary metrics.

Metric definition

When you create a clicked or tapped conversion metric, you must first decide:

• What do you want to measure:
  • Count: the number of times a target was clicked.
  • Occurrence: whether or not a target was clicked.

Then, clicked or tapped conversion metric definition options include:

• Analysis method:
  • for metrics measuring count, you can you can analyze by:
    • Average: "average" is the default analysis method. For metrics you plan to use in funnel experiments, you must select "Average."
    • Percentile: you can choose between P50-P99, which represent the 50th through the 99th percentile.
  • for metrics measuring occurrence, the metric automatically sets the analysis method to "average."
• Randomization unit: one or more context kinds, such as "user," "device," or "request," that the metric can measure events from.

To learn more about the metric definition options, read Metric analysis.

Create clicked or tapped metrics

To create a clicked or tapped metric:

1. Navigate to the Metrics list.
2. Click Create metric. The "Create metric" dialog appears.
3. Select an event kind of Clicked or tapped.
4. Enter one or more CSS selectors in the Click targets field. If you include multiple CSS selectors, separate them with commas.
5. Specify the Target type you want to track behavior on. Expand the section below to view the four types of URL matching.

6. Enter the Target URL.
7. (Optional) Click Add target URL to track behavior on more than one URL.
8. Select what you want to measure:

• Count: the number of times a target was clicked or tapped.
• Occurrence: whether or not a target was clicked or tapped.

9. In the Metric definition section, select the following:
   • Analysis method:
     • If you selected Count in step 8, select Average or a percentile between P50-P99 click rate.
     • If you selected Occurrence in step 8, the metric automatically sets this to "Average."

• per or percentage of [randomization unit]: for clicked or tapped metrics, the randomization unit will usually be "user," "customer," or similar, representing an individual person.

10. Enter a metric Name.
11. (Optional) Add a Description.
12. (Optional) Add any Tags.
13. (Optional) Update the Maintainer.
14. Click Create metric.

After you create a metric, you can connect it to an experiment or use it to monitor the performance of flag changes. To learn how, read Creating experiments and Release Guardian.