--- title: "Create a Google Analytics (GA4) profile" slug: "create-a-google-analytics-ga4-profile" updated: 2025-03-27T09:48:49Z published: 2025-03-27T09:48:49Z --- > ## Documentation Index > Fetch the complete documentation index at: https://support.whatfix.com/llms.txt > Use this file to discover all available pages before exploring further. # Capture Whatfix analytics data using Google Analytics (GA) ## Overview Whatfix provides easy-to-configure analytics with the most popular analytics tool - Google Analytics (GA). Note: 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, and more). Info: Your account is 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](/docs/create-a-google-analytics-ga4-profile#create) 2. [Set up Custom Dimensions](/docs/create-a-google-analytics-ga4-profile#customdimensions) 3. [Set up the reporting bundle](/docs/create-a-google-analytics-ga4-profile#report) 4. [Paste the Measurement ID from GA4 to the Whatfix Dashboard and finish setting up the account](/docs/create-a-google-analytics-ga4-profile#paste) --- ## Create the GA account and copy the Measurement ID Use the following steps to create a GA account: 1. Go to [Google Analytics](https://analytics.google.com/analytics/web/). 2. Click **Start measuring**. ![ga_4_start_measuring](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/ga_4_start_measuring.png) 3. Enter the **Account name**. For example, Whatfix. ![ga4_account_name](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/ga4_account_name.png) 4. Select the **Account Data Sharing Settings**. ![ga4_account_data_sharing_settings](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/ga4_account_data_sharing_settings.png) 5. Click **Next**. ![ga4_next](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/ga4_next.png) 6. Enter the **Property name**, that is, the domain name. For example, www.whatfix.com. ![ga4_property_name](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/ga4_property_name.png) 7. Select the **Reporting** country and the **time zone**. ![country_zone](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/country_zone.png) 8. Select the **Currency** of your country. ![currency](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/currency.png) 9. Click **Next**. ![ga4_next](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/ga4_next.png) 10. Select the **Industry category**. ![industry_category](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/industry_category.png) 11. Select the ways you want Google Analytics to work with your business. ![ga4_business](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/ga4_business.png) Info: Multiple options can be selected. 1. Click **Create**. ![ga4_create](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/ga4_create.png) 2. In the **Google Analytics Terms of Service Agreement**, select the country or region. ![term_country](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/term_country.png) 3. Select the **I also accept the Data Processing Terms as required by GDPR** checkbox, and then click **I Accept**. ![terms_i_accept](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/terms_i_accept.png) Info: 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**. ![stream_web](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/stream_web.png) 2. Enter the **Website URL**, the **Stream name**, and then click **Create stream**. ![create_stream](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/create_stream.png) Info: The data stream gets created. 1. In the **Stream details** section, click the **Copy** icon to copy the **MEASUREMENT ID**. ![new_measurement_id_ga4](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/new_measurement_id_ga4.png) --- ## Set up Custom Dimensions Whatfix requires custom dimensions - user_id, flow_id, src_id, ent_id, on_id, user_name, flow_title, and more, 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**. ![admin_ga4](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/admin_ga4.png) 3. Click **Custom definitions**. ![new_custom_definitions](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/new_custom_definitions.png) Info: Ensure that you have the Custom Dimensions configured in your GA3 account handy. 1. Click **Create custom dimensions**. ![create_custom](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/create_custom.png) 2. Enter the **Dimension name**, **Scope**, **Description**, and the **Event parameter**. ![new_custom_definition](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/new_custom_definition.png) Info: - 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**. ![save_custom_dimension](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/save_custom_dimension.png) 2. Repeat Steps 4 to 6 to set up the other custom dimensions. Info: For more information on the Custom Dimensions to be added and what they mean, see [What are the Custom Dimensions to be added?](/studio/docs/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**. ![explore_ga4](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/explore_ga4.png) 3. Click the **Blank** template. ![ga4_blank 1](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/ga4_blank%20%281%29.png) 4. Enter the **Exploration Name**, i.e., the report name. ![exploration_name](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/exploration_name.png) 5. Select the **TECHNIQUE** as **Free form** using the dropdown. ![ga4_reports_technique](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/ga4_reports_technique.png) 6. Go to **DIMENSIONS** and then click **+**. ![plus_dimension](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/plus_dimension.png) 7. Search for the required dimensions and select them using the checkbox. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/new_dimensions.gif) 1. Click **Import**. ![import_dimension](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/import_dimension.png) 2. Next to **METRICS**, click **+**. ![metrics](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/metrics.png) 3. Search for the required metrics and select them using the checkbox. ![Metrics](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/Metrics.gif) 4. Click **Import**. ![import_dimension](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/import_dimension.png) 5. Drag and drop or select the Dimensions as **ROWS** or **COLUMNS** to visualize the data as required. ![rows_columns1](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/rows_columns%281%29.png) 6. Add the required **FILTERS**, and then click **APPLY**. ![filter_ga4](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/filter_ga4.png) 7. Click the **Share exploration** icon to share the report with other users. ![share_exploration](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/share_exploration.png) Info: - The report gets saved automatically. - Go to **Explore** to view the created report. ![ga4_explore1](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/ga4_explore%281%29.png) ![report_name_explore](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/report_name_explore.png) Info: - For more information on how to create a sample report see, [Create Whatfix reports in Google Analytics (GA4): Beacon Loaded](/studio/docs/create-whatfix-reports-in-google-analytics-ga4-beacon-loaded). - For more information on the dimensions and filters used to create Whatfix reports, see [Add Dimensions and Filters to create Whatfix reports in GA4](/studio/docs/add-dimensions-and-filters-to-create-whatfix-reports-in-ga4). --- ## Paste the Measurement ID from GA4 to the Whatfix Dashboard and finish setting up the account **Note:** Only an **Account Manager** can perform the following task. For more information about available roles, see [Whatfix User Roles](/studio/docs/whatfix-user-roles). Use the following steps to configure your GA4 account with Whatfix: 1. On the Whatfix Guidance dashboard, click **Settings**. ![settings_ia.png](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/settings_ia.png) 2. Click **Analytics**. ![settings_click_analytics.png](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/settings_click_analytics.png) 1. Select the **Enable Google Analytics** checkbox, and then click **Setup**. ![ga_setup](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/ga_setup.png) Note: - Only if the **Enable Google Analytics** checkbox is enabled, the engagement events are recorded, that is, 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, that is, 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. 1. On the **Upgrade to Google Analytics GA4** pop-up, paste the copied Measurement ID. ![upgrade_ga4](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/upgrade_ga4.png) 2. Click **Connect to GA4**. ![ga4_connect_to_ga4_dashboard](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/ga4_connect_to_ga4_dashboard.png) 3. On the confirmation pop-up, click **Connect to GA4**. ![connect_ga4](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/connect_ga4.png) Info: - 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](/studio/docs/pushing-whatfix-content-to-production). - If you've enabled [Subresource Integrity](/studio/docs/subresource-integrity-sri) (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**. ## Related - [Data captured by Whatfix Analytics](/data-captured-by-whatfix-analytics.md)