LaunchDarkly (Actions) Destination

LaunchDarkly is a feature management platform that empowers development teams to safely deliver, control, and measure their software through feature flags.

With LaunchDarkly, you can run experiments on any feature flag. This destination allows you to connect existing Segment events to LaunchDarkly custom metrics for use in LaunchDarkly experiments.

Good to know: This page is about the Actions-framework LaunchDarkly Segment destination. There’s also a page about the non-Actions LaunchDarkly destination. Both of these destinations receives data from Segment.

Analytics.js 2.0

Actions-based destinations may require features found in Analytics.js 2.0. If the destination has Web actions and is connected to a javascript source, upgrade your Analytics.js source to ensure compatibility.

Benefits of LaunchDarkly (Actions) vs LaunchDarkly Classic

LaunchDarkly (Actions) provides the following benefits over the classic LaunchDarkly destination:

  • Improved customization. You determine the mapping between the data Segment receives from your source and the data Segment sends to LaunchDarkly. For example, you can map an arbitrary event property to the LaunchDarkly metric key.
  • Increased transparency. You can see the data that is sent to LaunchDarkly and when Segment sends it. Additionally, you can subscribe to alerts when the delivery rate to LaunchDarkly dips below a configurable threshold.

Getting started

To get started with LaunchDarkly (Actions):

  1. In LaunchDarkly, navigate to Account settings and copy the client-side ID for the project and environment that you would like to connect to Segment.
  2. From the Segment web app, click Catalog, then click Destinations.
  3. Search for LaunchDarkly (Actions) and select it.
  4. Click Configure LaunchDarkly.
  5. Select the Source you want to connect to LaunchDarkly (Actions).
  6. Paste the LaunchDarkly client-side ID you copied in step 1 into the LaunchDarkly client-side ID field on the destination settings page.

Destination Settings

Setting Description
LaunchDarkly client-side ID Required.

Find and copy the client-side ID in the LaunchDarkly account settings page.

Available Actions

Build your own Mappings! Combine supported triggers with the following LaunchDarkly-supported actions:

Alias User

Alias an anonymous user with an identified user key.

Alias User is a Cloud action.

Click to show / hide fields

Field Description
User key* Type: STRING

The user’s unique key.

Anonymous ID* Type: STRING

The user’s previously used anonymous user key.

Event Timestamp Type: DATETIME

The time when the event happened. Defaults to the current time.

Track Event

Track custom user events for use in A/B tests and experimentation.

Track Event is a Cloud action.

Click to show / hide fields

Field Description
User Key* Type: STRING

The user’s unique key.

Event Name* Type: STRING

The name of the event to track. This name typically corresponds to a LaunchDarkly metric with the same key.

Metric Value Type: NUMBER

The numeric value associated with the event. This value is used by the LaunchDarkly experimentation feature in numeric custom metrics, and will also be returned as part of the custom event for Data Export.

Event Properties Type: OBJECT

Optional object containing the properties for the event being tracked. These properties assist with observational analytics for LaunchDarkly Data Export destinations. These properties are not saved to the LaunchDarkly user.

Event timestamp Type: DATETIME

The time when the event happened. Defaults to the current time

Creating LaunchDarkly metrics

In order to take full-advantage of the LaunchDarkly (Actions) Destination, you need to create metrics in LaunchDarkly that correspond to Segment track events. Read Creating metrics to learn how to create metrics in LaunchDarkly.

Migration from the classic LaunchDarkly destination

Be sure to disconnect the classic LaunchDarkly destination before enabling the LaunchDarkly (Actions) destination to avoid duplicate experimentation events in LaunchDarkly.

This page was last modified: 19 May 2022



Get started with Segment

Segment is the easiest way to integrate your websites & mobile apps data to over 300 analytics and growth tools.
or
Create free account