Skip to content
Open
140 changes: 102 additions & 38 deletions docs/reports.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -132,91 +132,146 @@ You can select the following filtering options to show a subset of the propertie

- Select "Event" to show only the [Event properties](/docs/data-structure/events-and-properties).
- Select "User" to show only the [Profile properties](/docs/data-structure/events-and-properties).
- If you set up [Group Analytics](/docs/data-structure/advanced/group-analytics), the group keys will show up individually under their display names. You can select any Group key to show only the Group properties relevant to the selected Group key.
- Select "Computed" to show only the [Computed properties](/docs/features/computed-properties).
- If you set up [Group Analytics](/docs/data-structure/advanced/group-analytics), the group keys will appear individually under their respective display names. You can select any Group key to show only the Group properties relevant to the selected Group key.
- Select "Cohorts" to show only the [Cohorts](/docs/users/cohorts).
- If you set up [Experiments](/docs/experiments), the experiments will show up individually under their display names.
- If you set up [Experiments](/docs/experiments), they will appear individually under their respective display names.

<Frame>
![/prefix.png](/images/prefix.png)
![/insights\_properties\_section.png](/insights_properties_section.png)
</Frame>

### Duplicating Metrics

To duplicate any metrics or properties in your query, select the inline action menu and choose **Duplicate**. Delete any events or properties by clicking the **trash** icon.
To duplicate any metrics or properties in your query, select the inline action menu and choose **Duplicate**. Delete any events or properties by clicking the **Remove** button.

<Frame>
![image](/images/f496b609-47a3-4287-95f8-e9e6f2ac915d.png)
<img
src="/images/event_options.png"
alt="Event Options"
title="Event Options"
className="mx-auto"
style={{ width:"57%" }}
/>
</Frame>

## Date Range

Determine the time range of a query by clicking on the date range selector. The date range selector is common across all reports.

All dates and times in Mixpanel reflect the project timezone. The default on most reports is “Last 30 days” (displayed as "30D"), but there are a variety of preset options, as well as the option to select a custom date range.
All dates and times in Mixpanel reflect the project's timezone [(by default, UTC)](/docs/orgs-and-projects/managing-projects#changing-your-timezone). The default for most reports is “Last 30 days” (displayed as "30D"), but there are a variety of preset options, as well as the option to select a custom date range.

<Frame>
![date rate](/images/date-range.png)
![new date rate](/images/new_date_range.png)
</Frame>

For these date ranges, the output shows results from the last complete 30 days, plus any results from the current incomplete day.
For these date ranges, the output shows results from the last complete days, plus any results from the current incomplete day.

| Preset | Description |
| --- | --- |
| Custom | Gives multiple customization possibilities, explained below. |
| Today | Includes the current incomplete day up to the current second. |
| Yesterday | Includes the whole of the previous day from midnight to midnight. |
| Last 7 days | Last 7 days and the query count from the current incomplete day up to the current second. |
| Last 30 days | Last 30 days and the query count from the current incomplete day up to the current second. |
| Last 3 months | Last 3 months and the query count from the current incomplete day up to the current second. |
| Last 6 months | Last 6 months and the query count from the current incomplete day up to the current second. |
| Last 12 months | Last 12 months and the query count from the current incomplete day up to the current second. |
| Week to Date | From midnight of the start of the current week up to the current second. |
| Month to Date | From midnight of the start of the current month up to the current second. |
| Quarter to Date | From midnight of the start of the current quarter up to the current second. |
| Year to Date | From midnight of the start of the current year up to the current second. |

### Select a Date Range
### Custom

Selecting **Custom** on the date range selector opens up some additional options: "Last", "Fixed", and "Since".
Selecting **Custom** on the date range selector opens up some additional options: "Recently Applied", "Fixed", Last", Since", "Period to date", and "Previous period".

### Last
### Recently Applied

“In the last” allows you to select a rolling time range similar to the default “last 30 days”, but you have the flexibility to choose the time value and scale, either days, weeks, or months.
This option will give you access to a prompt field, where you can type the range you're looking for (_'last 16 days starting on June 4th'_) for the AI to resolve for you, and also see a list of the last ranges used.

