FullStory

This topic explains how to set up and use the LaunchDarkly FullStory integration. The integration sends LaunchDarkly flag evaluations as FullStory page properties.

The FullStory integration requires the LaunchDarkly JavaScript SDK version 2.24 or higher, or the React Web SDK version 2.27 or higher.

Overview

This topic explains how to set up and use the LaunchDarkly FullStory integration. The integration sends LaunchDarkly flag evaluations as FullStory page properties.

FullStory combines analytics with high-fidelity session replay and intelligent diagnostics so you can fix issues impacting your customers’ experience, even if the issues are not reported by customers.

To learn more about the use case for this integration, read LaunchDarkly + FullStory: Targeted User Observability on the LaunchDarkly blog.

Set up the integration

The code below can be modified to fit your setup.

Here’s how to get started:

• Install and configure the FullStory client
• Use the setVars API to send the evaluated flags to FullStory page propertiesIn the example below, evaluatedSessionFlags is a two-level map. The first key is the url path. The second key is the flag key. The final values are based on the return value of the feature flag:

Inspector Setup

    // instantiate the path to flags mapping object outside of the Inspector
    const evaluatedSessionFlags: { [path: string]: { [flagKey: string]: unknown } } = {};

    const fsInspector: LDInspection {
      {
        type: 'flag-used',
        name: 'fullstory-inspector',
        method: (key: string, detail: LDEvaluationDetail) => {

          // FullStory attaches getCurrentSessionURL and setVars to the window object.
          // https://help.fullstory.com/hc/en-us/articles/1500004101581-FS-setVars-API-Sending-custom-page-data-to-FullStory
          if (window.FS === undefined || typeof window.FS.getCurrentSessionURL !== 'function') {
            return;
          }

          const url = window.FS.getCurrentSessionURL(true);
          if (url === undefined) {
            return;
          }

          evaluatedSessionFlags[url] = {
            ...evaluatedSessionFlags[url],
            [key]: detail.value,
          };

          const arrayOfFlags = Object.keys(evaluatedSessionFlags[url]).map(
            (flagKey) => `${flagKey}=${JSON.stringify(evaluatedSessionFlags[url][flagKey], null, 1)}`,
          );

          if (typeof window.FS.setVars === 'function') {
            window.FS.setVars('page', { ldflags: arrayOfFlags }, {integration:"launchdarkly"});
          }
        },
      },
    }
    const options = { inspectors: [fsInspector] };
    const client = LDClient.initialize('example-client-side-id', context, options);