Overview

AppNavi Insights helps you understand how users interact with your web applications. It collects and organizes usage data so you can identify which pages and application areas are used most often, understand interaction patterns, and find opportunities to improve workflows and usability.

Insights can help you answer questions such as:

• Which application pages are visited most frequently?
• Which areas, forms, tables, and navigation elements receive the most interaction?
• How much time do users spend on specific pages or areas?
• Where do users encounter slow-loading pages?
• How do users move through an application?
• Which parts of an application are rarely used and may need improvement?

Insights focuses on user behavior within the application interface. It complements traditional application logs, which are generally used to investigate technical events, errors, and backend performance. Insights is not intended to replace those logging and monitoring solutions.

Who should use this guide?

This guide is intended for Tenant Owners, application administrators, and teams responsible for configuring or analyzing application usage.

Use this page as your starting point. It explains the main concepts and setup process before directing you to the detailed configuration and reporting guides.

Before you begin

Make sure you have:

• Access to the AppNavi Portal.
• The required permissions to manage tenant contracts and application settings.
• An application registered in AppNavi.
• An Insights contract available for assignment to the application.
• Access to the target application so you can verify that tracking is working.

Important: Insights must be enabled and configured for each application you want to analyze. Having access to the Insights area in the Portal does not, by itself, mean that tracking is active for every application.

How Insights works

Insights follows a simple process:

1. Enable Insights for an application: Assign the Insights contract and activate the required settings.
2. Configure tracking: Choose which pages, areas, and individual elements should be tracked.
3. Collect interaction data: AppNavi records configured user interactions and related usage information.
4. Analyze the results: Use the available Insights views to review page usage, area engagement, user journeys, and reports.
5. Identify improvements: Use the results to investigate underused features, navigation patterns, and potential usability or performance issues.

Set up Insights

Follow these steps to enable Insights for an application.

Step 1: Assign the Insights contract

1. Open the AppNavi Portal.
2. Navigate to Manage Tenant.
3. Open the Contracts tab.
4. Locate the Insights contract.
5. Assign the contract to the application you want to analyze.

The contract enables the application to use Insights. If the contract is not assigned, you cannot complete the application-level setup.

Step 2: Enable Insights and recording

1. Open the Insights tab in the Portal.
2. Search for and select your application.
3. Open the application's Insights settings.
4. Enable the Insights toggle.
5. Enable the Recording toggle to allow configured interaction events to be recorded.
6. Review the available tracking options and enable the ones required for your analysis.

Depending on your application's requirements, the basic configuration can include:

Other settings may be available for AI features, report assistance, surveys, and event caching.

Important: Disabling the main tracking or Recording setting can stop event collection. Review the settings together before testing the application.

Step 3: Configure areas and trackable elements

Use tracking configuration when you need more detailed information about specific parts of an application.

• Pages represent application URLs or views that users access.
• Areas represent sections within a page, such as a form, table, navigation menu, or container.
• Trackable elements represent individual interactive elements within an area.

For example, in an employee management application:

• The employee list may be a page.
• The employee details panel may be an area.
• The Save button within that panel may be a trackable element.

You can configure areas and elements using CSS selectors, activation settings, URL filters, text extraction, and other available options.

For detailed instructions, see:

• Insights UI Configuration
• Area
• Pages

Step 4: Verify the tracking configuration

Before analyzing the data, verify that the configured areas and elements are detected in the application.

1. Open the target application.
2. Log in and open the Avatar settings.
3. Navigate to Insights Settings.
4. Enable Debug Mode.
5. Check whether the configured areas and trackable elements are highlighted.
6. Confirm that the expected parts of the application are detected.
7. Disable Debug Mode after verification.

Note: Debug Mode displays tracking borders and can restrict normal navigation or interaction with tracked elements. Disable it before using the application normally.

If an area or element is not highlighted, review its CSS selector, activation settings, URL filter, and tracking configuration.

For more information, see Setup the Insights.

Core Insights concepts

Understanding these terms will help you interpret the analytics correctly.

The level of detail available in the analytics depends on which tracking options and areas have been configured and enabled.

Explore the Insights views

After tracking has been configured and data has been collected, use the available views to understand application usage.

Pages

The Pages view helps you understand which application pages users access and how they interact with them.

You can use it to review:

• Page usage and interaction activity.
• Pages with longer load times.
• Time spent on pages.
• Number of users interacting with each page.
• Areas and elements interacted with on a page.
• Copy and paste activity.

Use this view to identify frequently accessed pages and investigate pages that may have usability or loading-time issues.

