LaunchDarkly Audiences Destination

Destination Info
Partner Owned
  • This integration is partner owned. Please reach out to the partner's support for any issues.

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

  1. 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.
  2. 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 and updateIncluded to sync a segment from an Engage Audience. To learn how to create a service token, read Creating API access tokens.
  3. 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.
  4. Navigate to Engage > Engage Settings and click Destinations. Ensure you are still in the correct Engage space.
  5. Search for LaunchDarkly Audiences and select the destination. Click Add destination.
  6. On the Select Source screen, your Engage space should already be selected as the source. Click Confirm Source.
  7. On the Destination Settings tab, name your destination and provide your LaunchDarkly client-side ID and service token.
  8. Toggle Enable Destination on and click Save Changes.
  9. Navigate to the Mappings tab, click New Mapping, and select the Sync Engage Audience to LaunchDarkly pre-built mapping.
  10. Under Select mappings, modify the default mappings as needed. In most cases, you shouldn’t need to make any changes.
  11. Click Save.
  12. 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 createSegment and updateIncluded role actions.

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"

Click to show / hide fields

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



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