Analytics Tracking for the Lead Generator Widget

Introduction

The Lead Generator Widget is designed to be as simple as possible to implement while still offering basic analytics options. It supports basic tracking via Google Analytics 4 (GA4). This article explains which events are available in V1 and V2, how to connect your GA4 property, and how to verify events with GA4’s Debug View.

⚠️ Please note: To use the Lead Generator widget, you need a valid API key provided by PriceHubble. 

Table of Contents

1. Tracking in Lead Generator V1

2. Tracking in Lead Generator V2

3. How to find your GA4 Tracking ID

4. See events and mark conversions

1. Tracking in Lead Generator V1

The Lead Generator V1 can send a set of form-interaction events to GA4. To activate tracking, include your GA4 ID in the widget’s HTML code, so events are forwarded to your GA4 property. You can find a detailed explanation of how to create your HTML code here: Embedding the Lead Generator Widget on your website.

Event examples (grouped by the step they belong to):

• Property selection

  • SELECT_PROPERTY_TYPE – user selects a property type

  • SELECT_APARTMENT_SUBTYPE / SELECT_HOUSE_SUBTYPE – user selects an apartment/house subtype

• Property details

  • SET_LAND_AREA_SQM – user enters plot area

  • SET_LIVING_AREA_SQM – user enters living area

  • SET_BUILDING_YEAR – user enters year of construction

  • SET_NUMBER_OF_ROOMS / SET_NUMBER_OF_BATHROOMS – user enters rooms/bathrooms

  • SELECT_CONDITION – user selects property condition

  • SET_HAS_GARAGE / SET_HAS_PARKING_SPACE – user indicates garage/parking

  • SET_ADDRESS – user provides an address

• Contact & intent

  • SELECT_SALUTATION, SET_FIRST_NAME, SET_LAST_NAME, SET_PHONE, SET_EMAIL – user fills contact fields

  • SET_REASON – user selects the reason for the request

  • SET_SELLING_URGENCY – user indicates selling urgency

  • SET_PROPERTY_PRICE – user provides last paid price

  • SET_AGREED_TO_CUSTOMER_PRIVACY_POLICY – user accepts privacy policy

• Submission

  • VALUATION_REQUEST – set with action “sent” on successful submit, or “failed” on transmission error.

Tip: In GA4, keep event names as-is when mapping so you can filter/report by the exact names above.

2. Tracking in Lead Generator V2

With the second version of the Lead Generator Widget, we deliberately simplified the tracking approach. While our first version sent many detailed form events, this often created unnecessary complexity. Lead Generator V2 focuses instead on the essential interactions that really matter. 

This makes implementation easier, reduces technical overhead, and ensures that the tracking data remains clear and actionable.

The following events are available in V2:

• click_anything – A user clicks anywhere inside the widget.

• form_start – A user begins filling in the form.

• form_step_submit – A user completes a step within the form flow.

• form_submit – A user submits the final request via the last button.

To activate tracking, include your GA4 ID in the widget’s HTML code, so events are forwarded to your GA4 property. You can find a detailed explanation of how to create your HTML code here: Embedding the Lead Generator Widget on your website.

3. How to find your GA4 Tracking ID

To connect the widget to your Google Analytics 4 property, you need the Measurement ID (format G-XXXXXXXXXX). You’ll find it inside Google Analytics:

1. Open Google Analytics and select the correct Account and Property.

2. Go to Admin (gear icon) → under the Property column, choose Data streams → select your Web data stream.

3. On the Web stream details page, copy the Measurement ID shown near the top (e.g., G-ABC1234567).

Tip: If you don’t see events later, double-check you used the same ID as the one your website uses, and that you’re in the correct GA4 property.

4. See events and mark conversions

Because the Lead Generator runs in an iframe (third-party widget), you should first validate tracking in DebugView. 

Testing with DebugView (recommended during implementation)

• Install and enable a GA4 debugging extension in your browser (e.g., Google Analytics Debugger for Chrome).

• Reload the page where the widget is embedded.

• In GA4, go to Configure → DebugView and interact with the widget (click, start the form, complete a step, submit).

• You should see events appear within seconds.

  • V1 examples: SELECT_PROPERTY_TYPE, SET_LIVING_AREA_SQM, SET_EMAIL, VALUATION_REQUEST, etc.

  • V2 examples: click_anything, form_start, form_step_submit, form_submit.

After go-live
Use the Realtime report in GA4 to confirm events are coming through.

Mark conversions

• V2: mark form_submit as a conversion.

• V1: create a derived event from VALUATION_REQUEST with action = sent, then mark it as a conversion.

⚠️ Please note: This information is intended only as a basic guideline to help you get started with integrating and testing GA4 tracking of the Lead Generator Widget. We cannot provide professional consulting in the areas of tracking strategy, reporting, or performance marketing, and we cannot assume responsibility if settings differ from your business needs.

If you require a tailored setup or advanced analytics strategy, we recommend reaching out to a marketing or performance marketing expert/agency for professional support.