Capture Whatfix analytics data using Google Analytics (GA)
  • 21 Dec 2023
  • 4 Minutes To Read
  • Dark
  • PDF

Capture Whatfix analytics data using Google Analytics (GA)

  • Dark
  • PDF

Article Summary


Whatfix provides easy-to-configure analytics with the most popular analytics tool - Google Analytics (GA). You can perform the following actions only after you have configured your Whatfix account to your Google Analytics account.

  • Track usage of the Flows you have created using Whatfix.
  • Track usage of the various Whatfix widgets (onboarding Popups, Self Help, Beacons, Task List, slideshows, etc.).
your title goes here

Your account will be created on the latest Google Analytics - GA4 version.

To capture and analyze data, four major steps must be followed while configuring your GA account to Whatfix.

  1. Create the GA4 account and copy the measurement ID
  2. Set up Custom Dimensions
  3. Set up the reporting bundle
  4. Paste the Measurement ID from GA4 to the Whatfix Dashboard and finish setting up the account

Create the GA account and copy the Measurement ID

Use the following steps to create a GA account:

  1. Go to Google Analytics.

  2. Click Start measuring.

  3. Enter the Account name. For example, Whatfix.

  4. Select the Account Data Sharing Settings.

  5. Click Next.

  6. Enter the Property name, that is, the domain name. For example,

  7. Select the Reporting country and the time zone.

  8. Select the Currency of your country.

  9. Click Next.

  10. Select the Industry category.

  11. Select the ways you want Google Analytics to work with your business.

your title goes here

You can select multiple options.

  1. Click Create.

  2. In the Google Analytics Terms of Service Agreement, select the country or region.

  3. Select the I also accept the Data Processing Terms as required by GDPR checkbox, and then click I Accept.

your title goes here

Your Google Analytics account is created.

Set up the Data Stream

Use the following steps to set up the data stream and copy the Measurement ID:

  1. In the Start collecting data section, click Web.

  2. Enter the Website URL, the Stream name, and then click Create stream.

your title goes here

The data stream gets created.

  1. In the Stream details section, click the Copy icon to copy the MEASUREMENT ID.

Set up Custom Dimensions

Whatfix requires custom dimensions - user_id, flow_id, src_id, ent_id, on_id, user_name, flow_title, etc., to be present in your GA account to create Whatfix reports in GA4.

Use the following steps to create custom dimensions in GA4:

  1. Go to your GA account.

  2. Click Admin.

  3. Click Custom definitions.

your title goes here

Ensure that you have the Custom Dimensions configured in your GA3 account handy.

  1. Click Create custom dimensions.

  2. Enter the Dimension name, Scope, Description, and the Event parameter.

your title goes here
  • The following is a sample Custom Dimension.

    • Dimension name: ent_id
    • Scope: Event
    • Description: The ENT ID required for mapping. (Not mandatory)
    • Event parameter: The event parameter can be same as the Dimension name, i.e., ent_id.
  • For the Custom dimension, user_id, enter the Event parameter as user_id_.

  1. Click Save.

  2. Repeat Steps 4 to 6 to set up the other custom dimensions.

your title goes here

For more information on the Custom Dimensions to be added and what they mean, see What are the Custom Dimensions to be added?.

Set up the reporting bundle

Earlier you could download reporting templates from the Google Marketplace and import them to GA3. With GA4, you have to manually create these reports.

Use the following steps to create a new report on GA4:

  1. Go to your GA account.

  2. On the navigation panel, click Explore.

  3. Click the Blank template.
    ga4_blank 1

  4. Enter the Exploration Name, i.e., the report name.

  5. Select the TECHNIQUE as Free form using the dropdown.

  6. Go to DIMENSIONS and then click +.

  7. Search for the required dimensions and select them using the checkbox.

  1. Click Import.

  2. Next to METRICS, click +.

  3. Search for the required metrics and select them using the checkbox.

  4. Click Import.

  5. Drag and drop or select the Dimensions as ROWS or COLUMNS to visualize the data as required.

  6. Add the required FILTERS, and then click APPLY.

  7. Click the Share exploration icon to share the report with other users.

your title goes here
  • The report gets saved automatically.

  • Go to Explore to view the created report.


your title goes here

Paste the Measurement ID from GA4 to the Whatfix Dashboard and finish setting up the account


Only an Account Manager can perform the following task. For more information about available roles, see Whatfix User Roles.

Use the following steps to configure your GA4 account with Whatfix:

  1. On the Whatfix Guidance dashboard, click Settings.

  2. Click Analytics.

  1. Select the Enable Google Analytics checkbox, and then click Setup.
  • Only if the Enable Google Analytics checkbox is enabled, the engagement events are recorded, i.e., events where users interact with Whatfix widgets.

  • If the Send All Events checkbox is enabled, all the engagement events in addition to loading events are recorded, i.e., events where Whatfix Widgets are loaded even if the users don't interact with them.

  • If you're capturing all the events and your organization is on the Standard Google Analytics plan, then some events may not be captured after it crosses the event limit. For more information, see Google Analytics Collection Limits and Quotas.

  1. On the Upgrade to Google Analytics GA4 pop-up, paste the copied Measurement ID.

  2. Click Connect to GA4.

  3. On the confirmation pop-up, click Connect to GA4.

your title goes here
  • Once you set up your GA4 account, you have to do a Push to production to start sending Whatfix usage data. For more information, see Push Whatfix content and widgets to Production.
  • If you've enabled Subresource Integrity (SRI) for your account and want to send Whatfix usage data to your GA4 account, ensure that you update the Whatfix JavaScript with the new JavaScript that is generated after doing a Push to production.

Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.