Enabling the Google Analytics (GA) integration allows Usetiful to send detailed event data about how users interact with your content directly to your GA account. This integration helps you analyze user engagement, measure the effectiveness of your tours, checklists, and banners, and refine your onboarding or product adoption strategies. Usetiful seamlessly integrates with your existing Google Tag Manager (GTM) or Google tag (gtag.js) implementation to simplify the process.

What you will need

• A Google Analytics account (GA4 or Universal Analytics).
• A Usetiful account (Plus plan or higher).
• A website with Google Analytics installed using either:
  • Google Tag Manager (GTM), or
  • Google Tag with gtag.js.

How to activate the integration

1. Navigate to the Integrations page in your Usetiful account.
2. Set up the Google Analytics integration. Once activated, it will appear under the list of Active Integrations at the top of the page.

Integration Details

For sites using Google Tag (gtag.js)

If your site uses the Google Tag (gtag.js), no additional setup is required. Usetiful will automatically pass events to Google Analytics.

For sites using Google Tag Manager (GTM)

If your site uses GTM, follow these steps:

1. Define 4 Data Layer Variables:

   • usetiful_content_id
   • usetiful_content_name
   • usetiful_event_id
   • usetiful_event_label
     
     You should see something like this in GTM:
     

2. Define a Custom Event Trigger:

   • Create a trigger that listens for events matching the regex pattern:
     .+\(Usetiful\)
     
     

     

     
     Example events:
     • Button seen (Usetiful)
     • Tour started (Usetiful)

3. Create a GTM Tag:
   
   

   • Set up a tag that sends events to Google Analytics.
   • Configure the tag to pass the defined Data Layer Variables to GA.
   • Use the Custom Event Trigger you created to fire the tag.
     
     

4. Publish Your GTM Changes:

   • After completing the setup, publish your changes in GTM.

What events will you receive in Google Analytics?

Usetiful sends detailed events to Google Analytics, helping you track user interactions such as tours, checklists, and banners.

Example properties included in events:

• Event Name: Tour Started (Usetiful)
• Event Action: start
• Event Category: Usetiful
• Event Label: Tour 'Welcome Tour' (1412) was started

Additional properties:

• usetiful_content_id: 1412
• usetiful_content_name: Welcome Tour
• usetiful_event_id: tour_start
• usetiful_event_label: Tour 'Welcome Tour' (1412) was started

Examples of events sent to GA:

• tour_start
• checklist_show