This guide will walk you through how to use and import the custom events and dimensions we’ve defined for you, so you can get the most insights in your own GA4 property.
Step 1: Understand What’s Available
We’ve defined custom dimensions and metrics you can use in your reports.
Custom Dimensions:
These track user interactions, such as:
* Lz Browser Language (lz_browser_language) - This is the language the user's browser is in
* Lz Translation Language (lz_language) - This is the language the page is getting translated into
* Lz Domain (lz_domain) - This is a trimmed version of the domain (including subdomains) of the page the stats are being collected from
* Lz Full URL (lz_page_url) - This is the full URL of the page sending the stats (including endpoints)
* Lz Is First Load (lz_is_first_load) - This records if it is the first load of the page
* Lz Status (lz_status) - This event is if your status is active or inactive with LetzChat
* ...and many more custom options are available, such as: payment button clicks, sign up button clicks, etc.
These dimensions are tied to events and can be used in explorations, segments, and reports.
Dealership Notice (ASC Events) - We have ASC events available to work with your script as well. Please reach out and we can share more details.
Step 2: Add Custom Definitions Manually
If your GA4 property doesn’t already have these definitions, you can add them manually.
1. Go to your GA4 Admin panel (gear icon on lower left-hand corner of screen)
2. Under “Property,” click “Custom definitions.”
3. Choose Custom dimensions or Custom metrics.
4. Click “Create custom dimension” or “Create custom metric.”
5. Use the information we’ve provided:
*Dimension Name: e.g. Lz Browser Language
*Scope: Event
*User Property/Parameter: e.g. lz_browser_language
Repeat for each one you'd like to use.
Another note - If you are not seeing the full list of columns/rows:
* Adjust SHOW COLUMN GROUPS - 20 (max)
* Adjust SHOW ROWS - 500 (max)
-- If you are not seeing all of your data - you may need to export to an external report builder for larger data sets --
Step 3: Using Custom Definitions in Reports
Once added, you can:
* Use them in Explorations for deep analysis.
* Add them as filters or segments in Reports.
* Use them as dimensions/metrics in Looker Studio dashboards.
Tips for Troubleshooting
*If events aren’t showing: Make sure the events are properly firing in the GA4 DebugView.
* If parameters don’t show: GA4 only lists custom parameters after they’ve been collected once.
* Please note - The events will only display in the Explore page reports after 24-48 hours of the initial event collection time. If your site is a dev site that doesn't get any visitors -- you may need to visit/interact with your page to fire these events, which will then be sent to your GA4.
An example of an Explore report (Freeform) with Table Visualization:
(Custom Events and Google Defined Events used -
* Lz Translation Language (Rows),
* Lz Browser Language (Columns),
* Event count (Values),
* as well as Lz Domain (filter) - contains - (eg. examplewebsite))
