GrowSurf Docs
Help CenterSystem StatusContact SupportYour Dashboard →
  • Welcome
  • Getting Started for Web
    • Google Tag Manager
    • Participant Auto Authentication
  • Getting Started for Native Mobile
  • Developer Tools
    • Embeddable Elements
    • JavaScript SDK
      • Tutorials
      • Single Page Applications
      • API Reference
    • REST API
      • Tutorials
      • Objects
      • API Reference
      • API Guidelines
      • API Response Codes
    • Webhooks
      • Securing Your Webhooks (optional)
      • Examples
      • Events Reference
    • Metadata
  • Integrations
    • ActiveCampaign
      • Tutorials
    • Amplitude
    • AWeber
      • Tutorials
    • Brevo (formerly Sendinblue)
      • Tutorials
    • Cal.com
    • Calendly
    • Campaign Monitor
      • Tutorials
    • Chargebee
    • Constant Contact
      • Tutorials
    • ConvertKit
      • Tutorials
    • Customer.io
      • Tutorials
    • Drip
      • Tutorials
    • EmailOctopus
      • Tutorials
    • Fullstory
    • GetResponse
      • Tutorials
    • Google Ads
    • Google Analytics
    • Heap
    • Help Scout
    • HubSpot
      • Tutorials
    • Intercom
      • Tutorials
    • Klaviyo
      • Tutorials
    • LinkedIn Ads
    • Mailchimp
      • Tutorials
    • MailerLite
      • Tutorials
    • Mailjet
      • Tutorials
    • Make
      • Tutorials
    • Marketo
      • Tutorials
    • Meta (Facebook) Ads
    • Mixpanel
    • Pabbly Connect
      • Tutorials
    • PayPal
    • Pendo
    • PostHog
    • Recurly
    • Salesforce
      • Tutorials
    • Segment
    • SendGrid
      • Tutorials
    • Slack
    • Stripe
    • Tango Card
    • Typeform
    • X (Twitter) Ads
    • Zapier
      • Tutorials
      • Using Filters
      • Troubleshooting
Powered by GitBook
On this page
  • How It Works
  • Tracked Events
  • Example Events
  • How to Set Up
  • How to View Events In Fullstory
  • Troubleshooting Tips

Was this helpful?

  1. Integrations

Fullstory

Track and analyze referral program data alongside product analytics in Fullstory.

Last updated 3 months ago

Was this helpful?

Note: The Fullstory integration is only available to users on the GrowSurf Business plan or higher.

How It Works

After connecting, the Fullstory integration transmits data to your Fullstory account, enabling analysis and reporting on your referral program.

For referrers, when they are added to your campaign (e.g., they get a referral link generated) or if they click a social share button (like Facebook or LinkedIn), GrowSurf sends a Fullstory event. For referred friends, if they sign up using your Share URL, GrowSurf also sends an event.

Under the hood, GrowSurf will load the Fullstory JavaScript library, identify participants (both referrers and referred friends) by their email address, and track events. Rest assured, if Fullstory is already installed, GrowSurf ensures the library is not loaded twice and prevents duplicate identity calls.

Tracked Events

The following events will be emitted with the growsurf_ prefix.

Event
Description
Explanation

growsurf_referral

[Referred friend] New referral signup

Records when a referred visitor signs up through a referral link. This includes:

  • Those who submit the form on your website that has referral tracking enabled (via the campaign editor)

growsurf_referral_trigger

[Referred friend] Referral triggered

growsurf_signup

[Referrer] New referrer signup

Records when someone generates a referral link and joins the campaign as a participant.

This includes:

  • Direct signups (someone entering in their email address on the GrowSurf form)

  • Passing in an email address via URL parameter ?grsf_email

growsurf_share

[Referred] Social media share

Records when a referrer shares their link by clicking 'Copy Link' or clicking a social media button

growsurf_invite

[Referrer] Email invite(s) sent

