Google Analytics is an analytics tool that helps you understand and analyze your web traffic. The Web Widget supports reporting of widget events and channel events including Chat, Help Center, Talk, Contact, and Ticket Forms in Google Analytics. This provides insights into how your users are interacting with the widget.
This article describes the events tracked in the widget, setting up event reporting, and viewing event reports in Google Analytics.
Related information:
Enabling widget event reporting for Google Analytics
By default, the Web Widget detects if Google Analytics is present on your web page. When the Google Analytics tag is on your web page, the widget automatically starts reporting events to Google Analytics.
To set up Google Analytics on your web page
- Set up a web property in your Google Analytics account.
- Paste the analytics tag to each web page with the embedded widget.
Viewing widget event data on Google Analytics
You can view and filter widget event data in your Google Analytics account.
To access the event data on Google Analytics
- Sign in to your Google Analytics account.
- On the left sidebar, select Behavior > Events > Top Events.
- Under Event Category, select Zendesk Web Widget.
Disabling widget event reporting for Google Analytics
The analytics setting API is used to disable the automatic widget event tracking for Google Analytics.
- To each webpage with the widget, add the analytics setting script set to “false”. Make sure it is before the widget code snippet in the body element.
<script type="text/javascript"> window.zESettings = { analytics: false }; </script> <!-- Start of your_subdomain Zendesk Widget script --> <script id="ze-snippet" src="https://static.zdassets.com/ekr/{YOUR_SNIPPET_KEY}"> </script> <!-- End of Zendesk Widget script -->
Reported widget events
An event is a description of an activity that has occurred. The following table lists and describes the events reported in the Web Widget.
Widget channel | Category | Action | Event label | Description |
General | Zendesk Web Widget | Web Widget Opened | When the end user opens the widget | |
Zendesk Web Widget | Web Widget Minimised ( | When the end user minimises the widget | ||
Chat | Zendesk Web Widget | Chat Opened | When Chat is initiated | |
Zendesk Web Widget | Chat Shown - same as Chat Opened | When Chat is initiated | ||
Chat Served by Operator |
Agent Display Name |
When an operator joins an initiated chat | ||
Zendesk Web Widget | Chat Rating Bad | When the end user submits a bad rating post-chat | ||
Zendesk Web Widget | Chat Rating Good | When the end user submits a good rating post-chat | ||
Zendesk Web Widget | Chat Comment Submitted | When the end user submits a comment along with their rating | ||
Zendesk Web Widget | Chat Request Form Submitted | Department Name | When the end user submits a chat request form | |
Zendesk Web Widget | Chat Offline Message Sent | When the end user submits a chat message when the agent is offline | ||
Contact and Ticket Forms | Zendesk Web Widget | Contact Form Shown |
If ticket forms are also enabled, the label includes Ticket Form ID and Ticket Form name |
When the contact form is shown to the end user |
Zendesk Web Widget | Contact Form Submitted | Ticket Form ID, Ticket Form name | When the end user submits the contact form | |
Help Center | Zendesk Web Widget | Help Center Shown | When the end user is presented with the Help Center | |
Zendesk Web Widget | Help Center Search | Search term | When the end user searches the Help Center in the widget | |
Zendesk Web Widget | Help Center Article Clicked | Article ID, Article name | When the end user clicks on a Help Center article link | |
Zendesk Web Widget | Help Center View Original Article Clicked | Article ID, Article name | When the end user views the Help Center article | |
Talk | Zendesk Web Widget | Talk Shown | Talk contact option | When the end user is presented with Talk |
Zendesk Web Widget | Talk Callback Request Submitted | When the end user submits a callback request |
8 Comments
Hello, which are the events sent to Google Analytics? I use the Lite Version of Zopim and I see only three events: Button Clicked, Offline Message Sent and Seved by Operator. I do not see any other events, such as Chat Opened. Thank You!
Hi Lulia,
Google Analytics events are available across all Chat versions, including the Lite version of Zopim, so you should be seeing them in your account (as long as the end users are triggering them, of course). They won't be sent to your Google Analytics account if your visitors aren't performing those actions.
Thanks,
- Miranda.
Senior Product Manager, Web Widget
Hi, Miranda, and thank you for your reply. I am a little confused though - if I see in my GA reports events such as Server by Operator shouldn't I also see an event such as Chat Opened? Because the user obviously opens the chat window before initiating the conversation. Would you be so kind as to clarify this for me? Thanks again.
Hello Lulia,
I've created a ticket on your behalf so one of our developers can look into this issue more in-depth. You should receive an email followed by a response from our development team.
Best regards.
hi every one
Hi James,
This is the technical knowledge base for Zendesk. Is there a question we can assist you with?
Good morning,
I am wondering if these metrics need to get updated - I am seeing Events such as Help Center Article Viewed but not seeing Help Center Article Clicked. I would assume that in order for a customer to view the content, they would first need to click. Is there something that I'm missing here?
Hi Ryan Oakman,
Thanks for your message.
Please sign in to leave a comment.