From 9658e3b119e5ef0e309b848789f7354eca83d503 Mon Sep 17 00:00:00 2001 From: Henry Barrow Date: Thu, 7 Sep 2023 14:32:46 +0100 Subject: [PATCH 1/5] Add LaunchDarkly Audiences destination --- .../actions-launchdarkly-audiences/index.md | 34 +++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 src/connections/destinations/catalog/actions-launchdarkly-audiences/index.md diff --git a/src/connections/destinations/catalog/actions-launchdarkly-audiences/index.md b/src/connections/destinations/catalog/actions-launchdarkly-audiences/index.md new file mode 100644 index 0000000000..aba308194a --- /dev/null +++ b/src/connections/destinations/catalog/actions-launchdarkly-audiences/index.md @@ -0,0 +1,34 @@ +--- +title: LaunchDarkly Audiences Destination +--- + +{% include content/plan-grid.md name="actions" %} + +> (delete after reading) Include a 1-2 sentence introduction to your company and the value it provides to customers - updating the name and hyperlink. Please leave the utm string unchanged. + +[LaunchDarkly](https://launchdarkly.com) 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. + +This destination is maintained by LaunchDarkly. For any issues with the destination, [contact their Support team](mailto:support@launchdarkly.com). + +{% include content/ajs-upgrade.md %} + +> (delete after reading) The section below explains how to enable and configure the destination. Include any configuration steps not captured below. For example, obtaining an API key from your platform and any configuration steps required to connect to the destination. + +## Getting started + +1. In LaunchDarkly, navigate to [Account settings](https://app.launchdarkly.com/settings/projects) and copy the client-side ID for the project and environment where you would like to create a 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 Twilio Segment. To learn how to create a service token, read [Creating API access tokens](https://docs.launchdarkly.com/home/account-security/api-access-tokens#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**. Please 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 should not need to make any changes. +11. Click **Save**. +12. Ensure the **Status** toggle on the **Mappings** tab is enabled. + +{% include components/actions-fields.html %} From 43ea69d738a105d12a52397281d1c2f0baca51ce Mon Sep 17 00:00:00 2001 From: Henry Barrow Date: Thu, 7 Sep 2023 14:33:36 +0100 Subject: [PATCH 2/5] Update audience name --- .../catalog/actions-launchdarkly-audiences/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/connections/destinations/catalog/actions-launchdarkly-audiences/index.md b/src/connections/destinations/catalog/actions-launchdarkly-audiences/index.md index aba308194a..3b74279cce 100644 --- a/src/connections/destinations/catalog/actions-launchdarkly-audiences/index.md +++ b/src/connections/destinations/catalog/actions-launchdarkly-audiences/index.md @@ -19,7 +19,7 @@ This destination is maintained by LaunchDarkly. For any issues with the destinat ## Getting started 1. In LaunchDarkly, navigate to [Account settings](https://app.launchdarkly.com/settings/projects) and copy the client-side ID for the project and environment where you would like to create a 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 Twilio Segment. To learn how to create a service token, read [Creating API access tokens](https://docs.launchdarkly.com/home/account-security/api-access-tokens#creating-api-access-tokens). +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 and Engage Audience. To learn how to create a service token, read [Creating API access tokens](https://docs.launchdarkly.com/home/account-security/api-access-tokens#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**. Please ensure you are still in the correct Engage space. 5. Search for LaunchDarkly Audiences” and select the destination. Click **Add destination**. From 7135246562d40d7451c3d997a1b6b51d01d74197 Mon Sep 17 00:00:00 2001 From: Thomas Gilbert <64277654+tcgilbert@users.noreply.github.com> Date: Mon, 9 Oct 2023 12:46:38 -0400 Subject: [PATCH 3/5] add id and minor tweaks --- .../catalog/actions-launchdarkly-audiences/index.md | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/src/connections/destinations/catalog/actions-launchdarkly-audiences/index.md b/src/connections/destinations/catalog/actions-launchdarkly-audiences/index.md index 3b74279cce..ab21a8a126 100644 --- a/src/connections/destinations/catalog/actions-launchdarkly-audiences/index.md +++ b/src/connections/destinations/catalog/actions-launchdarkly-audiences/index.md @@ -1,12 +1,12 @@ --- title: LaunchDarkly Audiences Destination +id: 64e72a310da9ebedf99c8937 +beta: true --- {% include content/plan-grid.md name="actions" %} -> (delete after reading) Include a 1-2 sentence introduction to your company and the value it provides to customers - updating the name and hyperlink. Please leave the utm string unchanged. - -[LaunchDarkly](https://launchdarkly.com) is a feature management platform that empowers development teams to safely deliver, control, and measure their software through feature flags. +[LaunchDarkly](https://launchdarkly.com){:target="_blank"} 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. @@ -14,12 +14,10 @@ This destination is maintained by LaunchDarkly. For any issues with the destinat {% include content/ajs-upgrade.md %} -> (delete after reading) The section below explains how to enable and configure the destination. Include any configuration steps not captured below. For example, obtaining an API key from your platform and any configuration steps required to connect to the destination. - ## Getting started -1. In LaunchDarkly, navigate to [Account settings](https://app.launchdarkly.com/settings/projects) and copy the client-side ID for the project and environment where you would like to create a 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 and Engage Audience. To learn how to create a service token, read [Creating API access tokens](https://docs.launchdarkly.com/home/account-security/api-access-tokens#creating-api-access-tokens). +1. In LaunchDarkly, navigate to [Account settings](https://app.launchdarkly.com/settings/projects){:target="_blank"} and copy the client-side ID for the project and environment where you would like to create a 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 and Engage Audience. To learn how to create a service token, read [Creating API access tokens](https://docs.launchdarkly.com/home/account-security/api-access-tokens#creating-api-access-tokens){:target="_blank"}. 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**. Please ensure you are still in the correct Engage space. 5. Search for LaunchDarkly Audiences” and select the destination. Click **Add destination**. From f1edc1250d2e162036071853e7a980108e18bb6d Mon Sep 17 00:00:00 2001 From: Henry Barrow Date: Thu, 12 Oct 2023 17:04:19 +0100 Subject: [PATCH 4/5] minor copy edits --- .../catalog/actions-launchdarkly-audiences/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/connections/destinations/catalog/actions-launchdarkly-audiences/index.md b/src/connections/destinations/catalog/actions-launchdarkly-audiences/index.md index ab21a8a126..b6d04ac7a4 100644 --- a/src/connections/destinations/catalog/actions-launchdarkly-audiences/index.md +++ b/src/connections/destinations/catalog/actions-launchdarkly-audiences/index.md @@ -16,11 +16,11 @@ This destination is maintained by LaunchDarkly. For any issues with the destinat ## Getting started -1. In LaunchDarkly, navigate to [Account settings](https://app.launchdarkly.com/settings/projects){:target="_blank"} and copy the client-side ID for the project and environment where you would like to create a 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 and Engage Audience. To learn how to create a service token, read [Creating API access tokens](https://docs.launchdarkly.com/home/account-security/api-access-tokens#creating-api-access-tokens){:target="_blank"}. +1. In LaunchDarkly, navigate to [Account settings](https://app.launchdarkly.com/settings/projects){:target="_blank"} 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](https://docs.launchdarkly.com/home/account-security/api-access-tokens#creating-api-access-tokens){:target="_blank"}. 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**. Please ensure you are still in the correct Engage space. -5. Search for LaunchDarkly Audiences” and select the destination. Click **Add destination**. +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**. From a533fb33a9b98e10781b9352e8f0435815ccf1d5 Mon Sep 17 00:00:00 2001 From: pwseg <86626706+pwseg@users.noreply.github.com> Date: Thu, 12 Oct 2023 11:12:51 -0500 Subject: [PATCH 5/5] Minor cleanup --- .../catalog/actions-launchdarkly-audiences/index.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/src/connections/destinations/catalog/actions-launchdarkly-audiences/index.md b/src/connections/destinations/catalog/actions-launchdarkly-audiences/index.md index b6d04ac7a4..ccadb85bb4 100644 --- a/src/connections/destinations/catalog/actions-launchdarkly-audiences/index.md +++ b/src/connections/destinations/catalog/actions-launchdarkly-audiences/index.md @@ -10,7 +10,7 @@ beta: true 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. -This destination is maintained by LaunchDarkly. For any issues with the destination, [contact their Support team](mailto:support@launchdarkly.com). +LaunchDarkly maintains this destinatino. For any issues with the destination, [contact the LaunchDarkly Support team](mailto:support@launchdarkly.com). {% include content/ajs-upgrade.md %} @@ -19,13 +19,13 @@ This destination is maintained by LaunchDarkly. For any issues with the destinat 1. In LaunchDarkly, navigate to [Account settings](https://app.launchdarkly.com/settings/projects){:target="_blank"} 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](https://docs.launchdarkly.com/home/account-security/api-access-tokens#creating-api-access-tokens){:target="_blank"}. 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**. Please 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**. +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**. +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 should not need to make any changes. +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.