You're in the right place! Segment documentation is now part of Twilio Docs. The content you are used to is still here—just in a new home with a refreshed look.

Analytics React Native FullStory Plugin

FullStory lets product and support teams easily understand everything about the customer experience. The Segment integration for FullStory helps accurately identify your customers within the FullStory dashboard.

(information)

Info

The FullStory Analytics React Native destination plugin was built and is maintained by the FullStory team. For implementation questions and guidance, reach out to them.

Please make sure that your application is correctly set up with FullStory. See FullStory's React Native documentation to get started.

Installation

Install the @fullstory/segment-react-native-plugin-fullstory and @fullstory/react-native dependencies.

1yarn add @fullstory/segment-react-native-plugin-fullstory @fullstory/react-native
2# or
3npm install --save @fullstory/segment-react-native-plugin-fullstory @fullstory/react-native

Run pod install after the installation to autolink the FullStory SDK.

Usage

In your code where you initialize the analytics client call the .add({ plugin }) method with an FullStoryPlugin instance.

1// App.js
2
3import { createClient } from '@segment/analytics-react-native';
4import { FullStoryPlugin } from '@fullstory/segment-react-native-plugin-fullstory';
5
6const segmentClient = createClient({
7  writeKey: 'SEGMENT_WRITE_KEY',
8});
9
10const plugin = new FullStoryPlugin({
11  // configurations
12  enableFSSessionUrlInEvents: true,
13});
14
15segmentClient.add({ plugin });

Configurations

The plugin accepts a configuration object with the following properties:

Property	Description
enableFSSessionUrlInEvents	Insert FS session URL to Segment event properties. Defaults to `true`.
allowlistAllTrackEvents	Send all track events as FS custom events. Defaults to `false`.
enableIdentifyEvents	Enable Segment identify events to be sent as FS identify events. Defaults to `true`.
allowlistTrackEvents	An array of event names to allow to send to FullStory. To allowlist all events, use `allowlistAllTrackEvents`.
enableSendScreenAsEvents	Send screen events as FS custom events. Defaults to `false`.
enableGroupTraitsAsUserVars	Enable group event traits to be passed into FS user vars. Defaults to `false`.

Example

FullStory has included a simple React Native app that implements the plugin. See example README for additional instructions.