guide

Website Widget Google Analytics Signals

Client-facing reference for the Google Analytics events TECOBI's website widget sends into the analytics installation already running on your website.

Use this page as the client-facing reference for the analytics signals emitted by the TECOBI website widget codebase installed on your website. It is focused on the widget's event behavior, transport logic, and reporting meaning.

What this page covers

  • The two Google Analytics event names the widget emits
  • When click and lead events fire
  • How the widget uses installed gtag or legacy ga
  • How clients should verify the signals
  • Which event to use for engagement versus conversion
Primary signals 2 events

The widget sends one event for engagement and one event for successful lead creation.

Client analytics Uses installed GA

The widget sends into the Google Analytics installation already running on the client site.

Submission signal Lead created

The submit-side event only fires after the widget receives a successful lead creation message.

Quick read

Most clients only need to understand which event means engagement and which event means a real widget lead.

Signal 1

Track widget entry and option engagement.

Use tecobi_widget_click to measure launcher opens and in-widget option clicks.

Signal 2

Track successful lead creation.

Use tecobi_widget_lead as the cleaner success event for widget-driven lead submissions.

Dependency

Make sure the site already has GA installed.

The widget checks for gtag or legacy ga on the client website. If neither exists, it will not create Google Analytics on its own.

Section map

Jump to the part of the signal reference your client or web team needs next.

The full reference is below, but most implementation and reporting questions fall into one of these areas.

Signal behavior

Separate widget entry, option intent, and successful lead creation instead of treating them as one signal.

Launcher clicks

  • Fires when the floating widget launcher is clicked.
  • Uses the event name tecobi_widget_click.
  • Current click payload includes category=click.

Option clicks

  • Uses the same tecobi_widget_click event.
  • Adds the option title as the label field.
  • Useful for separating general widget opens from deeper in-widget intent.

Lead submissions

  • Fires only after a successful tecobi-lead-creation message with a lead ID.
  • Uses the event name tecobi_widget_lead.
  • Does not currently attach a custom label or value.

Verification standard

Confirm the event path on the client site before using the signals in reporting or conversions.

  • Confirm Google Analytics is already installed on the client website before testing widget events.
  • Click the floating widget launcher and verify tecobi_widget_click appears in the analytics debugger or network tools.
  • Click a widget option and confirm the same click event appears with the option title as a label where supported.
  • Complete a real widget lead flow and verify tecobi_widget_lead fires only after successful lead creation.
  • If no events appear, verify the client site exposes window.gtag or window.ga before assuming the widget is the problem.
  • Use the lead event as the cleaner conversion signal when building reports, goals, or audiences.

Detailed reference

Give clients and website teams a signal map they can implement and validate without guessing.

These sections explain exactly what the widget emits, when it emits it, and how those signals should be interpreted.

Reference

1. What the widget sends

The client-installed TECOBI widget currently sends two Google Analytics event names into the website analytics implementation already running on the client site.

Event nameWhen it firesUse it for
tecobi_widget_click When the launcher is clicked, and when an option inside the widget is clicked Engagement
tecobi_widget_lead After a successful lead creation message includes a valid lead ID Submission success
Important

This page documents the signals emitted by the client-installed widget itself and how those signals should be interpreted in client analytics.

Reference

2. tecobi_widget_click

This is the widget engagement event. The widget uses the same event name for launcher opens and option clicks, then distinguishes the deeper option click with a label value.

Clients should treat this as the top-of-funnel widget engagement signal. It is useful for measuring how often visitors enter the widget and which option paths get selected once the widget is open.

InteractionCurrent parametersNotes
Launcher click category=click No label on the launcher open itself
Option click category=click label=<option title>

Launcher click example

gtag('event', 'tecobi_widget_click', {
  category: 'click'
});

Legacy ga launcher example

ga('send', 'event', 'click', 'tecobi_widget_click');

Option click example

gtag('event', 'tecobi_widget_click', {
  category: 'click',
  label: '<option title>'
});

Reference

3. tecobi_widget_lead

This is the successful widget submission signal. It does not fire just because the widget opens or because a form starts. It fires after the widget receives a successful lead creation message and a lead ID is present.

  • The widget listens for a tecobi-lead-creation message from the embedded form flow.
  • If the message does not include a valid lead ID, the lead event is not sent.
  • The current implementation does not attach a custom label or value to this event.

GA4 event example

gtag('event', 'tecobi_widget_lead');

Legacy ga event example

ga('send', 'event', 'Widget', 'tecobi_widget_lead');
Important

For client reporting, this is the cleaner event to use as the widget lead conversion signal.

Reference

4. How the widget sends events

The widget does not install Google Analytics itself. It checks for the analytics functions that already exist on the client website and uses those if they are available.

What the widget findsHow it sendsResult
window.gtag gtag('event', ...) Preferred when GA4 is installed on the client site
window.ga ga('send', 'event', ...) Legacy fallback for older Google Analytics installs
Neither function exists No Google Analytics event is sent The widget does not create a GA install on its own
Important

If the client site has no GA implementation available in the browser, the widget cannot produce Google Analytics event data by itself.

Reference

5. Client verification checklist

Before reporting on widget traffic or widget conversions, confirm the client site is actually exposing the analytics functions the widget expects and that both signals fire in the right sequence.

  • Confirm Google Analytics is already installed on the client website before testing widget events.
  • Click the floating widget launcher and verify tecobi_widget_click appears in the analytics debugger or network tools.
  • Click a widget option and confirm the same click event appears with the option title as a label where supported.
  • Complete a real widget lead flow and verify tecobi_widget_lead fires only after successful lead creation.
  • If no events appear, verify the client site exposes window.gtag or window.ga before assuming the widget is the problem.
  • Use the lead event as the cleaner conversion signal when building reports, goals, or audiences.

Reference

6. Reporting guidance

Use the two events for different reporting jobs instead of treating them as duplicates.

If a client builds goals, key events, audiences, or ad platform imports from the widget, the lead event is the more reliable success signal and the click event is the better top-of-funnel interaction signal.

Event nameBest useWhat it tells the client
tecobi_widget_click Engagement Launcher opens and option clicks
tecobi_widget_lead Conversion Successful widget-created leads

Client analytics rule

The widget sends events into the analytics implementation already on the client site.

If the website does not expose window.gtag or legacy window.ga, the widget does not invent a new Google Analytics installation on its own.

Reporting rule

Use the lead event for submit success and the click event for engagement.

That keeps reporting cleaner and prevents launcher activity from being confused with actual lead creation.

Search TECOBI

Search the blog, customer stories, and platform pages.

Start typing to search TECOBI content.