1. Knowledge Base
  2. Features & Settings

Google Analytics Integration (GA4)

Convirza’s Google Analytics 4 (GA4) installation guide

Google has recently upgraded to Google Analytics 4 (GA4), and as of July 1st, 2023, Universal Analytics (the standard version of Google Analytics) will cease processing new data. GA4 has changed the way Convirza data is collected in two major ways

  1. Metrics have been reclassified as events as opposed to sessions. This means everything is now an event in GA4.
  2. Google did not make the necessary attribution fields available to 3rd party vendors link Convirza in GA4. As a result, we cannot send our source and medium data to their default channels. This means you will not see the source, medium, tracking number name, campaign name, or landing page data for events posted through the GA4 integration natively. Instead, we will send all attribution data, like source, medium, campaign name, etc, as a custom parameter.

In this document, we will show you how to view Convirza events in GA4 and create custom parameters to pull additional data into GA4.

Getting started

You’ll need to have your GA4 property’s Google tag installed on your website as the first step. To accomplish this, follow the few steps listed below.

  1. Create a “Data Stream” within GA4 by accessing “Admin” towards the bottom left and selecting the desired property.
  2. Select Data Streams and click “Add Stream,” next, fill out the stream details and save.
  3. Once saved, click on your newly created data stream and select “View Tag Instructions” under Google Tag. Here you will be given instructions on installing the Gtag to your website.

Integrating Convirza with Google Analytics 4

Convirza’s integration is group dependent within your Convirza account. Follow the instructions below for each group you’d like to integrate with GA4.

  1. Using the breadcrumb in Convirza, select and apply the group you wish to integrate with GA4
  2. Click on the Settings icon on the left-hand navigation bar
  3. Click Integration and select Google Analytics
  4. Locate your GA4 property’s measurement ID and API secret to complete the setup within Convirza.

    NOTE, to obtain both the measurement ID and API secret, review the steps below
    1. Measurement ID: Navigate to GA4, click “Admin,” then click “Data Streams,” here, and select the data stream you created in the Getting Started section above. You will find the GA4 Measurement ID on this page.
    2. API secret: In Data Streams, scroll down and select the Measurement Protocol API secrets tab. Here you will see your API secret value.
  5. Enter the measurement ID and API secret in Convirza, as shown in the screenshot below.

  6. Toggle the switch to ‘Active.’
  7. Select whether you want to send data for all tracking numbers on your account or only individual tracking numbers. If you select ‘Individual Tracking Numbers, ’ you will need to set up call actions on the individual numbers you wish to send data for by selecting “Send call for Google Analytics” as the action from the drop-down list.
    1. If sending calls for all tracking numbers, you will need to select whether to send data for all calls or unique calls only (will not include repeat callers)
    2. Select a minimum duration for sending calls to GA (any call below this value, in seconds, will not be sent to GA)
  8. Press the ‘Save’ button.
  9. Finally, to complete the setup process, you’ll need to receive an event through the integration first. For this reason, we recommend creating a test event (such as placing a call to a tracking number) immediately after activating the integration. This will allow you to see how the data looks in GA4. 
    1. NOTE, to see additional data within GA4, see Custom Dimensions in this document below.
Depending on the size of your business, integrating with GA4 could take anywhere from an hour or up to a few days to complete.

You will now see call counts as events populating within GA4. To see this data, navigate to Engagement -> Events. You will see your tracking number name and call counts under “Event Name.”

Custom Dimensions in GA4

Apart from seeing phone calls as events, Convirza has the ability to send the following data points to GA4 as custom dimensions.

Call Type

Route Name

Campaign Name



Referring Website


Custom Source 1

Custom Source 2

Custom Source 3

Custom Source 4

Custom Source 5


In the following, we will cover how to set up custom parameters within Google Analytics 4, as well as where to view each data point in reporting.

Setting up Custom Dimensions -


  1. Navigate to the “Admin” button within the desired GA4 property.
  2. Select Custom Definitions.

  3. Click Create Custom Dimensions.

    1. Dimension Name: This will be the name that appears in reports. Be descriptive by entering a name that best represents the data point being created. We recommend using naming conventions used in Convirza, for example, Campaign name or Tracking number name.
    2. Scope: Select “Event.”
    3. Description: Optional text used to identify a custom dimension or metric.
    4. Event parameter: Select the desired data point being created from the Event parameter drop-down list. For example, to view a campaign name as a custom parameter, select “campaign_name” as the Event parameter, and so on.

4. Lastly, click “Save.”
    1. Repeat the above steps for each data point. See the table above for a complete list of available custom dimensions to view within GA4.

How to view custom dimension data within Google Analytics 4 –

  1. Step one, navigate towards “Reports” within your GA4 property.
  2. Located towards the bottom of the page, select “Library.”
  3. From the list of reports, select “Events.”
  4. On the top right, under Customize Report and Report Data, select “Dimensions.”

  5. From the add dimension drop-down, select the desired custom dimension.

      1. Once selected, click the three vertically stacked dots and select “set as default.”

    6. Lastly, hit “Apply” toward the bottom of the screen to view the custom dimensions call data.