This article explains how UserGuiding integrates with Google Analytics, a web analytics service offered by Google that tracks & reports website traffic and events.

When it is activated, UserGuiding can be used as a Source which sends UserGuiding content-related event data to your Google Analytics account.

Important Note: To successfully initiate this integration, you must have installed Google Analytics within your web application. If not, this integration will not take place.

How To Enable Google Analytics Integration

You can enable this integration by using the toggle within the Integrations Tab under the Settings Section.

When you turn the toggle on, this integration will be activated for the pages where UserGuiding Container Code and the Google Analytics Tracking Code are present at the same time.

  • If you have installed Google Analytics within your web application using the gtag.js method, there are no additional steps required.
  • If you have installed Google Analytics using Google Tag Manager you must complete the following steps before enabling the Integration.

1- Create UserGuiding Tracking Trigger

  • Trigger type: Custom Event
  • Event name: userGuidingTracking

2- Create User-Defined Variables

  • Go to "Variables" tab from sidebar
  • Scroll down to User-Defined Variables section
  • Click on New Button

You need to create 4 variables, all of these variables should have type "Data Layer Variable"

eventAction

eventCategory

eventLabel

eventValue

3- Add a Universal Analytics tag for event tracking

  • Tag Type: Google Analytics Universal Analytics
  • Track Type: Event
  • Category: {{eventCategory}}
  • Action: {{eventAction}}
  • Label: {{eventLabel}}
  • Value: {{eventValue}}
  • Trigger: UserGuidingTrackingTrigger

Event Tracking

When enabled, UserGuiding will send content-related event data to your Google Analytics account.

To view the events:
Go to your Google Analytics Dashboard > Realtime > Events

Or go to Behavior > Events > Top events

You should see the latest UserGuiding events in this section.

These events include:

1. Guide Preview Start:

It means that the first step of a guide is previewed by a user. The category of this event is "UserGuiding Guide".

Event action is "start" (since guides start from their first steps) and the guide's name can be seen under "eventLabel".

2. Guide Preview Complete:

It means that a user has gone through all steps of a guide and seen its last step. The category of this event is "UserGuiding Guide".

Event action is "complete" and the guide's name can be seen under "eventLabel".

3. NPS Survey Display:

It means that your NPS Survey is seen by a user. The category of this event is "UserGuiding NPS". Event action is "shown".

4. NPS Score Submit:

It means that a user has given you a certain NPS score. The category of this event is "UserGuiding NPS". Event action is "score submit".

You'll see the survey question, and the value of the submitted score.

5. NPS Feedback Submit:

It means that a user has given a written answer to the question of your NPS Survey. The category of this event is "UserGuiding NPS". Event action is "feedback submit".

6. Hotspot Interaction

It means that a user interacted with a hotspot group and seen a hotspot content. (remember, hotspot groups can have multiple hotspots as contents).

The category of this event is "UserGuiding Hotspot Group". Event action is "hotspot interact".

Hotspot group's name (1st part) and the extracted hotspot name from the interacted hotspot content can be seen under "eventLabel".

7. Checklist Item Trigger

It means that a checklist guide is triggered by a user. The category of this event is "UserGuiding Checklist". Event action is "checklist guide trigger".

Checklist name (1st part) and the guide name, triggered from the checklist can be seen under "eventLabel".


Related Articles:

Intercom Integration

Segment Integration


Did this answer your question?