LaunchDarkly Audiences 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 release features that target specific groups, such as beta users, and premium accounts, using segments. This destination allows you to sync Engage Audiences to LaunchDarkly segments, letting you concentrate more on deploying features and less on managing end users between platforms.
LaunchDarkly maintains this destination. For any issues with the destination, contact the LaunchDarkly Support team.
Getting started
- In LaunchDarkly, navigate to Account settings and copy the client-side ID for the project and environment where you would like to create an Engage Audience synced segment.
- In LaunchDarkly, create a service token with either a Writer role or a custom role. If your service token has a custom role, it must have the actions
createSegment
andupdateIncluded
to sync a segment from an Engage Audience. To learn how to create a service token, read Creating API access tokens. - From the Segment web app, navigate to Engage > Audiences. Ensure you are in the Engage space you plan to use with the LaunchDarkly Audiences destination. Either choose an existing Engage audience or create a new one. This is the audience you plan to sync with LaunchDarkly.
- Navigate to Engage > Engage Settings and click Destinations. Ensure you are still in the correct Engage space.
- Search for
LaunchDarkly Audiences
and select the destination. Click Add destination. - On the Select Source screen, your Engage space should already be selected as the source. Click Confirm Source.
- On the Destination Settings tab, name your destination and provide your LaunchDarkly client-side ID and service token.
- Toggle Enable Destination on and click Save Changes.
- Navigate to the Mappings tab, click New Mapping, and select the Sync Engage Audience to LaunchDarkly pre-built mapping.
- Under Select mappings, modify the default mappings as needed. In most cases, you shouldn’t need to make any changes.
- Click Save.
- Ensure the Status toggle on the Mappings tab is enabled.
Destination Settings
Setting | Description |
---|---|
LaunchDarkly Service Token | Required. We recommend creating a dedicated LaunchDarkly service token for this destination. The service token must have the ability to perform the |
LaunchDarkly client-side ID | Required. Copy the client-side ID of the environment for your segment. You can find this in the LaunchDarkly Account settings page for your project. |
Available Presets
LaunchDarkly Audiences has the following presets:
Preset Name | Trigger | Default Action |
---|---|---|
Sync Engage Audience to LaunchDarkly | Event type = "identify" Event type = "track" |
Sync Audience |
Available Actions
Build your own Mappings. Combine supported triggers with the following LaunchDarkly Audiences-supported actions:
Mapping limits per destination
Individual destination instances have support a maximum of 50 mappings.
Sync Audience
Sync Engage Audiences to LaunchDarkly segments
Sync Audience is a Cloud action. The default Trigger is: type = "identify" or type = "track"
Field | Description |
---|---|
Audience ID* | Type: STRING Segment Audience ID to which user identifier should be added or removed |
Audience Key* | Type: STRING Segment Audience key to which user identifier should be added or removed |
Segment Computation Action* | Type: STRING Segment computation class used to determine if input event is from an Engage Audience’. Value must be = ‘audience’. |
Context kind* | Type: STRING The event’s context kind. To learn more about context kinds and where you can find a list of context kinds LaunchDarkly has observed, read Context kinds. |
Segment User ID | Type: STRING The Segment userId value. |
Segment Anonymous ID | Type: STRING The Segment anonymousId value. |
Email address | Type: STRING The user’s email address |
Context key* | Type: STRING The unique LaunchDarkly context key. In most cases the Segment UserId should be used. |
Traits or properties object* | Type: OBJECT A computed object for track and identify events. This field should not need to be edited. |
Batch events | Type: BOOLEAN When enabled, the action will batch events before sending them to LaunchDarkly. In most cases, batching should be enabled. |
Audience Action | Type: STRING Indicates if the user will be added or removed from the Audience |
Engage
You can send computed traits and audiences generated using Engage to this destination as a user property. To learn more about Engage, schedule a demo.
For user-property destinations, an identify call is sent to the destination for each user being added and removed. The property name is the snake_cased version of the audience name, with a true/false value to indicate membership. For example, when a user first completes an order in the last 30 days, Engage sends an Identify call with the property order_completed_last_30days: true
. When the user no longer satisfies this condition (for example, it’s been more than 30 days since their last order), Engage sets that value to false
.
When you first create an audience, Engage sends an Identify call for every user in that audience. Later audience syncs only send updates for users whose membership has changed since the last sync.
Real-time to batch destination sync frequency
Real-time audience syncs to LaunchDarkly Audiences may take six or more hours for the initial sync to complete. Upon completion, a sync frequency of two to three hours is expected.
Settings
Segment lets you change these destination settings from the Segment app without having to touch any code.
Setting | Description |
---|---|
LaunchDarkly Service Token (required) |
password . We recommend creating a dedicated LaunchDarkly service token for this destination. The service token must have the ability to perform the createSegment and updateIncluded role actions. |
LaunchDarkly client-side ID (required) |
string . Copy the client-side ID of the environment for your segment. You can find this in the LaunchDarkly Account settings page for your project. |
This page was last modified: 12 Dec 2023
Need support?
Questions? Problems? Need more info? Contact Segment Support for assistance!