<Frame>
![/Screen\_Shot\_2022-07-11\_at\_3.17.05\_PM.png](/images/Screen_Shot_2022-07-11_at_3.17.05_PM.png)
<img
src="/images/date_picker_recently_applied.png"
alt="Date Picker Recently Applied"
title="Date Picker Recently Applied"
className="mx-auto"
/>
</Frame>

If you need to, you can click on the **\+ Ending** button and shift back the desired time window by a selected number of days. So, for instance, in the example below, we are still looking at a 2-week window that is shifted by 7 days back. This is a rolling date range, and if this report is saved as a bookmark or added to a board, the actual dates will continue to update to show this relative time period vs. today.
### Fixed

“Fixed” allows you to select two dates to query between by entering the same start and end date. If you save this report as a bookmark or add it to a board, the date range selection will always persist.

<Frame>
![/Screen\_Shot\_2022-07-11\_at\_3.18.03\_PM.png](/images/Screen_Shot_2022-07-11_at_3.18.03_PM.png)
<img
src="/images/date_picker_fixed.png"
alt="Date Picker Fixed"
title="Date Picker Fixed"
className="mx-auto"
/>
</Frame>

### Fixed
### Last

“Last" allows you to select a rolling time range similar to the default “last 30 days”, but you have the flexibility to choose the time value and scale, either days, weeks, months, or quarters.

“Fixed” allows you to select two dates to query between, by entering the same start & end date. If you save this report as a bookmark or add it to a board, the date range selection will always persist.
<Frame>
<img
src="/images/date_picker_last.png"
alt="Date Picker Last"
title="Date Picker Last"
className="mx-auto"
/>
</Frame>

If needed, you can adjust the desired time window backward by the selected number of days in the "Ending" section. For instance, in the example below, we are still looking at a 2-week window that is shifted 7 days back. This is a rolling date range, and if this report is saved as a bookmark or added to a board, the actual dates will continue to update to show this relative time period vs. today.

<Frame>
![/Screen\_Shot\_2022-07-11\_at\_3.21.03\_PM.png](/images/Screen_Shot_2022-07-11_at_3.21.03_PM.png)
![Date Picker Last Rolling Window](/images/date_picker_last_rolling_window.png)
</Frame>

### Since

“Since” allows you to select a specific date to query for all data since that start date.

### To Date
<Frame>
<img
src="/images/date_picker_since.png"
alt="Date Picker Since"
title="Date Picker Since"
className="mx-auto"
/>
</Frame>

"To Date" allows you to select a date range that will update dynamically to fit the current interval. You can choose 'Week to Date', 'Month to Date', 'Quarter to Date', and 'Year to Date'. When the boundary of the interval is passed, the date range will automatically update to include only the current interval. For example, if "Month to Date" was selected, and the date was February 27, the date range would include Feb 1 - Feb 27. The next week, after the month boundary has passed, the date range would include Mar 1 - Mar 4. To Date respects start of week and start of quarter settings under project settings.
### Period to date

### Minute Level Granularity
This option allows you to select a date range that will update dynamically to fit the current interval - you can choose "Day", "Week", "Month", "Quarter", and "Year". When the boundary of the interval is passed, the date range will automatically update to include only the current interval. For example, if "Month" was selected on June 27, the date range would include Jun 1 - Jun 27. The next month, after June has passed, the date range would include Jul 1 - Jul 8, as shown in the image below.\
"Period to date" respects the start of the week and start of quarter settings under Project Settings.

<Frame>
![minute level granularity](/images/enable-minute-granularity.png)
![Date Picker Period To Date](/images/date_picker_period_to_date.png)
</Frame>

Enable hourly and minute-level granularity by going to the advanced submenu under "custom" date range selection. This enables you to select time ranges up to the minute. You can also use this for the "Last" time range to monitor only the past few hours or minutes. When doing time series using minute or hourly intervals, there is a lower time range limit supported.
### Previous period

#### Zoom In
Choosing this option allows you to query information tracked only in the selected period: "Day", "Week", "Month", "Quarter", and "Year".

<Frame>
![Date Picker Previous Period](/images/date_picker_previous_period.png)
</Frame>

### Minute Level Granularity

