LaunchDarkly

LaunchDarkly is a popular feature management platform that offers cutting-edge A/B testing and experimentation functionalities. It lets you efficiently automate and manage feature flags and improve overall product workflow and software quality.

RudderStack supports LaunchDarkly as a destination to which you can seamlessly send your data for flag management.

Getting started

RudderStack supports sending event data to LaunchDarkly via the following connection modes:

In a web device mode integration, that is, using JavaScript SDK as a source, the LaunchDarkly native SDK is loaded from https://unpkg.com/ domain. Based on your website’s content security policy, you might need to allowlist this domain to load the LaunchDarkly SDK successfully.

Once you have confirmed that the source platform supports sending events to LaunchDarkly, follow these steps:

1. From your RudderStack dashboard, add a source. Then, from the list of destinations, select LaunchDarkly.
2. Assign a name to the destination and click Continue.

Connection settings

To successfully configure LaunchDarkly as a destination, you will need to configure the following settings:

• Client-side ID: Enter the client-side ID of your LaunchDarkly project.

For more information on getting the LaunchDarkly client-side ID, refer to the FAQ section below.

Identify

The identify call lets you create or update a user in LaunchDarkly.

You must call identify before making any track or alias calls.

A sample identify call is as shown below:

rudderanalytics.identify(
  "1hKOmRA4GRlm", {
    anonymous: false,
    avatar: "https://avatarfiles.alphacoders.com/837/83744.jpg",
    country: "USA",
    custom: {
      favourite_color: "black"
    },
    email: "alex@example.com",
    firstName: "Alex",
    ip: "12.23.34.45",
    lastName: "Keener",
    name: "Alex Keener",
    privateAttributeNames: ["avatar", "country"],
    secondary: "abcd21234"
  }
);

LaunchDarkly key

RudderStack assigns the userId to LaunchDarkly’s key field to uniquely identify a user.

key is the only required field in LaunchDarkly’s identify call. If no unique identifier is provided, RudderStack will automatically assign anonymousId as key.

Supported traits

The following table lists the supported fields for the traits object in the identify call:

If you have chosen to bucket the users by a specific attribute, the secondary field can be used to further distinguish the users who are otherwise identical as per that attribute.

Track

The track call lets you record user events and send them to LaunchDarkly as custom conversion metrics for your experiments.

As mentioned above, you must call identify before sending any track events to LaunchDarkly.

A sample track call is as shown:

rudderanalytics.track("Test Event", {
  foo: "bar"
});

Alias

The alias call lets you merge different identities of a known user. You can explicitly change the identity of a user via this call.

A sample alias call is shown below:

rudderanalytics.alias("newUserId","userId");

FAQ

Where do I get the LaunchDarkly Client-side ID?

To get your LaunchDarkly client-side ID, follow these steps:

1. Log into your LaunchDarkly dashboard.
2. Select your project:

3. Then, navigate to Account settings > Projects.
4. You will see the client-side ID for your project here.

Questions? Contact us by email or on Slack