Collapse Menu
Docs Home
Extensibility Options
Contact Support

Google Universal Analytics

Overview

This article describes how to set up integration between your FastSpring Store and Google Analytics.

This article explains how to set up integration with Google Universal Analytics. 

 

Setting up Google Analytics and Google Tag Manager in FastSpring

Each Storefront can be configured separately for integration with Google Analytics and Google Tag Manager. You can use Google Tag Manager and Google Analytics separately, or together. If you use both together and your Tag Manager setup contains Google Analytics, you should not set Google Analytics up in FastSpring separately.

To use a single configuration for all Storefronts in your FastSpring Store

  1. In the FastSpring App, select the Integrations menu. The Extensions tab is selected by default.
  2. Click Google Analytics.
  3. Click Setup.
  4. Enter your Google Analytics Universal Property ID.
  5. Click Enable.
  6. Back on the Extensions tab, click Google Tag Manager.
  7. Click Setup.
  8. Enter your Google Tag Manager Container ID.
  9. Click Enable.

 

 

To override the Store-level properties with a unique configuration for each Storefront

  1. In the FastSpring App, select the Storefronts menu and click Settings for the Storefront you want to edit.
  2. Click the Analytics Integration link on the left-hand side of the Storefront Settings page.
  3. In the Google Tag Manager custom container ID for this storefront field, enter your Google Tag Manager Container ID. The value you enter here should have a format similar to GTM-XXXX.
  4. In the Custom Google Analytics property ID for this storefront field, type the property ID for your Google Analytics account. The value you enter here should have a format similar to UA-NNNNNN-N. Note: If your Google Tag Manager setup contains Google Analytics, you should skip this field and specify only the Google Tag Manager container.
  5. Click Save at the top right-hand corner of the page.

After you specify the IDs for one or both of these fields, there are additional steps you need to perform in your Google accounts.

 Tip

If you need to troubleshoot your Google Analytics or Google Tag Manager implementation, the GA Debugger extension for the Google Chrome Web browser can be a useful tool. This tool, which can be toggled on or off in Chrome, prints helpful information--such as error messages and warnings--to the JavaScript Console. Having access to this information may help you identify problems with your tracking code implementation.

 Note about ad blockers

Due to the increasing popularity of ad-blocking software/browser add-ins on customers' systems, as many as 10% to 15% of transactions might not be reported to Google Analytics. These unreported transactions can influence reporting accordingly. However, ad blockers also directly impact the traffic you see on your website, so your site traffic may also be underreported by a similar amount. Therefore, relative analyses such as conversion rates are not affected - but absolute numbers such as the count of visitors and pageviews are affected.

As an alternative to browser-based customer interaction tracking, you might consider implementing server-side tracking via Google Measurement Protocol.

 

Google Analytics

After entering the Google Analytics property ID for your FastSpring Store or Storefront via the FastSpring App, align the time zone used by FastSpring (GMT +0) with the time zone used by your Google Analytics account. Matching time zones makes it easier to compare reports from both sources. To align the time zones, log in to your Google Analytics account, and navigate to Admin > View > View Settings. Choose "United Kingdom" for the Time zone territory. Leave the GMT +00:00 setting as it is.

Next, open Ecommerce Set-up in your Google Analytics Property view. Choose to enable Ecommerce and Enhanced Ecommerce Reporting.

Then, create the following 5 checkout steps:

  1. Payment Option Selected
  2. Name Entered
  3. Email Entered
  4. Payment Data Entered
  5. "Buy Now" Button Clicked

Your Ecommerce setup must look like this:

Click Save. Your Google Analytics account is ready to receive data.

 

Cross-Domain Tracking Through the Use of the Linker Plugin

You must use the linker plugin from Google to ensure that tracking is not lost between your site and FastSpring's store. There are a couple of ways you can implement this on your website. The method to use depends on the type of Storefront to which you are linking.

 

For Web Storefronts

Important: If you are setting up Google Analytics specifically for use with Google Tag Manager, please skip this section. The linker is handled separately in your GTM setup.

Include the following lines in the Google Analytics code placed on your website:

Copy and paste the following code to your site:

  ga('require', 'linker');

  ga('linker:autoLink', ['yourcompany.onfastspring.com','yourcompany.test.onfastspring.com']);

 Note

Replace both occurrences of 'yourcompany' in the above code with the base URL for your Web Storefront. This is often the company ID that you specified when you created your FastSpring account.
Example of Google Analytics linker plugin code for use on your website
<script>
  (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
  (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
  m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
  })(window,document,'script','https://www.google-analytics.com/analytics.js','ga';);

  ga('create', 'UA-93623912-1', 'auto');
  ga('require', 'linker');
  ga('linker:autoLink', ['yourcompany.onfastspring.com','yourcompany.test.onfastspring.com']);
  ga('send', 'pageview');
</script>

 

When Using the Store Builder Library

Important:  Only follow these instructions if you are using the Store Builder Library (or a Popup Storefront). Otherwise, skip this section.

When using the Store Builder Library (including pasting in the code to add a Popup Storefront to your website), include the following decoration attribute in the script that loads the library:

Copy and paste the following into the script that loads your FastSpring Storefront / library:
data-decorate-callback="decorateURL"

Example of loading the FastSpring library with the data-decorate attribute included
<script
    id="fsc-api"
    src="https://d1f8f9xcsvx3ha.cloudfront.net/sbl/0.8.3/fastspring-builder.min.js""
    type="text/javascript"
    data-storefront="furiousfalcon.onfastspring.com/popup-furiousfalcon""
    data-decorate-callback="decorateURL">
</script>
Copy and paste the following code into your page:

<script>

    function decorateURL(url) {

                var linkerParam = null;

                ga(function() {

                                var trackers = ga.getAll();

                                linkerParam = trackers[0].get('linkerParam');

                });

                return (linkerParam ? url + '?' + linkerParam : url);

    }

</script>

 

Setting up Referral Exclusions in your Google Analytics account

It is essential to set up referral exclusions in your Google Analytics account. Doing this can help prevent issues with tracking being lost when customers are redirected or referred to other domains (e.g., for payment), 

You can find step-by-step instructions for doing this at https://support.google.com/analytics/answer/2795830?hl=en.

We encourage you to add the following domains to the Referral Exclusion list:

  • onfastspring.com
  • <storename>.onfastspring.com (where <storename> is the name of your Storefront, e.g. yourexamplestore.onfastspring.com)
  • paypal.com
  • sofort.com

Try FastSpring

Get a free account and see why FastSpring is the ecommerce partner of choice for software providers around the world. Try our full-service ecommerce solution today to unlock revenue growth for your online company.