> For the complete documentation index, see [llms.txt](https://docs.hackle.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hackle.io/en/data/chart-types/data-insight-analysis.md).

# Insight Analysis

This document explains, with examples, how to use the Insight feature within the Data Analytics tab to gain insights from your data.

## Introduction to Insight

The Insight feature is a data analytics tool that displays data values, conversion rates, trends, and share breakdowns in tables and visual graphs through a combination of events you configure.\
By setting events in \[Analysis Items] and \[User Groups], you can analyze user behavior and select from various chart types.

As shown below, you can access Insight Analysis by clicking the Insight tab under Data Analytics.

![](https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-cab12783fa4d4a570422e5d40ff399008988f052%2F50656b2-image_ca344531a3c18424.png?alt=media)

## Step-by-step walkthrough

{% stepper %}
{% step %}

### Select analysis items and criteria

In Analysis Items, select the event name and the calculation method for that event.

In the Conversion section, you can easily calculate a conversion rate (%) by setting the \[denominator]/\[numerator] from the selected items.

![](https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-d3c9da7255ec9b49b15ae4bd47813da06e10f411%2F8f0ff7c-image_d699793b2076f6ca.png?alt=media)
{% endstep %}

{% step %}

### Configure the user group to analyze

Select the detailed attributes of users who triggered the selected event. You can give the configured \[User Group] any name that is easy to identify. In addition to properties, you can also set more detailed conditions using filters.

![](https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-9bc320f429f0ce065c7afdc8a455e687bad9b9f1%2F80eb317-image_eeaaa6476cd1da9d.png?alt=media)
{% endstep %}

{% step %}

### Select the grouping criteria

Use the Group By feature to select the criteria by which to group the data.

![](https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-dacc796f831037faf9e418000b1addd7be2c24fa%2F748f890-image_87a87f33db5182a3.png?alt=media)
{% endstep %}

{% step %}

### Using the Insight chart

1. View interval / Period / Period comparison
   1. In the upper left of the displayed chart, you can set the **view interval** (by hour, day, week, or month), the **view period** (7 days, 30 days, custom, etc.), and the **comparison period** (vs. previous day, previous week, or previous month) in detail.
2. Select chart type
   1. In the upper right, you can select the **chart type** to display. Currently supported types include line chart, stacked line chart, vertical bar chart, pie chart, table chart, and metric chart.
3. Chart visualization
   1. Click a legend in the orange box shown in the image below, or click a checkbox in the results table to toggle individual items on/off and **reflect only the desired items in the graph**.
4. Raw data download
   1. For more detailed information, click the \[Download] button to download the raw data.

![](https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-c7b449def0d61d2d30ead9256183c43c851c98d3%2F0348c3d-image_2920d9db7a6797c6.png?alt=media)

When you hover over the graph as shown in the image below, you can check detailed data such as the number of users at that point in time and the difference (%) compared to the comparison period via a **tooltip**.

You can also click (+) to **add a note** on a specific date, and click **\[Save as Cohort]** to immediately save the users who triggered the event at that point and under those conditions as a cohort.

![](https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-738cc15a40d26758a269a2562f40e3a57aa576f6%2F1d5e784-image_30888e113d692fab.png?alt=media)
{% endstep %}

{% step %}

### Saving a chart

Enter a title for your configured data and save the chart to continuously monitor key charts.

![](https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-ba5415c8efa8c3f4bd70c1d06dd84b9195e91f3d%2Fc93cff2-image_3ab472d1138530e8.png?alt=media)

Saved charts can be found in \[Data Report].

![](https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-7ecfbc6450ade146729fad8d4ed5e54c23434727%2F6ea7957-image_d02d6e9da066f8ae.png?alt=media)
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Analysis TIP: Try adding notes to charts and dates
{% endhint %}

#### Adding notes to charts and dates

To gain insights from data analysis, you need to understand the reasons behind graph fluctuations. For example, large-scale marketing campaigns, service maintenance windows, specific feature launches, version updates, and other events essential to service operations may have occurred.

Since data may have changed according to these events, adding notes about them makes it easy to understand why a graph rose or fell during analysis, and lets you see the impact and results of changes at a glance.

As shown in the image below, you can add a note via the \[+] indicator below a date. Once added, notes are displayed as \[1], \[2], etc., so you can immediately check notes left for that date. Notes come in two types, so you can choose the one that fits the situation.

1. Add a note to a date: If you add a note to a specific date, the same note will appear whenever you view that date on any other chart. This means you never miss what happened on that day without needing to add a note every time.
2. Add a note to a chart: You can also add notes only to the 'chart' you are currently viewing. For example, in a chart that shows top revenue products, you might add a note like "Revenue list changed due to product A being out of stock." This lets you leave only the hints relevant to that specific chart's analysis.

![Add and view notes in Insight.](https://143363954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyAVlNQhS253reum0Ce94%2Fuploads%2Fgit-blob-278abe6dee40f7395b89d45cff461f0d193b3b83%2F77bdee8-image_06f3f59883107205.png?alt=media)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.hackle.io/en/data/chart-types/data-insight-analysis.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.