Clicked or tapped conversion metrics

Overview

This topic explains how to create a clicked or tapped metric for use in LaunchDarkly experiments, guarded rollouts, or release policies. 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

LaunchDarkly’s observability features include a session replay plug-in that automatically tracks user clicks during a session recording. You can use the session replay click properties (clickSelector, clickContextContent, and clickTarget) to filter the sessions displayed in the Sessions tab of the LaunchDarkly UI. However, you cannot use those properties as events for creating new metrics.This topic describes how to instrument click or tapped events and metrics that you can use to create experiments or guarded rollouts.

Prerequisites

Clicked or tapped metrics are only compatible with the following JavaScript-based client SDKs:

Electron
JavaScript
Node.js (client-side)
React Web
Vue

If you do not use one of these SDKs and would like to track clicks or taps, use a custom conversion binary metric instead.

SDKs send events at regular intervals, such as every five seconds. If a browser redirects an end user to another page, any events that occurred between when the SDK last sent events and when the browser redirected will be lost. To avoid this, flush events when you know the browser will redirect an end user to another page, such as on click. To learn more, read Flushing events.

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 analyze by:
  - Average: “average” is the default analysis method. This method calculates the average number of clicks or taps per context. For metrics you plan to use in funnel metric groups, you must select “Average.”
  - Percentile: you can choose between P50-P99, which represent the 50th through the 99th percentile. This method counts the clicks or taps per context, then finds the number of clicks or taps that fall into the chosen percentile.
- for metrics measuring occurrence, the metric automatically sets the analysis method to “average.”
[analysis 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 components.

Create clicked or tapped metrics

To create a clicked or tapped metric:

Navigate to the Metrics list.
Click Create metric. The “Create metric” dialog appears.
If you use Snowflake native Experimentation, you have the option to select either LaunchDarkly hosted or Warehouse native. Select LaunchDarkly hosted.
Select an event kind of Clicked or tapped.
Enter one or more CSS selectors in the Click targets field. If you include multiple CSS selectors, separate them with commas.
Specify the Target type you want to track behavior on. Expand the section below to view the four types of URL matching.

Expand URL matching options

| URL matching schema| Description

Example

| ---| --- | | Simple match| This sends an event when the end user accesses a URL, or clicks on an element hosted at a URL, that matches the string you enter in the Target URL field or a formulation of that URL that included appended parameters. If you want events to record for URLs with substrings, specify each URL individually.| If you specify:

https://www.example.com