LaunchDarkly
Step-by-step guide to send your event data from RudderStack to 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
Before configuring LaunchDarkly as a destination in RudderStack, verify if the source platform is supported by LaunchDarkly by referring to the table below:
Connection Mode | Web | Mobile | Server |
---|---|---|---|
Device mode | Supported | - | - |
Cloud mode | - | - | - |
To know more about the difference between cloud mode and device mode in RudderStack, refer to the RudderStack connection modes guide.
Once you have confirmed that your source platform supports sending events to LaunchDarkly, follow these steps:
From your RudderStack dashboard, add the source. From the list of destinations, select LaunchDarkly.
Assign a name to the destination and click on Next. You should then see the following screen:
Connection settings
The connection settings required to configure LaunchDarkly as a destination in RudderStack are listed below:
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 FAQs section below.
Identify
The identify
call lets you create a new user in LaunchDarkly or update an existing one.
A sample identify
call is as shown below:
The following table lists the supported fields for the traits
object in the identify
call:
Field | Type | Presence | Description |
---|---|---|---|
| Boolean | Optional | Must be set to |
| String | Optional | User's avatar image URL |
| String | Optional | Country associated with the user |
| Object | Optional | Additional attributes associated with the user |
| String | Optional | User's email address |
| String | Optional | User's first name |
| String | Optional | User's IP address |
| String | Optional | User's last name |
| String | Optional | User's full name |
| String Array | Optional | List of attribute names (built-in or custom) marked as private and not sent to LaunchDarkly as analytics events |
| String | Optional | User's secondary identifier |
If you have chosen to bucket the users by a specific attribute, the secondary
field can be used to further distinguish users who are otherwise identical as per that attribute.
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
.
Track
The track
call lets you record user events and send them to LaunchDarkly as custom conversion metrics for your experiments.
A sample track
call is as shown:
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:
FAQs
Where do I get the LaunchDarkly Client-side ID?
To get your LaunchDarkly client-side ID, follow these steps:
Log into your LaunchDarkly dashboard.
Select your project, as shown:
Then, navigate to Account settings - Projects.
You will see the client-side ID for your project here.
Contact us
For queries on any of the sections covered in this guide, you can contact us or start a conversation in our Slack community.
Last updated