Merge pull request #1052 from segmentio/launchdarkly-subscription-docs

Launchdarkly subscription docs

Author: pauljaeinyoo

src/_data/catalog/destination_categories.yml

@@ -1,5 +1,5 @@
 # AUTOGENERATED FROM PLATFORM API. DO NOT EDIT
-# destination categories last updated 2020-08-11 
+# destination categories last updated 2020-08-12 
 items:
 - display_name: Email Marketing
   slug: email-marketing

src/_data/catalog/destinations.yml

@@ -1,5 +1,5 @@
 # AUTOGENERATED FROM PLATFORM API. DO NOT EDIT
-# destination data last updated 2020-08-11 
+# destination data last updated 2020-08-12 
 items:
 - display_name: ActiveCampaign
   slug: activecampaign
@@ -11919,6 +11919,61 @@ items:
       server: true
   previous_names:
   - Kustomer
+- display_name: LaunchDarkly-subscription
+  slug: launchdarkly-subscription
+  name: catalog/destinations/launchdarkly-subscription
+  description: >-
+    This destination sends track events to LaunchDarkly experiments.
+    LaunchDarkly is a feature management platform that empowers development
+    teams to safely deliver and control software through feature flags. 
+  hidden: false
+  url: connections/destinations/catalog/launchdarkly-subscription
+  status: PUBLIC_BETA
+  logo:
+    url: >-
+      https://public-segment-devcenter-production.s3.amazonaws.com/9d3b780d-d6a6-413d-b606-49ce7b9af1a9.svg
+  mark:
+    url: >-
+      https://public-segment-devcenter-production.s3.amazonaws.com/e15902da-fbab-4789-82a0-09da26f51d8a.svg
+  categories:
+  - A/B Testing
+  - Analytics
+  components: []
+  platforms:
+    browser: true
+    server: true
+    mobile: true
+  browserUnbundlingSupported: false
+  browserUnbundlingPublic: false
+  methods:
+    alias: false
+    group: false
+    identify: false
+    page_view: false
+    track: true
+  settings:
+  - name: apiKey
+    display_name: API Key
+    type: STRING
+    deprecated: false
+    required: true
+    string_validators:
+      regexp: '^.{8,}$'
+    description: >-
+      Generate a token in the Authorization tab in LaunchDarkly Account
+      Settings.
+    settings: []
+  connection_modes:
+    device:
+      web: false
+      mobile: false
+      server: false
+    cloud:
+      web: false
+      mobile: false
+      server: false
+  previous_names:
+  - LaunchDarkly-subscription
 - display_name: Lazy Lantern
   slug: lazy-lantern
   name: catalog/destinations/lazy-lantern
@@ -17044,6 +17099,13 @@ items:
       required: false
       description: Map your Segment properties to Responsys Columns
       settings:
+      - name: primaryKey
+        display_name: Set as Primary Key
+        type: BOOLEAN
+        deprecated: false
+        required: false
+        description: Mark this property as a Primary Key in Responsys.
+        settings: []
       - name: columns
         display_name: Segment Property Name
         type: STRING
@@ -17079,13 +17141,6 @@ items:
           - TIMESTAMP
         description: Enter the Responsys column type.
         settings: []
-      - name: primaryKey
-        display_name: Set as Primary Key
-        type: BOOLEAN
-        deprecated: false
-        required: false
-        description: Mark this property as a Primary Key in Responsys.
-        settings: []
     - name: mapEmail
       display_name: Map Email
       type: BOOLEAN

src/_data/catalog/source_categories.yml

@@ -1,5 +1,5 @@
 # AUTOGENERATED FROM PLATFORM API. DO NOT EDIT
-# source cateogries last updated 2020-08-11 
+# source cateogries last updated 2020-08-12 
 items:
 - display_name: Server
   slug: server

src/_data/catalog/sources.yml

@@ -1,5 +1,5 @@
 # AUTOGENERATED FROM PLATFORM API. DO NOT EDIT
-# sources last updated 2020-08-11 
+# sources last updated 2020-08-12 
 items:
 - display_name: .NET
   slug: net

src/connections/destinations/catalog/launchdarkly-subscription/index.md

@@ -0,0 +1,58 @@
+---
+title: LaunchDarkly Events Destination
+rewrite: true
+---
+LaunchDarkly is a feature management platform that empowers development teams to safely deliver and control software through feature flags.
+
+LaunchDarkly users can run experiments on any feature flag, with custom events as metrics. You can look for an existing custom event from Segment, and start recording data against it as a metric in your LaunchDarkly experiment.
+
+This destination is maintained by LaunchDarkly. For any issues with the destination, [contact the LaunchDarkly support team](mailto:[email protected]).
+
+## Getting Started
+
+{% include content/connection-modes.md %}
+
+1. From the Destinations catalog page in the Segment App, click **Add Destination**.
+2. Search for “LaunchDarkly” in the Destinations Catalog, and select the LaunchDarkly destination.
+3. Choose which Source should send data to the LaunchDarkly destination.
+4. Go to the LaunchDarkly [Account Settings](https://app.launchdarkly.com/settings/projects), and find and copy the client-side ID from your default project.
+5. Enter this ID as the **API Key** in the “LaunchDarkly” destination settings in Segment.
+
+## Track
+If you aren't familiar with the Segment Spec,  take a look at the [Track method documentation](https://segment.com/docs/connections/spec/track/) to learn about what it does. An example call would look like:
+
+```json
+{
+  "anonymousId": "23adfd82-aa0f-45a7-a756-24f2a7a4c8955",
+  "type": "track",
+  "properties": {
+    "value": 99.84,
+  },
+  "userId": "test-user-s6dndc",
+  "event": "Order Completed"
+}
+```
+
+LaunchDarkly ingests that call as:
+
+```json
+{
+  "kind": "custom",
+  "key": "Order Completed",
+  "userKey": "userId",
+  "creationDate": 1592588370692,
+  "metricValue": 99.84,
+  "data": {
+    "value": 99.84,
+  }
+}
+```
+
+> note ""
+> **Note**: The LaunchDarkly Metric must be actively recording and have a Feature Flag attached for Segment events to appear in your LaunchDarkly Project.
+
+Segment sends Track calls to LaunchDarkly as a `track` event. It appears on your [Debugger page](https://app.launchdarkly.com/default/production/debugger/goals).
+
+`track` events map to a Metric if the Segment event name exactly matches the Name of an active LaunchDarkly experiment metric.
+
+The `userKey` field maps to the `userId` field; if there is no `userId` field, LaunchDarkly uses `anonymousId` field for the `userKey` field.