LaunchDarkly

This page describes how to use Census with LaunchDarkly.

Getting Started

1. Click Add Service and select LaunchDarkly from the menu.

2. Open the LaunchDarkly app in another window to find the following credentials:

Service Access Token

You'll need to create a new access token with the appropriate set of permissions. To learn how to create a service token, see Creating API access tokens in LaunchDarkly's documentation.

1. Visit Account settings > Authorization and click Create token.

2. For your new access token, give it a memorable name such as Census LaunchDarkly Integration.

3. For role, you can use any existing role or custom policy that has the following permissions. Alternatively, select Inline policy. You can add multiple statements, one for each of the types of resources you intend to use with Census

   • Synced Segments

     • Resource: proj/*:env/*:segment/* will grant access to all segments across all projects.

     • Action: createSegment and updateIncluded

   • Metric Events

     • Resource: proj/*:env/* will grant access to all projects.

     • Action: importEventData

   • Metrics

     • Resource: proj/*:metric/* will grant access to all metrics across all projects (Metrics are not specific to an environment).

     • Action: All Actions (See Full List)

4. Check the box next to This is a service token. You can leave the API version set to the default value.

5. Click Save Token. Copy store the token generated somewhere safe while you're connecting it to Census. You will not be able to retrieve it again.

The above definition can also be modified using the Advanced Editor

[
  {
    "resources": ["proj/*:env/*:segment/*"],
    "actions": ["createSegment","updateIncluded"],
    "effect": "allow"
  },
  {
    "resources": ["proj/*:env/*"],
    "actions": ["importEventData"],
    "effect": "allow"
  },
  {
    "resources": ["proj/*:metric/*"],
    "actions": ["*"],
    "effect": "allow"
  }
]

Project Key, Environment Key, and Environment ID

Go to Account settings > Projects and copy the Project Key, Environment Key, and Environment ID (LaunchDarkly uses Environment ID and Client-side ID interchangeably) as shown in the screenshot below. You will need to create separate Environment Keys for each Environment you wish to sync to.

Supported Objects and Sync Behaviors

Object Name	Supported?	Sync Keys	Behaviors
Metric	✅	Key	Update or Create
Metric Event	✅	N/A	Send
Synced Segments	✅	User ID	Mirror

Learn more about all of our sync behaviors in our Syncs documentation.

Contact us if you want Census to support more LaunchDarkly objects and/or behaviors.

Metrics

Metrics measure audience behaviors affected by the flags in your experiments. You can use metrics to track all kinds of things, from how often customers access a URL to how long that URL takes to load a page, etc

You can use Census to both Create or Update Metric definitions, or also send Metric Events in order to log data points that you've captured separately from your typical LaunchDarkly metric path.

Synced Segments

Census supports LaunchDarkly's Synced Segments with audience syncs. You can use Census to send any of your segments to LaunchDarkly. Synced Segments are very straightforward, with only two details you need to consider:

• ID - This whatever Identifier you use with LaunchDarkly to identify those context types. This could be your internal ID for a user or their email address. LaunchDarkly will happily accept whatever value you send here but in order for the segment to be useful, it must match the ID you are using with LaunchDarkly.

• Context - This is the "type" of things in your segment. It can be the standard LaunchDarkly contexts such as Users or Companies, or any custom context you have created.

Need help connecting to LaunchDarkly?

Contact us via [e-mail] or start a conversation with us via the in-app chat.