The widget sends one event for engagement and one event for successful lead creation.
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
The widget sends into the Google Analytics installation already running on the client site.
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.
See the two event names and the exact moments they fire.
Widget click eventReview launcher clicks, option clicks, and the click label behavior.
Widget lead eventSee the successful lead-creation trigger used for submissions.
GA transport logicUnderstand how the widget uses gtag or legacy ga on the client site.
Client verificationConfirm the widget signals are firing correctly before reporting on them.
Reporting guidanceDecide which event to use for engagement and which one to use for conversion.
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 name | When it fires | Use 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 |
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.
| Interaction | Current parameters | Notes |
|---|---|---|
| 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'); 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 finds | How it sends | Result |
|---|---|---|
| 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 |
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 name | Best use | What 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.