Support

Installing GoSquared

It’s easy to start getting value from GoSquared – whether you’re here for web analytics, or to use the whole platform to grow your business, our aim is to have you up and running in no time.

📚 This article covers:

Introduction to the GoSquared Snippet
How to install GoSquared on popular platforms
How to install GoSquared manually (with Video Tutorial)
Troubleshooting your Snippet installation
Enabling Assistant


One JavaScript Snippet for all of GoSquared

One of the huge benefits of GoSquared is you only need to install one piece of JavaScript code on your website, and you can use the entire platform.

Just install the GoSquared JavaScript Snippet and you’ll have the ability to use the following functionality without any need for further code changes:

  • GoSquared Analytics
  • GoSquared Live Chat
  • GoSquared Customer Data Hub*
  • GoSquared Automation*

* You can gain huge benefits from the GoSquared Customer Data Hub and Automation by integrating more deeply with your website or app. Learn more about integrating GoSquared with your user system.

🚀 A win for speed

Worried about slowing down your website? GoSquared can help speed up your website.

Our customers often find themselves replacing a handful of different tools (each with their own heavy JavaScript weighing down their pages) in favour of GoSquared. The GoSquared JavaScript Snippet is one of the world’s smallest and fastest to load. Learn more about our obsessive focus on website performance.


You don’t even need to touch any code if your website or app is built on any of these popular platforms:

👨‍💻 If you’re a developer, you might what to check out our API documentation to see what’s possible with our powerful set of APIs.


Install GoSquared on your website manually

Adding the GoSquared JavaScript Snippet to your website enables GoSquared Analytics, and also gives you the option to switch on GoSquared Assistant to start having live chat conversations with your visitors.


Step 1: Ensure you have a GoSquared account

If you don’t already have a GoSquared account, Create your free account.

Once you have signed up, you’ll be guided through the key steps to help you get started with GoSquared.

Step 2: Head to the Setup Guide

Setup Guide Installation

Once you’re in your account, you can always head to the Setup Guide listed in the sidebar on the left of the screen.

In Setup Guide, head to the first option: “Install on your site” to manually install GoSquared.

Step 3: Copy and paste the JavaScript Snippet

Manually copy your GoSquared JavaScript Snippet

Copy the code from this screen, and paste the code into every page on your site that you wish to track. You’ll need to add it just before the closing </head> tag.

The code snippet will look something like this:

<script>
  !function(g,s,q,r,d){r=g[r]=g[r]||function(){(r.q=r.q||[]).push(
  arguments)};d=s.createElement(q);q=s.getElementsByTagName(q)[0];
  d.src='//d1l6p2sc9645hc.cloudfront.net/gosquared.js';q.parentNode.
  insertBefore(d,q)}(window,document,'script','_gs');

  _gs('GSN-123456-A');
  _gs('set', 'anonymizeIP', true);
</script>

On most sites, you should be able to add this to a header file (or any file that’s included on all pages of your site) and it will appear on every page.

If you’re uncomfortable about adding the code to your website yourself, or are unable to do so, hit the “Invite colleague…” button to send the code to your developer or website manager to implement.

Step 4: Save and update your website

After adding the code to your site and saving the changes, check everything still works by visiting your website and refreshing the page. Once happy, head back to GoSquared and click the “Check Installation”" button in the Setup Guide.

Step 5: Double check you’re ready to go

Screenshot of Check your GoSquared setup

You’re almost ready to go – we’ve provided a helpful checklist to ensure you have completed the required steps to install GoSquared.

If you’re sure you’ve completed everything, just tick each step off, and then hit “Run installation check”.

Step 6: Checking your installation…

GoSquared will start to check to ensure you’ve installed the JavaScript Snippet correctly.

The checker will turn green if it successfully tracks a pageview – indicating everything should be working as expected.

Did the checker fail?

If the checker turns red and fails to confirm your installation, don’t panic. There’s a bunch of reasons why this might happen and we see them all the time.

GoSquared Checker failed to validate

If the check fails, try these methods to fix the issue:

  • Try loading up your website in a new Incognito or Private browser window and refresh the page.
  • Ensure you don’t have an ad blocker installed that might be preventing GoSquared from loading.
  • Ensure you’re loading a page of your site that has the GoSquared JavaScript on it.

The Setup Guide checklist will then guide you through the rest of the GoSquared set-up.


Troubleshooting your Snippet installation

The two most common reasons why your Analytics tracking may not be working is if the Snippet is not correctly installed into your site, or the wrong project token has been used.

To check both of these, open your website in a Chrome browser and right click on the page to select ‘View Page Source’

In the tab that opens, type CTRL + F on your keyboard to bring up the ‘find’ search bar. Within that type ‘_gs’

This will search the code on your website to see if it can find our snippet and highlight the results in yellow. If the Snippet has been installed successfully, it will be highlighted in the search.

If the Snippet highlights correctly, but your Analytics still are not tracking, please ensure you have used the correct project token. This will appear as ‘GSN - 123456 - X’

You can find your Project token by selecting the relevant project in GoSquared. Then head to the Settings tab > Current Project > General > GoSquared Code Snippet. From here, you can recopy the correct snippet which will contain the project token.


Enable Assistant to start chatting with your visitors

Illustration of GoSquared Assistant

Once you’ve installed the GoSquared JavaScript Snippet once, you don’t need to change any more code to add live chat to your website. It’s just a click and your ready to chat!

Live Chat and Analytics use the same JavaScript Snippet so you don’t need to weigh your pages down with third party tools and extra code.

When you enable Assistant, by default it will be displayed in the bottom right corner of every page of your website. Your visitors will be able to send you messages straight away.

You can enable (and disable) Assistant at any time from within your GoSquared account. Just head to Settings > Current Project > Assistant.

Follow the Assistant Setup Flow to configure:

  • The name and photo your visitors will see when chatting with you.
  • The company name that gets displayed to your visitors in Assistant.
  • The colour of the Assistant button.
  • The “welcome” text to introduce visitors to your business.
  • Your first Live Chat Prompt to proactively reach out to visitors.

🔍 How to get started with the Customer Data Hub and Automation

The Customer Data Hub enables you to get closer to your users and customers by centralising all your customer data. Provide more personal, helpful service and assistance to your customers, by gaining easy access to all the information you need on each and every user.

GoSquared Automation enables you to send the perfect message to each user and customer at the perfect time – and its built on the data you have in Customer Data Hub.

To take advantage of the power of Automation and the Customer Data Hub, you’ll still use the JavaScript Snippet to send data to us, but you’ll also want to implement some extra steps to identify your customers and ensure you can tie data together for each of them.

You’ll want to look at identifying your users and customers if your website or app has a login system.

👨‍💻 Identifying your users requires some technical knowledge. We recommend that you (or your developer) are comfortable with accessing the underlying source code of your website to successfully get this set up.

Read the guide on identifying your customers.