Validate Unbxd Analytics events and show errors and warnings
Unbxd Analytics Validator Extension
Install the extension. Click Start Testing button on your eCommerce page integrated with Unbxd Site Search. Validate that you are able to pass all the events successfully to Unbxd with the right set of parameters.
What does it validate?
------------------------------------
We have currently classified analytics issues broadly into following 2 categories:
1. To detect which version of Analytics SDK is loading on the site, Check for UnbxdSiteName and print it, Check if Analytics Tracking is disabled & if `Unbxd.track` method is available on the window.
2. Are relevant events fired correctly:
- Are all events required for a particular page type fired (search or browse page along with recommendation widgets)
- Are the events having all the required mandatory parameters (for example, \"pid\" must be sent for a click event)
- Are there any other additional parameters that can be sent in each event to improve analytics -> these are shown as warning items
Once all the events are detected, the validator plugin then generates a CSV report, which can be downloaded to be shared across the team.
How to install & use the extension
---------------------------------------------------------
1. Install the extension from the this page by clicking on \"Add to Chrome\" button
2. Go to any Unbxd customer website & open the developer tools. Refresh the page.
3. Click on the \"ValidateUnbxdAnalytics\" tab in the developer toolbar.
4. Select your page type (either Search or Category Page) & check the \"Recommendation widget\" checkbox if you want to test Recommendation events as well.
5. Click on \"Start Testing\"
6. Go to the site, perform all the usual activities that a user does on an eCommerce site like, search for something, click a product from the search results, add that product into the cart, place an order etc. All of these activities would generate Unbxd Analytics tracking events. These will be shown in the extension's UI.
7. Once you are done with performing all actions to generate events, click on the \"Stop\" button. This will generate a report which highlights successful events as well as any missing mandatory or good to have events.
8. You can also download a CSV report of the same by clicking on the \"Download CSV\" button
Release History
--------------------------
VERSION 2.1.2 - RELEASE DATE JULY 16, 2024
ChangeLog:
[Add] Validation of the revamped 'facets' event under analytics v2
[Add] Validation of a new 'sort' event
VERSION 2.1.1 - RELEASE DATE JUNE 27, 2024
ChangeLog:
[Add] Enable validation of product_Impression event for v2
VERSION 2.1.0 - RELEASE DATE JUNE 04, 2024
Our Analytics Tracking just got a major boost!
We’ve bid farewell to the old tracking method and embraced the efficiency of navigator.sendBeacon.
ChangeLog:
[Add] Check 'misc' payload data for all the events, validate special AS types passed into the 'misc' object.
[Add] Check for the window variable 'UnbxdSiteName' and print it.
[Add] Check if analytics tracking is disabled
[Add] Check special AS types like FIELD_TYPE_SUGGESTION & TRENDING_QUERIES in the 'misc' data
[Modified] field_name & field_value made optional if the AS docType is IN_FIELD
[Modified] Check for pid & src_query for AS docType POPULAR_PRODUCTS_FILTERED
[Removed] Removed validation on the event 'DwellTime', as it is not being used.
[Removed] Removed 'warning' msg from the summary of analytics validation report.
VERSION 2.0.0 - RELEASE DATE MAY 18, 2023
We have come up with a newer version of Analytics SDK, where new events are added and existing event's payloads are modified.
Hence the release of v2.0.0 version of validator plugin will accommodate all the new behaviours along with maintaining the backward compatibility to track and validate existing events.
ChangeLog:
[Add] Auto detect v1 & v2 Analytics SDK, based on the http request call present in network tab.
[Add] Added a new event 'pageView' and validate their payloads.
[Add] New logo, both for dark mode and lite mode & added favicon.
[Add] Added 'Error message' column which shows descriptive error messages for payloads.
[Add] Added a differentiator text 'recs' for click event to differentiate between recs click vs search/category product click.
[Add] Added validations for recs click event, both v1 and v2 recs product.
[Add] Validation for autosuggest payloads
[Add] Added missing payloads like 'path', 'identifier' & 'pr'.
[Add] V1 vs V2 segregation of flow & show summary accordingly after validation is stopped.
[Modified] Remove warning status for event, an event is either passed or failed.
[Modified] Change some mandatory payloads to optional.
[Modified] order event validation base on payload data for analytics v1
[Fixed] Handle export CSV for null & undefined values.
[Removed] validating attribution.
VERSION 0.0.3
- [Feature] Support Dark Mode.
- [Fix] Add error, warning and dropdown icons.
- [Fix] Show Warning Msg if some other page is accessed instead of the PageType selected from Dropdown.
- [Fix] Track recs widget only if the checkbox is checked.
VERSION 0.0.2 (FIRST PUBLIC RELEASE) RELEASE DATE JULY 28, 2020
Source Manifest.json
How to download and manually install Unbxd Analytics Validator extension for Chrome
Looking for a way to install Unbxd Analytics Validator extensions for Chrome, you can search for them in the Chrome Web Store, clicking the "Add to Chrome" button, and following the straightforward process.
However, you may need to install Unbxd Analytics Validator extensions manually, this article outlines two simple methods to effortlessly install Unbxd Analytics Validator extensions, whether they come as unpacked folders in compressed formats like .zip or as .crx files.
Method 1: Download Unbxd Analytics Validator extension and manually install through Drag &Drop
If you ever need to manually install a Unbxd Analytics Validator extension for Chrome, don't worry, it's a simple process. Just follow these easy steps, and you will have your extension ready to use in no time.
Step 1: Download the Unbxd Analytics Validator Extension by clicking the "Download CRX" button on the website.
Look for the Unbxd Analytics Validator extension you wish to install. Go to the website and download the Unbxd Analytics Validator extension package, which is usually a .CRX file and comes in a zipped file. Here ".crx" file is the format for Unbxd Analytics Validator extension that contains all the data.
Step 2: Extract &Arrange Files
Once the file is downloaded, extract that file into its own folder. Similarly, give that extension files a permanent home. In other words, keep it in a folder that you don't accidentally delete it because these files will be needed to make that extension work.
Step 3: Go to the Chrome Extensions Page
Open Google Chrome and in the address bar, type chrome://extensions; it will open the Google Chrome extensions page. Make sure that "My extensions" is selected in the sidebar.
Step 4: Drag and Drop the Extension
Now, go to the folder where you extracted the Unbxd Analytics Validator extension and drag &drop the extension file from there anywhere onto the extension page within Google Chrome.
Step 5: Complete the Installation
Once you drag and drop the extension file, follow the steps that Google Chrome takes you through. Similarly, if the extension file is of .crx file format, you will be required to review the permissions and then add the extension.
Now, you can manage that added extension as you would like to with any other Chrome extension that you added through Chrome Webstore. Its icon will also appear in the Google Chrome Menu on the right side of the address bar once you activate it.
Method 2: Download Unbxd Analytics Validator extension for Chrome and install in Developer Mode
This is another method to install Unbxd Analytics Validator extension manually, but the twist is that here, you install by enabling the developer mode option provided in Google Chrome. This mode is commonly used for testing extensions or running unpublished tools.
Step 1: Download the Unbxd Analytics Validator extension file
Select and download the Unbxd Analytics Validator extension by clicking the 'Download CRX' button on the website.
Step 2: Extract the downloaded contents
Convert the file to a ZIP file if it is in CRX format then extract the Unbxd Analytics Validator extension zip file or folder that you downloaded. Make sure you extract it using the same folder name and keep it safely in another folder, so you don't delete it by mistake. The extracted folder will be needed to keep your Unbxd Analytics Validator extension running.
Step 3: Open Chrome Extension Setting Page
In the address bar of Google Chrome, type chrome://extensions and open the Chrome Extension Page.
Step 4: Enable Developer Mode
After opening the Chrome Extension page, look at the top right side, and you will find the toggle option of "Developer mode."Simply enable that developer mode option.
Step 5: Load the Unpacked Extension
Once you enable the developer mode option, you will see the menu of Load Unpacked, Pack Extensions and Update. From that, select the option "Load unpacked."
Step 6: Select the Extension Folder
Once the pop-up opens upon clicking Load unpacked, select the Unbxd Analytics Validator extension directory and click on the "Select Folder "button.
Step 7: Confirm and Install
After you select an extension folder of a Google Chrome extension you're installing manually, confirm its installation for the final time and let the installation complete.
Conclusion
Here we've made a step-by-step guide on How to manually install Unbxd Analytics Validator extension in 2 ways. We hope this guide proves helpful.
Similar Extensions
SANDBOX 249 7 ★ 29.84KiB
Altair GraphQL Client 249 68 ★ 6.78MiB
URL Query Editor 249 5 ★ 108KiB
Oxylabs Proxy Extension 249 47 ★ 321KiB
Adswerve - dataLayer Inspector+ 249 56 ★ 517KiB
GTM Sonar 249 14 ★ 15.94KiB
Url Editor PRO 249 10 ★ 98.22KiB
Debugger for Google Analytics 4 (GA4) 249 28 ★ 102KiB
ObservePoint Debugger 249 52 ★ 3.6MiB
Parameters Editor 249 3 ★ 61.5KiB
URL Params Editor 249 9 ★ 155KiB
Timely 249 8 ★ 10.88KiB
Analytics Debugger 249 211 ★ 300KiB
Tealium Tools 249 28 ★ 2.13MiB
Datalayer Checker 249 33 ★ 93.13KiB
dataslayer 249 80 ★ 417KiB
ChromeiQL 249 32 ★ 682KiB
JSON Formatter 249 33 ★ 102KiB
MageSpecialist DevTools for Magento 249 14 ★ 4.64MiB
TagHound - Analytics/GTM/Pixel Debugger 249 63 ★ 1.77MiB
RTB House Tags Helper 249 25 ★ 279KiB
Simple Data Layer Viewer 249 13 ★ 77.96KiB
Tagmate Tracker for GA/GA4 Events 249 7 ★ 4.94MiB
Query params 249 2 ★ 85.04KiB