Certain steps must be taken when installing cxOverstat on a new system. Different steps are required when upgrading an existing system.
To use Acoustic™ Tealeaf cxOverstat, you must meet certain system requirements and you must allow sufficient time to accumulate meaningful data. Most high-volume sites have sufficient site visitors to gather meaningful data for analysis within a few minutes. Low-volume sites might have to wait a few days to obtain meaningful insights.
The following table lists what you need for cxOverstat.
| Prerequisite | Description |
|---|---|
| CX and cxImpact |
CX and cxImpact must be installed and configured. |
| Access to Browser Based Replay |
Each cxOverstat user must have a cxImpact user account that has permission to access Browser Based Replay. Browser-based Replay is used to replay visitor sessions and can be used to view cxOverstat related information through a set of overlays. cxOverstat overlays are not available in CX RealiTea Viewer. Note: cxOverstat is not supported for users that have permission to use cxReveal only.
|
| Supported HTML5 web browser |
To view cxOverstat overlays, you must use a supported web browser that has HTML5 enabled. Note: The reporting features of cxOverstatcxOverstat are limited by the HTML5-based data that is captured by UI Capture j2.
The following web browsers are supported by cxOverstat. This list of browsers is more restrictive than the browsers supported for access to the Tealeaf Portal.
The Portal does not support access from mobile browsers. |
| UI Capture JavaScript™ |
Add UI Capture JavaScript solution on your web server and add references to include the JavaScript on every page you want to monitor on your web application. Note: Adding cxOverstat JavaScript references to your web application requires developer-level skills and access to the application on the web server that you are monitoring.
|
| Allow time to elapse to gather data |
Allow a sufficient time period to elapse for a statistically significant set of usability data to be gathered from visitor sessions. This period depends on the volume of traffic on your web application. It is best to gather a minimum of 1000 clicks per page before using the data that is provided by cxOverstat. |
If you are licensing cxOverstat for an existing Tealeaf system, you must run the upgrader, apply your license, and then choose to install cxOverstat, which enables access to the event objects required for correct operation.
Deploying cxOverstat
The following procedure describes how to deploy cxOverstat for use with Acoustic Tealeaf.
You must install and configure Tealeaf CX and cxImpact before you install cxOverstat.
Acoustic recommends that you first deploy cxOverstat in a development or test environment. When you verify functionality, you can move the configuration to your production environment.
- Log on to the Tealeaf Report Server.
- Run <Tealeaf>\Enablers\cxOverstat\TLsetup.exe to start the cxOverstat installer.
Replace <Tealeaf> with the folder name for your Tealeaf installation.
- Select the language that you want to use for the installation screens and click OK.
- On the Welcome screen, click Next to continue to the License screen.
- In the License screen, review and accept the license terms.
- On the Installation screen, click Install to start the installation.
- On the Installation Complete screen, click Finish.
- If the Tealeaf UI Capture JavaScript solution is not already deployed to your web server, do so now.
- Add a cxOverstat JavaScript reference to each web page that you want to capture cxOverstat data.
Adding cxOverstat JavaScript references to your web application requires access to the application on the web server that you are monitoring.
- Log in to the Tealeaf Portal and click Configure > Event Manager.
- From Event Manager, edit the
Step - ScreenView URLdimension. Make sure that Values to Record is set to Whitelist Only; then, create a whitelist for the dimension.Whitelist Only is the default setting for the Values to Record option. A whitelist helps to control the amount of cxOverstat data that is recorded. - Select the events and dimensions that are related to cxOverstat that you want to track.
After the installation procedure is complete, a sufficient time period must elapse for a statistically significant set of usability data to be gathered from visitor sessions. This period depends on the volume of traffic on your web application.
Gather a minimum of 1000 clicks per page before you use the data that is provided by cxOverstat.
Most high-volume sites have sufficient site visitors to gather meaningful data for analysis within a few minutes. Low-volume sites might have to wait a few days to obtain meaningful insights.
cxOverstat data retention is customizable. You can minimize data storage size by choosing how long their data will be stored. By default, hourly data is retained for 3 days, while daily data is retained for 90 days.
To change the default data retention time period in the Tealeaf Portal, go to Tealeaf > Portal Management > CX Settings > Data Retention. Click on the value that you want to change. Enter the new value in the form near the bottom of the page, and click Save.
cxOverstat daily aggregation defaults to daily through previous day. This ensures that cxOverstat daily data is always available as of yesterday, and a request for information will use a daily table for all date duration other than the current day.