Records when a referrer sends invitation(s) via email

Example Events

Events correspond with the events listed in the method. To see examples of the raw JSON data, please see the section.


How to Set Up

Note: If you are 100% certain that you already have Fullstory installed on your website, you do not need to enter the Fullstory Org ID. Simply press Connect and the integration will be enabled. However, we recommend that you still enter it to account for URLs that do not have Fullstory installed.

Step 2: Once connected, GrowSurf will have all events enabled by default. Disable any events that you do not want to track.

Once GrowSurf events get emitted, you will see them show up in Fullstory > Metrics.

Note: Please allow up to 15 minutes of processing time for events to appear (in some cases where Fullstory is backed up, it can take longer).


How to View Events In Fullstory

Once events are emitted to Fullstory, you'll need to follow these instructions below to set up a metric page for each event.

Step 1: From FullStory, click the Create button on the left-side nav menu.

Step 2: For the title, enter "GrowSurf Share Metrics".

Step 3: Scroll to the Metric Filters section and select the following for the Event dropdown:

  • In the first dropdown, select "Custom Event"

  • In the second dropdown, choose growsurf_share (if you don't see this option, you'll want to make sure there is at least one growsurf_share event that exists as Fullstory will auto-generate this option).

Your screen should now look like this:

Step 4: In the top-right, click the Save button. You should now be able to see the metrics dashboard like the image below:

Tip: If you scroll to the Session Playlist section of the metric page, you'll be able to see session replays of users who performed actions.

Step 5: For each GrowSurf tracking event, you'll want to repeat steps 1 to 4 to add each metric.


Troubleshooting Tips

Here are common scenarios and how to troubleshoot them.

If you are seeing a wrongly identified user:

There are 5 different ways that GrowSurf participants can be added to your campaign. Please make sure that the GrowSurf participant email address that you are passing in matches the one you were expecting for the Fullstory user:

  • If you pass in an email address via URL parameter ?grsf_email

  • If you enter an email address via the GrowSurf form

  • If you are a referred friend and you submit the form that has referral tracking configured on it from the Campaign Editor > 5. Installation step

If you are not receiving events, but were expecting them:

  • Make sure you do not have any ad-blockers or browser extensions blocking requests to Fullstory.

  • Make sure to whitelist the URL where events are being tracked (e.g, if your referrer clicks the Facebook share button from https://app.yoursite.com/refer, you'll want to make sure you whitelist that root domain. If a referred friend signs up on your Share URL, make sure to whitelist the Share URL as well).

  • If you just submitted an event, make sure that you've allowed up to 15 minutes for Fullstory to process the event.

If you are receiving events, but were NOT expecting them:

  • To ensure no non-GrowSurf-related events are sent to your Fullstory account, disconnect the integration completely. Simply toggling off all checkboxes is insufficient.

  • If you're receiving events without a GrowSurf-related suffix (e.g., growsurf_), it indicates that GrowSurf may not be emitting these events. Please check other parts of your code to find where these events might be occurring.

Adding a referred participant via

Records when a referred participant completes the desired qualifying action, which triggers a referral. Only applies when you are using .

Passing in an email address via data-grsf-email attribute on an

Adding a participant via

Step 1: In Campaign Editor > 4. Options > Integrations, open the Fullstory integration card and enter your .

Important Note: Within your Fullstory account, make sure to whitelist the URLs where these events occur. These are primarily two locations: your referral portal (which might be part of your user portal or web app or the ) and the referred friend's landing page (the Share URL you enter in the Campaign Editor > 5. Installation step).

If you pass in a data-grsf-email attribute to a

If you are using

growsurf.subscribe()
Example Response
Fullstory Org ID
GrowSurf-hosted referral portal
GrowSurf embeddable element
growsurf.addParticipant()
growsurf.addParticipant()
growsurf.triggerReferral()
Embeddable Element
growsurf.addParticipant()