Google Tag Manager (GTM)

Fullstory's integration with Google Tag Manager allows you to install and enable Fullstory on your website or app with the click of a button. 

You have the following options for installing and updating Fullstory with Google Tag Manager:

1. Set up directly within Fullstory. 
   • Instructions for new customers.
   • Instructions for existing customers. 
2. Set up via the Google Tag Manager Community Template Gallery.
3. Set up manually within Google Tag Manager.
4. Update the Fullstory snippet to v2.0.

Option 1: Set up directly within Fullstory

There are two different ways that you can set this integration up within the Fullstory UI.

New Customer? Setup directly within our Onboarding Flow 

You can deploy Fullstory through GTM during our new account onboarding flow. When you log in to Fullstory for the first time, we check if your domain uses Google Tag Manager and offer the option to install Fullstory with just a few clicks.

1. Log in to Fullstory and complete the first two steps of your onboarding process.
2. Verify your privacy settings.
3. If your site uses Google Tag Manager, click Sign in during your account onboarding process.
   • You'll need to enable pop-ups to display the Google Tag Manager auth dialog.
     
4. Select the GTM account and the tag container you'd like to use. Then click Create and Publish Tag.
5. Alternatively, you can go to Settings > Data Capture and Privacy > Fullstory Setup to complete this step.
6. Click OK at the bottom right of the onboarding setup page.

Upon your first login into your account, you'll want to consider adding Excluded Elements to prevent Fullstory from capturing sensitive user data. You can update these anytime by going to Settings > Data Capture and Privacy > Privacy within your Fullstory account.

Existing Customer? Setup on the Fullstory Setup page

You can deploy Fullstory through GTM within our UI by following the steps below.

1. Log in to Fullstory and navigate to the Settings > Data Capture and Privacy > Fullstory Setup page.
2. Click Sign In from the GTM menu.
3. Select the GTM account and tag the container you'd like to use.
    
4. Create and Publish tag.
5. Once complete, you should see a 'Tag published successfully' message within our UI.

Option 2: Set up via the Google Tag Manager Community Template Gallery

Fullstory has created the Fullstory - Browser Tag template within the Google Tag Manager Community Template Gallery, which allows you to set up Fullstory directly from within Tag Manager, following the steps below. You'll first need to add the Fullstory - Browser Tag template to your workspace and then add a tag that references the added template.

Adding Fullstory - Browser Tag to your workspace

1. Log into Google Tag Manager.
2. From within Tag Manager, click Templates.
3. In the Tag Templates section, click Search Gallery.
4. To filter the list, click in the top right to open the search field.
5. Type fullstory in the search field.
   
   
    
6. Click the Fullstory - Browser Tag template.
7. To add the template, click Add to workspace.
8. Review the required template permissions and then click Add.

The above steps are derived from the Community Template Gallery documentation.

Setting up the Custom tag

Now that you've added the Fullstory - Browser Tag template to your workspace, you're ready to add it as a custom tag.

1. From within Google Tag Manager, click Tags.
2. Click New.
3. Click Tag Configuration.
4. In the Custom section, click Fullstory - Browser Tag.
   
   
   
    
5. In the Tag Configuration section for Fullstory - Browser Tag:
   1. Enter your Org Id.
   2. Optionally, enable debug mode.
   3. Optionally, enable capture inside an iframe.
6. Click the Triggering section of the page.

7. Click All Pages.

   Fullstory recommends capturing all pages for reliable session data.
8. At the top of the page, name the tag Fullstory - Browser Tag.
9. Review your configuration, which will look similar to the following:
   
   
    
10. Click Save.
11. At the main Google Tag Manager page, click Submit and then follow the subsequent pages to Publish the changes.

Option 3: Set up manually within Google Tag Manager

You also have the option of setting this up manually within Google Tag Manager. This is a great option for customers who would like to capture the sessions within the same Fullstory account across multiple GTM accounts or tag containers.

1. Log into Google Tag Manager.
2. Inside the container that is connected to your website, create a new tag.
3. Hover over the Tag Configuration box and click on the gray pencil icon that appears.
   
   
    
4. Select 'Custom HTML Tag' as the tag type.
   
   
    
5. Paste your Fullstory snippet from the Settings > Data Capture and Privacy > Fullstory Setup page within your Fullstory account into the HTML text box in GTM.
   
   
    

6. Next, hover over the Triggering box and click on the gray pencil icon that appears. This is where you define when the tag will "fire" on your website.
   
   
   
   You can either select the default trigger, which would fire this tag on all pages of your website or build a custom trigger by clicking on the '+' icon. 
   
   

   Fullstory recommends capturing all pages for reliable session data.
7. Once saved, the Fullstory JavaScript will be loaded on any page where the GTM container script is installed and matches your tag trigger logic. 
   
   

Updating the Fullstory snippet to v2

If your Fullstory snippet is still on v1.3, you can update to v2 at any time. The v2 snippet is fully backward compatible with existing v1 API calls, so you can update the snippet now and migrate your API calls to v2 at your own pace.

If you installed via Option 1 or Option 2 (Direct in FS or Template)

GTM will notify you when a template update is available.

1. Log into Google Tag Manager.
2. Look for the update notification bar at the top of the container's main screen. This bar appears when an update is available for an imported template.
3. Click View in the notification bar to see templates with available updates.
4. Click the Fullstory - Browser Tag entry. A page comparing the current and new version will appear.
5. Click Accept update to install the latest version. Your existing field values and configurations will be retained.
6. Submit and Publish the workspace changes.

If you installed via Option 3 (Manual Custom HTML)

1. In Fullstory, go to Settings > Data Capture and Privacy > Fullstory Setup and copy the new v2 snippet.
2. In GTM, navigate to Tags and open your existing Fullstory Custom HTML tag.
3. Delete the old snippet code and paste the new v2 snippet code.
4. Submit and Publish the workspace changes.

Verifying the update

After publishing, confirm the update is live by opening your browser's developer console on your site and running the following commands.

• Run FS._v to confirm the snippet version has updated to 2.0.0 (or latest).
• Run FS('getSession', { format: 'url' }) to confirm Fullstory is actively capturing sessions.