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 that 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 the "Variables" tab from the sidebar.

  • Scroll down to the User-Defined Variables section.

  • Click on New Button.

You need to create 4 variables; all of these variables should have the 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 Open:

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 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".

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

7. Checklist Guide 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".

8. Resource Center Guide Trigger

It means that a Resource Center guide is triggered by a user. The category of this event is "UserGuiding Resource Center". Event action is "resource center guide trigger".

Guide name can be seen under "eventLabel".

9. Resource Center Checklist Guide Trigger

It means that a guide in a checklist that is put in a Resource Center as a module is triggered by a user. The category of this event is "UserGuiding Resource Center". Event action is "checklist guide trigger".

Guide name can be seen under "eventLabel".

10. Resource Center External URL Click

It means that an external URL in a Resource Center is clicked by a user. The category of this event is "UserGuiding Resource Center". Event action is "external url click".

External URL can be seen under "eventLabel".

11. Resource Center Search Article Link Click

It means that an external URL in a Resource Center is clicked by a user. The category of this event is "UserGuiding Resource Center". Event action is "article link click".

Article link can be seen under "eventLabel".


Related Articles:

Intercom Integration

Segment Integration


Did this answer your question?