Enable hourly and minute-level granularity by clicking the "Enable Time Ranges" toggle on the bottom-left side of the date range picker. This enables you to select time ranges up to the minute. You can also use this for the "Last" time range to monitor only the past few hours or minutes.\
This setting only works for the "Fixed", "Last", and "Since" options; it's not available for "Period to date" and "Previous period".

<Frame>
<img
src="/images/date_picker_fixed_time_ranges.png"
alt="Date Picker Fixed Time Ranges"
title="Date Picker Fixed Time Ranges"
className="mx-auto"
/>
</Frame>

## Zoom In

To zoom in, click on the graph and drag to highlight a specific window of time in your report. Click **Reset zoom** to return to the previous view.

Expand Down Expand Up @@ -278,15 +333,20 @@ Comparisons are supported across all insights chart types. Depending on the exac
## Saving to a board

<Note>
Free plans allow each user to save up to 5 reports. Growth and Enterprise plan users can save an unlimited number of reports. See our [pricing page](https://mixpanel.com/pricing/) for more details.
Free plans allow each user to save up to 5 reports, while Growth and Enterprise plan users can save an unlimited number of reports. See our [pricing page](https://mixpanel.com/pricing/) for more details.
</Note>

When you are satisfied with the analysis and decide that this is something that you are likely to revisit, Mixpanel recommends that you save the report to a [board](/docs/boards). You can do this by pressing "Save" in the top right and selecting the board you would like to save to, or creating a new board.
When you are satisfied with the analysis and decide that this is something that you are likely to revisit, you save the report to a [board](/docs/boards) by pressing "Save" in the top right and selecting the board you would like to save to, or creating a new board.

All reports are saved to a board, which inherits the sharing settings and permissions applied to that board. Learn more about saving, sharing, and permission for your reports and boards [here](/docs/boards/sharing-and-permission).

<Frame>
![/Screen\_Shot\_2022-07-08\_at\_5.40.30\_PM.png](/images/Screen_Shot_2022-07-08_at_5.40.30_PM.png)
<img
src="/images/reports_save_to_board.png"
alt="Reports Save To Board"
title="Reports Save To Board"
className="mx-auto"
/>
</Frame>

## Typecasting
Expand All @@ -305,7 +365,7 @@ Insights will automatically bucket high-cardinality segments of number data type

You can either customize the ranges by clicking "[Customize Range](/docs/features/advanced#custom-buckets)".

Or alternatively, if you'd like to see the exact numeric values, you can typecast the Number property to a String to remove the range bucketing.
Alternatively, if you'd like to see the exact numeric values, you can typecast the Number property to a String to remove the range bucketing.

## View Users

Expand All @@ -318,7 +378,7 @@ View Users can help you:
- Export these users to a CSV file.

<Frame>
![/View\_Users\_Insights\_gif.gif](/images/View_Users_Insights_gif.gif)
![Reports View Users](/images/reports_view_users.gif)
</Frame>

## Segment Limits and Ordering
Expand Down Expand Up @@ -392,15 +452,19 @@ Query-time sampling allows you to query a subset of users and shorten the time i

### Enable Sampling

From the report in which you would like to use sampling, click the **lightning bolt** in the upper right corner of the query builder.
From the report in which you would like to use sampling, click the **lightning bolt** in the upper-right corner of the query builder. This will enable sampling on the report and will be indicated by the lightning bolt symbol turning blue.\
The percentage of the total that is included in the query calculations will be indicated in the banner shown above the report.

<Frame>
![/13109650264596](/images/13109650264596.png)
<img
src="/images/reports_query_time_sampling.png"
alt="Reports Query Time Sampling"
title="Reports Query Time Sampling"
className="mx-auto"
/>
</Frame>

This will enable sampling on the report and will be indicated by the lightning bolt symbol turning blue. The percentage of the total that is included in the query calculations will be indicated in the top right corner of the query builder.

To turn off sampling, click the lightning bolt symbol in the upper right corner of the query builder again. The lightning bolt symbol will turn grey to indicate that sampling is disabled.
To turn off sampling, simply click the lightning bolt toggle again.

### Query Time Sampling Calculation and Presentation

Expand Down
Loading