See Pages for details.

Areas

The Areas view provides a more focused analysis of specific sections within application pages.

You can use it to review:

• Which areas receive the most interactions.
• How many users and sessions interact with an area.
• Click activity within an area.
• Time spent interacting with an area.
• Activity associated with individual URLs and trackable elements.

Use this view to understand how users engage with forms, tables, navigation sections, and other configured application areas.

See Area for details.

Journey View

Journey View visualizes how users move through an application. It helps you understand the sequence of interactions and identify frequently used paths or areas where users may encounter difficulties.

Depending on the available tracking data, you can analyze:

• User journeys and navigation paths.
• Start and end points of sessions.
• Time spent on pages and areas.
• Interaction activity along a journey.
• User and session counts for selected parts of a journey.

Use Journey View when you want to understand how different parts of an application connect during actual user activity.

See Journey View for details.

Reports

The Reports view allows you to explore Insights data using selected attributes, filters, and grouping options.

You can use it to:

• Select the data attributes you want to analyze.
• Filter records using available conditions.
• Group results by selected fields.
• Save report configurations for later use.
• Export report results to Excel.

Use Reports when you need a more specific view of the collected data or want to investigate a particular usage pattern.

See Reports for details.

Understand data privacy

Insights collects application usage and interaction data to provide analytics. Before enabling tracking, review what information is collected and how user identification is handled.

According to the data-collection documentation:

• AppNavi collects information such as visited pages, application areas, interaction patterns, page titles, and technical environment details.
• Browser, operating system, language, screen resolution, and approximate geographic information may be included.
• AppNavi generates a user ID for analytics. Depending on configuration, an existing identifier such as an email address may be used as the basis for an anonymized identifier.
• IP addresses may be processed in logs for security purposes; masked IP addresses are also described for system operation.
• The documentation states that URL query strings are not recorded because they may contain sensitive information.
• Insights data is stored in the AWS Europe data center.

Before enabling tracking: Review your organization's privacy requirements and decide which application areas and elements should be included or excluded. Pay particular attention to forms and fields that may contain confidential or personal information. Do not assume that every field or type of information is automatically excluded; confirm the applicable tracking and privacy configuration.

For more information, see What data is collected?.

Insights and traditional application logging

Insights and traditional application logging provide different perspectives on an application.

These approaches complement each other. Use Insights to understand the user experience and application usage, and use traditional logging when investigating technical or backend issues.

Troubleshooting

If the issue continues, review the detailed setup and configuration guides or contact your AppNavi administrator.

Setup the Insights

Overview

Insights allows you to capture and analyze user interactions within an application. Before viewing analytics, you must assign the Insights contract, enable tracking, and configure the required settings.

This guide explains how to enable Insights for an application and verify that tracking is working.

Prerequisites

Before starting, make sure you have:

• Access to the AppNavi Portal.
• Permission to manage application contracts and settings.
• An application registered in the Portal.

Step 1: Assign the Insights contract

1. Open Manage Tenant in the AppNavi Portal.
2. Select the Contracts tab.
3. Locate the Insights contract.
4. Assign it to the application you want to monitor.

The Insights contract must be assigned before you can configure tracking for the application.

Step 2: Enable Insights

1. Open the Insights tab.
2. Search for and select your application.
3. Open Insights Settings.
4. Enable the Insights and Recording toggles.

Both settings are required to activate Insights and record configured interaction events.

Step 3: Configure basic tracking

Choose the tracking options required for your application.

Additional options may be available for Insights AI features, report assistance, surveys, and event caching.

Important: If Recording is disabled, event collection stops, even if other tracking options are enabled.

Step 4: Configure areas and trackable elements

For more detailed tracking, use the Tracking Configuration section.

• Areas: Define sections of the application where interactions should be monitored.
• Trackable Elements: Select individual elements within an area, such as buttons, links, or form fields.

You can configure CSS selectors, URL filters, text extraction, audience restrictions, and journey settings.

Related documents

• Insights – Understand Insights and its analytics capabilities.
• Insights UI Configuration – Configure areas, trackable elements, and advanced tracking behavior.
• Area – Learn about area configuration and analytics.
• Pages – Learn about page tracking and analytics.
• Enhanced Page Tracking – Understand query string tracking for Single Page Applications.

• Area – Create and analyze application areas.
• Pages – Understand page usage and page-level analytics.

Analytics and reporting

• Journey View – Analyze user navigation paths and interactions.
• Reports – Create, filter, group, save, and export reports.

Privacy and data

• What data is collected? – Review the data collected and how user identification is handled.