Integrating VWO with Google Universal Analytics (GA) allows you to view VWO’s data in GA for each variation of your webpages and also filter out the data based on the metrics defined in GA.
Before proceeding, you must first check the installation of the Universal Analytics(UA) code present on your website. If it's installed via Google Tag Manager(GTM), please follow Integrating VWO with Universal Analytics by Using Google Tag Manager (Custom Events) to set up your VWO-GA integration.
The end-to-end process of integrating Google Universal Analytics (UA) with VWO is a three-step process.
-
Creating a Custom Dimension for VWO Tests
-
Enabling UA Integration in VWO
-
Creating a Custom Report
Creating a Custom Dimension for VWO Tests
To integrate VWO with Google Universal Analytics, you must first create a UA custom dimension.
Procedure
-
Login to your GA dashboard.
-
From the menu bar, click Admin select the appropriate account and property.
-
Under Property, go to Custom Definitions > Custom Dimensions.
The Custom Dimension page appears. -
In the Custom Dimension page, click New Custom Dimension.
-
In the Add Custom Dimension page, enter the following details:
-
Name: Enter a unique name for the dimension.
NOTE: You must create a separate dimension for each running test you want to integrate with UA. The dimension you create is used to identify and push VWO data into the corresponding dimension in UA. For example, VWO Test Id 1. -
Scope: Select the option User from the list. Scope determines which hits will be associated with the custom dimension value. To know more about the scope, refer to Determining Scope in Custom Dimensions.
-
Active: Enable this box to start collecting data and see the dimension in your reports right away.
-
Once you are done with all the configurations, click Create.
You have now created custom dimensions in UA.
Enabling UA Integration in VWO
While enabling the integration option, VWO will prompt you for the custom dimension number. Here, you must specify the index number that UA generated for the dimension. Refer to your dimension(s) to locate the custom dimension number for VWO.
Procedure
- Log in to your VWO account.
-
Go to the relevant testing dashboard and select the required test campaign to which you want to apply the integration.
-
Go to Configuration > Integrations, and select Google Universal Analytics.
NOTE: The Google Universal Analytics option appears only after you have enabled it in the Integrations section. - In the Custom Dimension field, enter the index of the custom dimension to which you are pushing the data.
NOTE: For each running test, we recommend using a different custom dimension index. This is because the scope of the custom dimension is User. If a single custom dimension is used, the last test information that the user became a part of will overwrite the information pushed previously. - In the Account Prefix field, enter the relevant UA account prefix.
NOTE: The Account prefix is not the same as your UA profile ID. It indicates the UA account where you want to push test data. For every running test, the UA dimension is unique. Ensure that the custom dimensions you used don't duplicate.
Creating a Custom Report
Procedure
-
Log in to your UA account.
- Using the panel on the left, go to Audience > Overview.
-
To add a segment, click Add Segment.
-
To create a custom report for the VWO tests you integrated with UA, click +New Segment.
-
To add conditions for your segment, go to Advanced > Conditions.
- To view the custom report for your test:
a. From the first dropdown, choose a custom dimension for which you want to view the report. For example, in the image below, "Plan ID" is the custom dimension.
b. Click in the input field. Just after this, a list of options corresponding to the selected custom dimensions appears. Choose the one relevant for you.
Do not type anything in this input field; choose from those that appear in the list.