Setup Guide

This guide will help you set up FullStory as a destination in RudderStack.

Setup

1. In your RudderStack dashboard, go to Directory > Destinations > Cloud Destinations and search for FullStory.
2. Connect your source and click Continue.

Connection settings

Configure the following settings to set up FullStory as a destination in RudderStack:

• Name: Specify a unique name to identify the destination in RudderStack.
• API Key: Enter your FullStory API key required to send events to FullStory in cloud mode.

Make sure your API key has Admin or Architect permissions to view and delete data.

See FullStory documentation for more information on creating and managing your API keys.

• FS Org: Enter the fs_org value from your data capture snippet in your FullStory dashboard. For more information on getting this value, see FAQ.

This field is required for sending events to FullStory in web device mode.

Connection compatibility

Destination info
Status: Beta Supported sources: Web, Android, iOS , Unity, AMP , Cloud, Warehouse, React Native , Flutter, Cordova, Shopify Refer to it as FULLSTORY in the Integrations object.

Connection modes
Source	Cloud mode	Device mode	Hybrid mode
AMP
Android
Cloud
Cordova
Flutter
iOS
React Native
Shopify
Unity
Warehouse
Web

Supported message types
Source	Identify	Page	Track	Screen	Group	Alias
Cloud mode
Supported sources
Device mode
Android
iOS
Web

In the web device mode integration, that is, using JavaScript SDK as a source, RudderStack loads the FullStory native SDK from the https://edge.fullstory.com domain.

Based on your website’s content security policy, you might need to allowlist this domain to load the FullStory SDK successfully.

Configuration settings

After completing the initial setup, configure the following settings to correctly receive your data in FullStory:

• Client-side Events Filtering: This setting lets you specify which events should be blocked or allowed to flow through to FullStory. See Client-side Events Filtering for more information.
• Consent management provider: Configure the consent management settings for the specified source by choosing the consent management provider from the dropdown. If you choose Custom, make sure to pass the custom consent data to SDK.

Web SDK settings

The following settings are applicable when sending events to FullStory in web device mode, that is, using their native web SDK:

• FullStory Host: If you have a custom FullStory host, enter the host name to initialize the FullStory SDK with it. The default value is fullstory.com.
• FS debug mode: This setting is enabled by default and lets you use the FullStory debugging feature.

Add mobile device mode integration

Once you add FullStory as a destination in the RudderStack dashboard, follow these steps to add it to your mobile project depending on your integration platform:

1. Add the following dependencies in your Podfile:

pod 'FullStory', :http => 'https://ios-releases.fullstory.com/fullstory-1.18.0-xcframework.tar.gz'
pod 'Rudder-FullStory', :git => 'https://github.com/rudderlabs/rudder-integration-fullstory-ios.git', :tag => 'v1.0.0'

2. Run the pod install command.
3. Add the following imports to your AppDelegate.m file:

#import <Rudder/Rudder.h>
#import <RudderFullStoryFactory.h>

4. Initialize your iOS SDK:

RSConfigBuilder *configBuilder = [[RSConfigBuilder alloc] init];
[configBuilder withDataPlaneUrl:dataPlaneUrl];
[configBuilder withFactory:[RudderFullStoryFactory instance]];
RSClient *rudderClient = [RSClient getInstance:writeKey config:[configBuilder build]];

To complete the FullStory integration, you need to specify which FullStory organization to record. Follow these steps:

1. Open your app’s Info.plist.
2. From the menu, choose Editor > Add Item. Set the key name to FullStory and type to Dictionary.
3. Right-click the FullStory row and choose Add Row. Set the key name to OrgId and type to String. For the value, paste your assigned organization ID.

When configured correctly, the Info.plist entry should look as follows:

For more information, see FullStory iOS documentation.

1. Open your app/build.gradle (Module: app) file and add the following under the dependencies section:

implementation 'com.rudderstack.android.sdk:core:1.0.22'
implementation 'com.rudderstack.android.integration:fullstory:1.0.0'
implementation 'com.google.code.gson:gson:2.8.6'
// FullStory
repositories {
  maven { url "https://maven.fullstory.com" }
}
implementation 'com.fullstory:instrumentation-full:1.18.0@aar'

2. Add the FullStory Maven plugin to your build script. To do so, add the following snippet into the Gradle Scripts section of your root build.gradle:

buildscript {
  repositories {
    google()
    jcenter()
    maven { url "https://maven.fullstory.com" }
  }
  dependencies {
    classpath 'com.fullstory:gradle-plugin-local:PLUGIN_VERSION'
    // NOTE: Do not place your application dependencies here; they belong
    // in the individual module build.gradle files
  }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

3. Replace PLUGIN_VERSION with the correct version of the FullStory Android plugin. You can find the latest release notes here.
4. To apply the FullStory plugin, add the following snippet into your app-specific build.gradle (if your Gradle file adds plugins via plugin ID):

plugins {
  id 'com.android.application'
  id 'fullstory'
}
fullstory {
  org 'YOUR_ORG_ID_HERE'
}

5. If your Gradle file applies plugins, use the following snippet instead:

apply plugin: 'com.android.application'
apply plugin: 'fullstory'
fullstory {
  org 'YOUR_ORG_ID_HERE' // Replace with your organization ID.
}

6. To apply FullStory to all variants, including those used at debug time, add the following line below org:

org 'YOUR_ORG_ID_HERE'
enabledVariants 'all'

7. Add the following permissions, if not present already, to your AndroidManifest.xml:

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

8. Initialize the Android SDK in your Application class’ onCreate() method as shown:

// initialize Rudder SDK
val rudderClient =
    RudderClient.getInstance(
        this,
        WRITE_KEY,
        RudderConfig.Builder()
            .withDataPlaneUrl(DATA_PLANE_URL)
            .withFactory(FullStoryIntegrationFactory.FACTORY)
            .build()
    )

For more information, see FullStory Android documentation.

FAQ

How do I obtain FS ORG value?

1. Log in to your FullStory dashboard.
2. Click your Profile > Settings.
3. Click FullStory Setup to get your data capture snippet and copy the value present under window['_fs_org']:

Questions? Contact us by email or on Slack