diff --git a/docs/reports.mdx b/docs/reports.mdx
index 8312cead..eeaa546f 100644
--- a/docs/reports.mdx
+++ b/docs/reports.mdx
@@ -132,36 +132,44 @@ 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.
- 
+ 
### 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.
- 
+
## 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.
- 
+ 
-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. |
@@ -169,54 +177,101 @@ For these date ranges, the output shows results from the last complete 30 days,
| 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.
- 
+
-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.
- 
+
-### 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.
+
+
+
+
+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.
- 
+ 
### Since
“Since” allows you to select a specific date to query for all data since that start date.
-### To Date
+
+
+
-"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.
- 
+ 
-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".
+
+
+ 
+
+
+### 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".
+
+
+
+
+
+## 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.
@@ -278,15 +333,20 @@ Comparisons are supported across all insights chart types. Depending on the exac
## Saving to a board
- 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.
-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).
- 
+
## Typecasting
@@ -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
@@ -318,7 +378,7 @@ View Users can help you:
- Export these users to a CSV file.
- 
+ 
## Segment Limits and Ordering
@@ -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.
- 
+
-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
diff --git a/docs/reports/apps/impact.mdx b/docs/reports/apps/impact.mdx
index 78a8a150..8c611c02 100644
--- a/docs/reports/apps/impact.mdx
+++ b/docs/reports/apps/impact.mdx
@@ -1,21 +1,26 @@
---
-sidebarTitle: "Impact"
title: "Impact: Measure the effect of a launch on your KPIs"
+sidebarTitle: "Impact"
---
- Users on an Growth or Enterprise plan can access the Impact report. See our [pricing page](https://mixpanel.com/pricing/) for more details.
+ Users on a Growth or Enterprise plan can access the Impact report. See our [pricing page](https://mixpanel.com/pricing/) for more details.
-
## Overview
-Mixpanel’s Impact report measures the effects of product or marketing launches on your key metrics. Impact calculates the user adoption of the launch, the impact of the launch on an important event, and the differences between users that adopt the launch and those that do not.
+Mixpanel’s Impact report measures the effects of product or marketing launches on your key metrics. Impact calculates the user adoption of the launch, the impact of the launch on an important event, and the differences between users who adopt the launch and those who do not.
-To access **Impact**, go to the Applications section in the top right of the top navigation, then select **Impact**.
+To access **Impact**, go to the Applications section on the bottom left-side of the screen, and then select **Impact**.
-
+
## Use Cases
@@ -23,32 +28,26 @@ To access **Impact**, go to the Applications section in the top right of the t
Here are some of the sample questions you can answer in Impact:
- How is the adoption of my feature changing over time?
-- Did my feature launch have an effect on the rate of another key value moment?
+- Did my feature launch affect the rate of another key value moment?
## Quick Start
-
-
+
+
### Step 1: Select a launch event
To build an Impact query, first select a launch event. This is the event that you are measuring as the cause of change.
-
+ 
-Select the start date of this launch event. Add any additional filters to narrow the launch event parameters by clicking the **... dropdown** and selecting the **Add filter**.
+Select the start date of this launch event. Add any additional filters to narrow the launch event parameters by clicking the "**..." button** and then "Filter".
-
+ 
### Step 2: Select metric events
@@ -56,57 +55,62 @@ Select the start date of this launch event. Add any additional filters to narrow
Select a metric event by clicking the **Add** button under **IMPACTED EVENTS**. You are measuring the impact of the launch event on this metric event. Add additional filters to narrow the impacted event parameters.
-
+ 
### Step 3: Add breakdown (optional)
-Breakdown impacted events further by clicking the **… icon**, selecting **Add Aggregation**, then selecting an event property, such as “Amount”. This will add up the value of this property for all of the times this event happened in this time range. All aggregate properties are typecast to numeric properties in order to calculate the sum of that property. For example, aggregate the property “Amount” under the event “Process Payment” to analyze revenue.
+Breakdown impacted events further by clicking the "**…" icon**, selecting **Add Aggregation**, and then selecting an event property, such as “Amount”. This will add up the value of this property for all of the times this event happened in this time range. All aggregate properties are typecast to numeric properties to calculate the sum of that property. For example, aggregate the property “Amount” under the event “Process Payment” to analyze revenue.
-
+ 
### Step 4: Select user group
-Under **USER DEFINITION** select whether you would like to count users who did **only the impacted event** or **any event**.
+Under **USER DEFINITION,** select whether you would like to count users who did **only the impacted event** or **any event**.
-
+ 
### Step 5: Select time range
-Select the time range. The time range is a fixed period of time that determines the adopters and non-adopters of the launch event. The default is "15 days before and after", meaning that the 15 days preceding the fixed launch event date and the 15 days following the launch event will be included in the results. This will allow you to see the difference in the metric event before and after the launch event.
+The time range is a fixed period of time that determines the adopters and non-adopters of the launch event. The default is "15 days before and after", meaning that the 15 days preceding the fixed launch event date and the 15 days following the launch event will be included in the results. This will allow you to see the difference in the metric event before and after the launch event.
The chart will not necessarily change if you change the time range.
-
+
-
## Reference
### Adoption
-Adopters are users that have done the launch event. Non-adopters are users that have not done the launch event. Both adopters and non-adopters must perform the metric event to be included in the report.
+Adopters are users who have triggered the launch event. Non-adopters are users who haven't triggered the launch event. Both adopters and non-adopters must perform the metric event to be included in the report.
-The Adoption Rate is the number of users that perform the launch event divided by the total user count:
+The Adoption Rate is the number of users who perform the launch event divided by the total user count:
$\%\,adoption = average\left( (adopters) \over (adopters + non\,adopters) \right)$
### Impact Chart
-The Impact Chart shows how the rate of metric event occurrence changes over time. The y-axis of the chart is the average number of the metric event count and the x-axis is time spanning 30 days.
+The Impact Chart shows how the rate of metric event occurrence changes over time. The y-axis of the chart is the average number of the metric event's count, and the x-axis is time spanning 30 days.
-Unlike other Mixpanel charts, the Impact Chart displays time in relative time, not calendar time. The chart centers around the first day that the launch event is available, or “day zero”. The chart displays the 15 days before and after day zero.
+Unlike other Mixpanel charts, the Impact Chart displays time in relative time, not calendar time. The chart centers around the first day that the launch event is available, or “day zero”. The chart displays the 15 days before and after day zero.
-
+ 
-Every user in the report can have a different day zero. For users in the adopter group, day zero is the first day that they perform the launch event. For users in the non-adopter group, day zero is the day the first adopter performed the launch event (which is most likely the launch day of the feature).
+Every user in the report can have a different day zero. For users in the adopter group, day zero is the first day that they perform the launch event. For users in the non-adopter group, day zero is the day the first adopter performed the launch event (which is most likely the launch day of the feature).
Each data point on the chart is calculated as follows:
@@ -114,31 +118,31 @@ $metric\,event\,rate = { (metric\,event\,count) \over (total\,user\,count)}$
Each point on the line is the average number of times users in the group did the metric event on that relative day.
-For example, if 10 adopters did the launch event for the first time five days ago, and they then did the metric event a total of 30 times today. The +5 days point on the adopter line would read 3. The math would be as follows:
+For example, if 10 adopters did the launch event for the first time five days ago, and they then did the metric event a total of 30 times today. The \+5 days point on the adopter line would read 3. The math would be as follows:
-- 30 = The number of metric events performed by the adopters on day 5
-- 10 = The number of users who did the launch event 5 days before the first day
-- 3 = 30/10
+- 30 = The number of metric events performed by the adopters on day 5.
+- 10 = The number of users who did the launch event 5 days before the first day.
+- 3 = 30/10.
You can see how frequently users in each group perform the metric event, both before and after the launch.
The chart also contains average lines for non-adopters and adopters both before and after day zero (or launch), and the unobserved counterfactual of the adopters (UCA), formerly called projected adopters, average after day zero.
-
+ 
### Impact Table
-The Impact Table summarizes the results of the Impact chart. It displays the average rate at which users in the adopter and non-adopter groups performed the metric event over the course of the 15 days before and after launch.
+The Impact Table summarizes the results of the Impact chart. It displays the average rate at which users in the adopter and non-adopter groups performed the metric event over the course of the 15 days before and after launch.
The table is broken down into three sections: “Pre-Launch”, “Post-Launch”, and “Impact”.
-
+ 
-The Impact Table compares users that performed the launch event and those that did not. For both groups of users, Mixpanel calculates the average number of times per day that users performed the metric event before the launch, after the launch, and the difference between the two (the delta).
+The Impact Table compares users who performed the launch event and those who did not. For both groups of users, Mixpanel calculates the average number of times per day that users performed the metric event before the launch, after the launch, and the difference between the two (the delta).
The average number of times that users performed the metric event before the launch is calculated by:
@@ -150,7 +154,7 @@ A relative delta is also present in each section of the table.
### Pre-Launch
-The Pre-Launch section contains columns for adopters, non-adopters, and the relative delta between them. Adopters are users that perform the launch event after launch, and non-adopters are users that do not perform the launch event after the selected launch date.
+The Pre-Launch section contains columns for adopters, non-adopters, and the relative delta between them. Adopters are users who perform the launch event after launch, and non-adopters are users who do not perform the launch event after the selected launch date.
The relative delta is calculated using the equation:
@@ -158,7 +162,7 @@ $relative\,delta= { (adopter\,average - non\,adopter\,average) \over (non\,adopt
### Post-Launch
-The Post-Launch section contains columns for actual adopters, non-adopters, unobserved counterfactual of adopters, and the relative delta between them. Adopters are users that perform the launch event, and non-adopters are users that do not perform the launch event after the selected launch date.
+The Post-Launch section contains columns for actual adopters, non-adopters, unobserved counterfactuals of adopters, and the relative delta between them. Adopters are users who perform the launch event, and non-adopters are users who do not perform the launch event after the selected launch date.
The UCA value is the projected behavior of adopters if the launch event never happened. This calculation controls for any difference between the adopters and non-adopters that is not a result of the launch event. This value is calculated by the following, where NA is non-adopters, pre is pre-launch, and post is post-launch:
@@ -174,33 +178,33 @@ The Impact section of the table contains the final calculations that indicate if
The delta is the difference between the UCA and adopters in the post-launch period. The relative delta divides that value by the UCA.
-Confidence indicates the statistical significance of report calculations. [See below for details on the calculation of confidence](/docs/reports/apps/impact#confidence-calculation).
+Confidence indicates the statistical significance of the report calculations. [See below for details on the calculation of confidence](/docs/reports/apps/impact#confidence-calculation).
### Interpret the Results
-In general, when the overall delta is positive, and the confidence score is 95% or more, it indicates a successful launch. The most successful launches will see the rate at which adopters perform the metric event increase post-launch, while the same rate for the non-adopters remains relatively constant.
+In general, when the overall delta is positive and the confidence score is 95% or more, it indicates a successful launch. The most successful launches will see the rate at which adopters perform the metric event increase post-launch, while the same rate for the non-adopters remains relatively constant.
-In the Impact Chart, look at the average gap in usage between the adopters and non-adopters. Typically, it is preferable for the increase in the gap to be mostly driven by an increase in the rate at which adopters perform the metric event, rather than a decrease in the rate at which non-adopters perform it.
+In the Impact Chart, look at the average gap in usage between the adopters and non-adopters. Typically, it is preferable for the increase in the gap to be mostly driven by an increase in the rate at which adopters perform the metric event, rather than a decrease in the rate at which non-adopters perform it.
### Confidence Calculation
-Impact includes confidence to indicate the statistical significance of report calculations. Interpret the confidence as the probability that the final delta is primarily caused by the launch event, as opposed to existing by chance.
+Impact includes confidence to indicate the statistical significance of the report calculations. Interpret the confidence as the probability that the final delta is primarily caused by the launch event, as opposed to existing by chance.
The confidence is calculated as a confidence interval using a cumulative distribution function while assuming a normal distribution.
-The confidence variables are as follow:
+The confidence variables are as follows:
- **X** = The number of events per day performed by adopters in the pre-launch period.
- **Y** = The number of events per day performed by adopters in the post-launch period.
- **A** = The number of events per day performed by non-adopters in their pre-launch period.
- **B** = The number of events per day performed by non-adopters in their post-launch period.
-- **Y - X** = The difference in number of events per day performed by adopters between post-launch and pre-launch periods.
-- **B - A** = The difference in number of events per day performed by non-adopters between the post-launch and pre-launch periods.
+- **Y - X** = The difference in the number of events per day performed by adopters between post-launch and pre-launch periods.
+- **B - A** = The difference in the number of events per day performed by non-adopters between the post-launch and pre-launch periods.
- The mean of **Y - X** over time is denoted by:
$\mu_{Y-X}$
-- The mean of of **B - A** over time is denoted by:
+- The mean of B-**A** over time is denoted by:
$\mu_{B-A}$
@@ -212,7 +216,7 @@ $\sigma_{Y-X}$
$\sigma_{B-A}$
-With the variables assigned, the calculations for confidence are as follow:
+With the variables assigned, the calculations for confidence are as follows:
$\mu_{final} = \mu_{Y-X} - \mu_{B-A}$
@@ -226,7 +230,7 @@ $confidence = 1 - p_{value}$
### Causal Impact
-Causal impact uses propensity score methods (a class of causal inference techniques) to refine Impact report results by controlling for self-selection bias. Self-selection bias refers to the tendency of active users to be likely to use your new feature and to perform the impacted metrics, independent of the launch.
+Causal impact uses propensity score methods (a class of causal inference techniques) to refine Impact report results by controlling for self-selection bias. Self-selection bias refers to the tendency of active users to be likely to use your new feature and to perform the impacted metrics, independent of the launch.
Propensity score methods control for self-selection bias by simulating what would occur in a hypothetical, randomized A/B test.
@@ -237,7 +241,7 @@ To learn more about Causal Impact in detail, read this [Mixpanel Whitepaper](ht
Click **View Causal Impact** to use the propensity matching model.
-
+ 
Please note that Causal Impact can take up to a few minutes to calculate results. Causal Impact requires at least 200 total samples and a minimum of 10 features. Each stratum must contain at least 3 treated (adopter) and 3 control (non-adopter) units.
@@ -246,13 +250,13 @@ Please note that Causal Impact can take up to a few minutes to calculate results
Propensity score stratification addresses self-selection bias by comparing adopters and non-adopters who are equally as likely to perform the launch event.
-Users are broken into 10 subclasses after the propensity matching model runs. The 10 subclasses are deciles based on the logit of the estimated propensity score, and weights across subclasses are based on subclass size. Each subclass contains adopters and non-adopters that have a similar likelihood of performing the launch event. Mixpanel determines the rate at which the adopters and non-adopters performed the impacted metric, and calculates the difference for each subgroup.
+Users are broken into 10 subclasses after the propensity matching model runs. The 10 subclasses are deciles based on the logit of the estimated propensity score, and weights across subclasses are based on subclass size. Each subclass contains adopters and non-adopters that have a similar likelihood of performing the launch event. Mixpanel determines the rate at which the adopters and non-adopters performed the impacted metric and calculates the difference for each subgroup.
-Lastly, we average those values across all 10 subclasses to produce the Average Treatment Effect, or ATE. The ATE indicates, on average across all users, how many more or less times per day the newly launched feature led to users to performing the impacted metric.
+Lastly, we average those values across all 10 subclasses to produce the Average Treatment Effect, or ATE. The ATE indicates, on average across all users, how many more or fewer times per day the newly launched feature led users to perform the impacted metric.
### Causal Impact Chart
-The Causal Impact chart plots the ATE on each Impacted Metric. The dark line shows the ATE, and the surrounding box shows the 95% confidence interval bounds of the ATE.
+The Causal Impact chart plots the ATE on each Impacted Metric. The dark line shows the ATE, and the surrounding box shows the 95% confidence interval bounds of the ATE.
When the confidence interval does not include 0, it indicates that the positive or negative effect of the launch event is statistically significant.
@@ -262,10 +266,10 @@ The Causal Impact Table provides additional detail on the treatment effects on t
For each impacted metric, the table displays the ATE, the ATT (the average treatment effect on the treated), the 95% confidence interval (CI) bounds for those, and the number of adopters and non-adopters in the calculation.
-Click the caret to expand the impacted metric row into the 10 subclasses considered. For each subclass, Mixpanel displays the number of matched adopters in the subclass, number of matched non-adopters in the subclass, and the [rates at which each performed the impacted metric](/docs/reports/apps/impact). The Delta column shows the difference between those rates.
+Click the caret to expand the impacted metric row into the 10 subclasses considered. For each subclass, Mixpanel displays the number of matched adopters in the subclass, the number of matched non-adopters in the subclass, and the [rates at which each performed the impacted metric](/docs/reports/apps/impact). The Delta column shows the difference between those rates.
-Note that these values can differ from those reported in the Adoption and Impact Trends charts because Causal Impact only considers users that can be found to have similar propensity to perform the launch event to other users.
+Note that these values can differ from those reported in the Adoption and Impact Trends charts because Causal Impact only considers users who can be found to have a similar propensity to perform the launch event to other users.
### Interpret the Causal Impact Results
-Mixpanel's causal model is confident your new feature successfully changed the rate at which users perform the impacted metric if the ATE on any impacted metric is positive and the 95% confidence interval does not contain zero. This holds true as long as there are no confounding factors outside of your event data.
+Mixpanel's causal model is confident that your new feature successfully changed the rate at which users perform the impacted metric if the ATE on any impacted metric is positive and the 95% confidence interval does not contain zero. This holds as long as there are no confounding factors outside of your event data.
\ No newline at end of file
diff --git a/docs/reports/apps/jql.mdx b/docs/reports/apps/jql.mdx
index 32ffbda6..0983a895 100644
--- a/docs/reports/apps/jql.mdx
+++ b/docs/reports/apps/jql.mdx
@@ -1292,4 +1292,4 @@ function main() {
mixpanel.numeric_bucket('time', mixpanel.daily_time_buckets)],
mixpanel.reducer.count());
}
-```
+```
\ No newline at end of file
diff --git a/docs/reports/apps/signal.mdx b/docs/reports/apps/signal.mdx
index 2734f15f..6312081c 100644
--- a/docs/reports/apps/signal.mdx
+++ b/docs/reports/apps/signal.mdx
@@ -1,80 +1,72 @@
---
-sidebarTitle: "Signal"
title: "Signal: Quantify correlation between two events"
+sidebarTitle: "Signal"
---
- Users on an Enterprise plan can access the Signal report. See our [pricing page](https://mixpanel.com/pricing/) for more details.
+ Users on an Enterprise plan can access the Signal report. See our [pricing page](https://mixpanel.com/pricing/) for more details.
## Overview
-Signal measures the association between a correlation event and a goal event and quantifies the correlation between the two. This facilitates a deeper understanding of the behaviors that drive customer conversions, and can help guide product decisions.
+Signal measures the association between a correlation event and a goal event and quantifies the correlation between the two. This facilitates a deeper understanding of the behaviors that drive customer conversions and can help guide product decisions.
## Use Cases
-Using an a music sharing application as an example can highlight the value of quantifying correlations between events.
-
-The music sharing app may want to understand the correlation between top events and users who purchase a song on the app. It is important to understand what the optimal actions that users take before purchasing a song are.
+Using a social media app as an example can highlight the value of quantifying correlations between events.
-Building this query in Signal would involve selecting the target users, and how the "Song Purchased" goal event is correlated with the top events.
+The customer may want to understand the correlation between top events and users who like a video on the app. Building this query in Signal would involve selecting the target users and how the "like video" goal event is correlated with the top events.
-
+ 
-Values are returned after running the correlation. “Song Played” could have a strong positive correlation with purchasing a song. Most of the users who played a song later purchased a song.
+Values are returned after running the correlation. “channel subscribe” could have a strong positive correlation with liking a video; most of the users who subscribed to a channel liked a video.
-
+ 
-This information can be used in future product decisions. By knowing that those who play songs are more likely to purchase songs, it is possible to build tools to encourage song plays. This could lead to a dramatic increase in the amount of users purchasing songs.
+This information can be used in future product decisions. By knowing that those who subscribed to a channel are more likely to like a video, it is possible to build tools to encourage video liking and, in the end, lead to a dramatic increase in the number of users interacting with creators.
## Quick Start
-
-
+
+
+
+By default, Mixpanel will build a query to show how your top 50 events correlate with 2nd week retention in the last quarter for all users. This translates to, “How do the top events correlate with two-week retention in the last quarter for all users?"
-By default, Mixpanel will build a query to show how your top 50 events correlate with 2nd week retention in the last quarter for all users. This translates to, “How do the top events correlate with two week retention in the last quarter for all users?"
+To access **Signal**, go to the Applications section on the bottom left-side of the screen, and then select **Signal**.
-
+ 
-To build a new query with Signal, enter the Signal report in the desired Mixpanel project.
-
-Signal queries require a minimum of 60 days worth of data. Queries with any less data history will return a calculation error.Signal currently supports filtering only by event properties. Custom events with profile property filters will now be shown in the event dropdown.
+Signal queries require a minimum of 60 days' worth of data. Queries with less data history than that will return a calculation error. Signal currently supports filtering only by event properties. Custom events with profile property filters will now be shown in the event dropdown.
-1. Determine and specify the target users. “All users” is the default.
+1. Determine and specify the target users. “All Users” is the default.
-
+ 
-2. Select any event performed by the target user by clicking the **+** sign.
+2. Select any event performed by the target user by clicking the **\+** sign.
-
+ 
-3. Further filter by property by clicking **+ Filter** and selecting any properties as well as the frequency of occurrence.
+3. Further filter by property by clicking "**\+ Filter**" and selecting any properties, as well as the frequency of occurrence.
-
+ 
4. Determine and select the Goal Event and its properties. The goal event can be a specific event with a frequency (users did Goal Event at least x number of times) or one of the default Signal retention events calculated by Mixpanel.
-
+ 
The default retention events available in Signal include:
@@ -84,25 +76,25 @@ The default retention events available in Signal include:
- 4th week retention: Users doing a specific action or set of actions in your project and then returning to do anything within four weeks.
- 2nd month retention: Users doing a specific action or set of actions in your project and then returning to do anything within two months.
-5. Determine and select the Correlation Event and its properties. It is possible to add up to ten different correlation events by clicking the **+** button at the bottom of the query builder.
+5. Determine and select the Correlation Event and its properties. It is possible to add up to ten different correlation events by clicking the "**\+**" button at the bottom of the query builder.
-- The correlation event can be [broken down by property](/docs/reports#breakdowns). To do this, select **+ Breakdown** and select the property to break the data down by.
-- The correlation event can be [filtered by property](/docs/reports#event-inline-filters). To do this, select **+ Filter** and select the property and property value you want to filter by.
+- The correlation event can be [broken down by property](/docs/reports#breakdowns). To do this, select "**\+ Breakdown**" and select the property to break the data down by.
+- The correlation event can be [filtered by property](/docs/reports#event-inline-filters). To do this, select "**\+ Filter**" and select the property and property value you want to filter by.
-
+ 
6. Select the time frame for the query and the users who are to be evaluated. It’s important to select a long enough time frame that allows users to complete both the correlation event(s) and the goal event.
-
+ 
7. Click **Correlate**.
-
+ 
## Interpreting Results
@@ -112,16 +104,16 @@ The default retention events available in Signal include:
Each correlation will be represented by one card in the summary view results. The list-view will display the optimal action, correlation with the goal event, and key findings about the event. Results can be sorted by correlation strength or by Mixpanel opportunity score.
-
+ 
### Scores
-By default, the results will be sorted by Opportunity. “Opportunity” is Mixpanel’s proprietary calculation of how important a given correlation might be. The correlation strength is calculated using the phi coefficient. [Reference here](/docs/reports/apps/signal#correlation) for more detail on how Opportunity and correlation strength is calculated.
+By default, the results will be sorted by Opportunity. “Opportunity” is Mixpanel’s proprietary calculation of how important a given correlation might be. The correlation strength is calculated using the phi coefficient. [See here](/docs/reports/apps/signal#correlation) for more details on how Opportunity and correlation strength are calculated.
### Key Findings
-The key findings presented are rarity analysis results and conversion measurements. Rarity defines how common or uncommon it is for users to complete an individual event. The conversion measurements qualifies how likely a given conversion is to be helpful.
+The key findings presented are rarity analysis results and conversion measurements. Rarity defines how common or uncommon it is for users to complete an individual event. The conversion measurements qualify how likely a given conversion is to be helpful.
**Rarity Analysis** can be broken down into:
@@ -143,26 +135,26 @@ The key findings presented are rarity analysis results and conversion measuremen
To access the detailed view, click on a card in the summary view.
-
+ 
The detailed view provides the correlation calculations for each event evaluated. This view uses a heat map to show the strength of the correlation with the goal event.
-The x-axis represents the velocity, or the number of days it took users to complete the event (up to 15 days) and the y-axis shows the frequency of the event, or the number of times the event was done, up to ten times.
+The x-axis represents the velocity, or the number of days it took users to complete the event (up to 15 days), and the y-axis shows the frequency of the event, or the number of times the event was done, up to ten times.
-
+ 
### Optimal Action
The optimal action will be highlighted in green on the heat map.
-The optimal action tells you how many times and in how many days your customers should do the event in order to achieve your optimal correlation. Frequency labels are listed below the action and provide precise information, based on the correlation, about when your users should complete the event. For example, if you are a music streaming app and wanted to see how a “Play Song” event correlates with two week retention, you might see something like, “Play song once within ten days” as an optimal action.
+The optimal action tells you how many times and in how many days your customers should trigger the event in order to achieve your optimal correlation. Frequency labels are listed below the action and provide precise information, based on the correlation, about when your users should complete the event. For example, if you have a music streaming app and want to see how a “Play Song” event correlates with two-week retention, you might see something like “Play song once within ten days” as an optimal action.
### Supporting Statistics
-For each combination Mixpanel will provide supporting statistics for further analysis:
+For each combination, Mixpanel will provide supporting statistics for further analysis:
- **Precision**: Percent of users who convert to your goal among those who did this event at least x times within y days.
- **False omission rate**: Percent of users who convert to your goal among those who did this event fewer than x times within y days.
@@ -171,25 +163,25 @@ For each combination Mixpanel will provide supporting statistics for further ana
- **Correlation**: Association between performing this event at least x times in y days and converting to your goal.
-
+ 
-To see the calculations of the optimal correlation data, hover of the ƒx in the upper right-hand corner of the chart at the bottom of the heat map.
+To see the calculations of the optimal correlation data, hover over the ƒx in the upper right-hand corner of the chart at the bottom of the heat map.
-
+ 
### Key Findings
-Signal also presents two key findings, rarity analysis results and conversion measurements. Rarity defines how common or uncommon it is for users to complete an individual event. The conversion measurements qualifies how likely a given conversion is to be helpful. For example, if all users are converting because the application forces this by design, then the conversion measurement will flag this as "unlikely to be useful".
+Signal also presents two key findings, rarity analysis results and conversion measurements. Rarity defines how common or uncommon it is for users to complete an individual event. The conversion measurements qualify how likely a given conversion is to be helpful. For example, if all users are converting because the application forces this by design, then the conversion measurement will flag this as "unlikely to be useful".
### CSV Download
-To download the results to a CSV, click the **Download CSV** icon in the upper right hand corner of the Summary Results view or the Detailed Results view after you have run your correlation.
+To download the results to a CSV, click the **Download CSV** icon in the upper right-hand corner of the Summary Results view or the Detailed Results view after you have run your correlation.
-
+ 
## Reference
@@ -208,29 +200,29 @@ All users will look at all users in your Mixpanel project who have completed the
- **True negative:** Number of negative correlations that are correctly identified.
- **False positive:** Number of positive correlations that are incorrectly identified.
- **False negative:** Number of negative correlations that are incorrectly identified.
-- **Correlation:** The association between your event to your goal event.
+- **Correlation:** The association between your event and your goal event.
- **Precision:** Percent of users who convert to your goal among those who did this event at least x times within y days
- **Fall-out:** Percent of unconverted users who did this event at least x times within y days.
- **Recall:** Percent of converted users who did this event at least x times within y days.
- **False Omission Rate:** Percent of users who convert to your goal among those who did this event fewer than x times within y days.
-- **Phi max:** Single number between -1 and 1 that indicates how closely an event moves with your goal event. 1 means that 100% of all users that did your goal event also did the event you are evaluating. -1 means the opposite: 0% of users that did you goal event also did the event you are evaluating.
+- **Phi max:** A single number between -1 and 1 that indicates how closely an event moves toward your goal event, where 1 means that 100% of all users who did your goal event also did the event you are evaluating, and -1 means the opposite - 0% of users who did your goal event also did the event you are evaluating.
- **Mixpanel Opportunity Score:** Mixpanel’s proprietary calculation of how important a given correlation might be.
### Calculations
-Signal calculates correlation using a well-known statistical algorithm called the phi coefficient. In addition to correlation, Mixpanel calculates what is called an opportunity score, and also presents a list of key findings.
+Signal calculates correlation using a well-known statistical algorithm called the phi coefficient. In addition to correlation, Mixpanel calculates what is called an opportunity score and also presents a list of key findings.
#### Correlation
-The phi coefficient is a single number between -1 and 1 and it indicates how closely an event moves with your goal event. 1 means that 100% of all users that did the goal event also did the correlation event. -1 means that 0% of users that did the goal event also did the correlation event.
+The phi coefficient is a single number between -1 and 1, and it indicates how closely an event moves with your goal event. 1 means that 100% of all users who did the goal event also did the correlation event. -1 means that 0% of users who did the goal event also did the correlation event.
#### Opportunity Score
“Opportunity” is Mixpanel’s proprietary calculation of how important a given correlation might be. Opportunity helps pare down results by eliminating false positives and highlighting weak correlations that may be actionable. Based on this assessment, which determines how much an event impacts conversion on your goal, Mixpanel will tell you if there is an opening to make a change in your product or not.
-Once we have the correlation, the results on the summary page will display the optimal action, correlation with the goal event, and our key findings about that optimal action.
+Once we correlate, the results on the summary page will display the optimal action, correlation with the goal event, and our key findings about that optimal action.
-The optimal action tells you how many times and in how many days your customers should do the event in order to achieve your optimal correlation. Frequency labels are listed below the action and provide precise information, based on the correlation, about when your users should complete the event. For example, if you are a music streaming app and wanted to see how a “Play Song” event correlates with two week retention, you might see something like, “Play song once within ten days” as an optimal action.
+The optimal action tells you how many times and in how many days your customers should trigger the event in order to achieve your optimal correlation. Frequency labels are listed below the action and provide precise information, based on the correlation, about when your users should complete the event. For example, if you have a music streaming app and want to see how a “Play Song” event correlates with two-week retention, you might see something like “Play song once within ten days” as an optimal action.
**Frequency Labels** -- \*these will be supplemented with temporal labels, i.e. At least 4 times in 10 days.\*
@@ -244,7 +236,7 @@ The optimal action tells you how many times and in how many days your customers
The correlation with the goal event presents to you the optimal correlation for the event and tells you whether this indicates a strong or weak association with your goal. We calculate the association using a well-known statistical measure called the phi coefficient. The phi coefficient is a single number between -1 and 1 that indicates how closely an event moves with your goal event.
-Finally, we will display the key findings. The key findings contain the rarity analyses and the impact to conversion. The rarity analyses define how common or uncommon is it for users in your user group to complete your event and the impact to conversion explains how the event impacts conversion to your Goal event (i.e. retention). These help you interpret the correlations. A certain event may have strong correlation to a goal event but may not have been completed by many users in your group and thus is unlikely to be useful. Below we have listed the different messages you can see as a part of the rarity analysis and the impact to conversion.
+Finally, we will display the key findings. The key findings contain the rarity analyses and the impact on conversion. The rarity analyses define how common or uncommon it is for users in your user group to complete your event, and the impact to conversion explains how the event impacts conversion to your Goal event (i.e., retention). These help you interpret the correlations. A certain event may have a strong correlation to a goal event, but may not have been completed by many users in your group, and thus is unlikely to be useful. Below, we have listed the different messages you can see as a part of the rarity analysis and the impact on conversion.
**Rarity Analyses**
@@ -268,6 +260,6 @@ Associated almost perfectly with not converting. Something might be off here.
- Example: Users who trigger an “uninstall” event are not going to complete your Goal event.
-Associated almost perfectly with . Too good to be true?
+Associated almost perfectly with converting. Too good to be true?
-- Example: Users who trigger a purchase event will always trigger an add to cart event. Add to cart and purchase will always have high correlation.
+- Example: Users who trigger a Purchase event will always trigger an Add To Cart event. Add To Cart and Purchase will always have a high correlation.
\ No newline at end of file
diff --git a/docs/reports/flows.mdx b/docs/reports/flows.mdx
index efd480af..bf4804ed 100644
--- a/docs/reports/flows.mdx
+++ b/docs/reports/flows.mdx
@@ -9,7 +9,7 @@ sidebarTitle: "Flows"

-Flows identifies the most frequent paths taken by users to or from any event. Use Flows to understand how your users sequentially perform events in your product and analyze drop-offs or unsuccessful behavior.
+A Flows report identifies the most frequent paths taken by users to or from any event. Use Flows to understand how your users sequentially perform events in your product and analyze drop-offs or unsuccessful behavior.
Flows can be accessed from the left-side navigation by clicking the '\+ Create New' button.
@@ -32,7 +32,7 @@ Here are some of the sample questions you can answer in Flows:
-Building a Flows report follows the same high level steps as building any other report. You can read about report building basics [here](/docs/reports).
+Building a Flows report follows the same high-level steps as building any other report. You can read about report-building basics [here](/docs/reports).
Building a report in Flows takes just a few clicks, and results arrive in seconds. Let's build a simple report together. Using a B2B messaging example, imagine you wanted to answer the following question:
@@ -40,7 +40,7 @@ Building a report in Flows takes just a few clicks, and results arrive in second
### Step 1: Choose Events
-Events are the basic building block of a Flow. In this case, since we want to know how users navigated from the landing page, to signing up, we would add two events, "Landing Page" and "Sign Up" within the "Steps" section.
+Events are the basic building block of a Flow. In this case, since we want to know how users navigated from the landing page to signing up, we would add two events, "Landing Page" and "Sign Up", within the "Steps" section.
### Step 2: Choose Steps Before/After Events
@@ -60,7 +60,7 @@ Filters exclude unwanted data. In this case, we only care about events performed
### Step 4: Expand The Events
-Transforms a high-level view of certain flow step into a more granular, segmented analysis at any given point However, e.g. if we wanted to see how the flow varies by city for a "Check Out" event, we could expand the "Check Out" event by "City", which can either be an event property or user profile property.
+Transforms a high-level view of a certain flow step into a more granular, segmented analysis at any given point. However, if we wanted to see how the flow varies by city for a "Check Out" event, we could expand the "Check Out" event by "City", which can either be an event property or a user profile property.
### Step 5: Choose Breakdowns
@@ -68,9 +68,9 @@ The "Breakdown" feature in Mixpanel's Flows report helps you understand how the
### Step 6: Analyze Results
-Flows features two visualizations to help you view the results of your query in the clearest chart type. By default, Flows displays the User Flows chart, which uses a Sankey diagram to visually display multiple paths on the same chart. This visualization excels when trying to identify different variants of a similar path, or following one particular trail.
+Flows features two visualizations to help you view the results of your query in the clearest chart type. By default, Flows displays the User Flows chart, which uses a Sankey diagram to visually display multiple paths on the same chart. This visualization excels when trying to identify different variants of a similar path or following one particular trail.
-User Flows displays a Sankey diagram where the height of the bar is proportional to the number of users who perform that specific event, and the height of the lines that connect bars are proportional to the number of users who perform the the two events in sequence.
+User Flows displays a Sankey diagram where the height of the bar is proportional to the number of users who perform that specific event, and the height of the lines that connect bars is proportional to the number of users who perform the two events in sequence.

@@ -94,9 +94,9 @@ Select any blue node representing an event on the Sankey chart to highlight the
### Viewing More Steps
-By default, flows shows you the first 3 events performed by users after the selected event. If you wish to see what users did further along in the path, you can adjust the number of steps directly in the Sankey visualization as shown below.
+By default, Flows shows you the first 3 events performed by users after the selected event. If you wish to see what users did further along in the path, you can adjust the number of steps directly in the Sankey visualization, as shown below.
-Use the "\+" on the right of the visualization to add steps after your selected events of interest to see what paths your users took following these key events.
+Use the "\+" icon on the right of the visualization to add steps after your selected events of interest to see what paths your users took following these key events.

@@ -124,15 +124,15 @@ You can add multiple steps in the query builder.
This allows you to examine flows between targeted events. The "\+" on the left of the breakpoint line (marked with ≈) will show you the events that happened directly after the first anchored event.
-In the following example, Flows is showing the event that happened right after App Open before the made a Purchase.
+In the following example, Flows is showing the event that happened right after 'App Open' before 'In-App Purchase'.

-Use the "\+" on the right of the breakpoint line (marked with ≈) will show you the events that happened right before the later anchored event.
+Use the "\+" on the right of the breakpoint line (marked with ≈) to show you the events that happened right before the later anchored event.
-For example, below Flows is showing the event that happened directly before a Purchase, but only after the user did App Open.
+As an example, below we see the event that happened directly before 'In-App Purchase', but only after the user did 'App Open'.

@@ -140,7 +140,7 @@ For example, below Flows is showing the event that happened directly before a Pu
### Viewing More Event Flows
-By default, flows only shows you the top 3 events performed by users ordered by the number of users who performed them. Less common events performed by fewer users are combined into an "Other events" section. ([Click here](/docs/reports/flows). To view more events, simply right click the other events node and `Add a row of events`.
+By default, Flows only show you the top 3 events performed by users, ordered by the number of users who performed them. Less common events performed by fewer users are combined into an "Other events" section. To view more events, simply right-click the 'Other events' node and `Add a row of events`.

@@ -156,17 +156,17 @@ To expand a large number of steps at the same time, you can select the number of
#### Selected Events
-These are significant moments in a users lifecycle around which you would like to explore user behavior (for example, you may wish to view what users do after a Sign Up event). Selected events are picked in the query builder and are annotated with an alphabetical label (A, B, C) that is shown in the query builder and the sankey diagram.
+These are significant moments in a user's lifecycle around which you would like to explore user behavior (for example, you may wish to view what users do after a Sign Up event). Selected events are picked in the query builder and are annotated with an alphabetical label (A, B, C) that is shown in the query builder and the sankey diagram.

-In the above example, we picked two anchor events "Exit Tutorial" and "Experiment Started", and are viewing the events that were performed by users between them.
+In the above example, we picked two anchor events, "Exit Tutorial" and "Experiment Started", and are viewing the events that were performed by users between them.
#### Intermediate Events
-Once an event is selected, Mixpanel calculates the most common events performed by users immediately before or after the selected events. These intermediate events can match either regularly tracked events OR the most used custom events in your project. The icon will let you know at a glance the type of event being displayed.
+Once an event is selected, Mixpanel calculates the most common events performed by users immediately before or after the selected event. These intermediate events can match either regularly tracked events OR the most used custom events in your project. The icon will let you know at a glance the type of event being displayed.

@@ -178,7 +178,7 @@ In the above example, Install or Open is a custom event, while Experiment Starte
#### Other Events
-At each step in the flow, Mixpanel by default displays the top 3 intermediate events performed by users ordered by the number of users who performed them at that step. The rest of the events performed are grouped into a single bar called "Other events".
+At each step in the flow, Mixpanel by default displays the top 3 intermediate events performed by users, ordered by the number of users who performed them at that step. The rest of the events performed are grouped into a single bar called "Other events".

@@ -204,15 +204,15 @@ By default, Flows calculations are based on **uniques**. To change to a differ

-**Uniques** Unique flows count a single entry per user (determined by distinct\_id). Each can do the first step only once, and this is on the first time they perform the Step A event in the date range. Even if a particular user completes the funnel multiple times in the date range, they will only be counted towards conversion once, and on the first time they entered in the span of the funnel.
+**Uniques:** counts a single entry per user (determined by distinct\_id). Each can do the first step only once, and this is on the first time they perform the Step A event in the date range. Even if a particular user completes the funnel multiple times in the date range, they will only be counted towards conversion once, and on the first time they entered in the span of the funnel.
-**Totals** Totals flows count multiple entries per user. Users can re-start the flow and every time a user starts the flow they are counted. Users may re-enter a totals flows only after they have exited their previous attempt. Users exit a flow in 3 ways:
+**Totals:** counts multiple entries per user. Users can restart the flow, and every time a user starts the flow, they are counted. Users may re-enter a totals flows only after they have exited their previous attempt. Users exit a flow in 3 ways:
1. They complete the last required step in the flow
2. They fail to get to the last required step in the conversion window and time out,
3. They are excluded from the current flow by an exclusion step.
-**Sessions** Sessions ensure every step in the flow is performed in the same session. Like totals flows, users will be allowed to re-start the flow in subsequent sessions. Learn more about Sessions [here](/docs/features/sessions).
+**Sessions:** ensure every step in the flow is performed in the same session. Like totals flows, users will be allowed to restart the flow in subsequent sessions. Learn more about Sessions [here](/docs/features/sessions).
#### Conversion Window
@@ -228,7 +228,7 @@ The maximum amount of time you can choose for the conversion window is 366 days,
Holding a property constant in flows requires that a user retain the same value of a given event property for an event to be considered part of the flow.
-For example, let's say your product is an e-commerce retail site, and you want to see flows between Add to Cart \> Purchase as long as they purchased the same item - meaning they must be interacting with the same item in every step of the flow - you would hold the Item Name property constant.
+For example, let's say your product is an e-commerce retail site, and you want to see flows between Add to Cart -\> Purchase as long as they purchased the same item - meaning they must be interacting with the same item in every step of the flow - you would hold the Item Name property constant.
The way this is calculated depends on whether you have selected a counting method that does not allow users to re-enter the flow ("Uniques") or allows re-entry ("Totals" or "Sessions).
@@ -241,13 +241,13 @@ To add a property constant to your flows, select the **Holding property constan

-Some things to keep in mind are that you are only able to select event properties that apply to all of the required steps. Also, you can select multiple properties, but when you do ALL must be kept constant.
+Some things to keep in mind are that you are only able to select event properties that apply to all of the required steps. Also, you can select multiple properties, but when you do, **all** must be kept constant.
## Advanced
### Top Paths
-Another way to visualize your user flows is by "Top Paths", which condenses the flows down to unique paths on each row. This visualization is great for understanding the most common paths users take, though they may not be similar. In this case, since we want to understand the most common paths, choose Top Paths. Your report should look like this:
+Another way to visualize your user flows is by "Top Paths", which condenses the flows down to unique paths on each row. This visualization is great for understanding the most common paths users take, though they may not be similar. In this case, since we want to understand the most common paths, we choose Top Paths. Your report should look like this:
In the top bar of the visualization, you will see the option to toggle between User Flows and Top Paths.
@@ -261,7 +261,7 @@ Top paths will show the 50 most common event sequences of up to the number of st

-The total percentage of users who reached the ultimate destination of a flow is indicated on the top left, while the total users that reached a given step and the percentage of users who converted from the previous step are indicated on the bottom of each step.
+The total percentage of users who reached the ultimate destination of a flow is indicated on the top left, while the total number of users that reached a given step and the percentage of users who converted from the previous step are indicated on the bottom of each step.

@@ -274,13 +274,13 @@ You can choose to expand the results of your report by a particular property to
Click the **Expand** button, select an event, and then select a property under that event.
- 
+ 
-You can also expand on a specific event in the chart below by right clicking on an event and selecting **Expand by property**.
+You can also expand on a specific event in the chart below by right-clicking on an event and selecting **Expand by property**.
- 
+ 
### Breakdown and Compare by Cohorts
@@ -288,7 +288,7 @@ You can also expand on a specific event in the chart below by right clicking on
Beside the **Filter** button, select the **Breakdown** button to select one or more cohorts from the drop-down list. You will be shown both users in and not in the cohort.
- 
+ 
If you have selected multiple cohorts, the chart below will be broken down by those cohorts. Cohorts will appear in the chart in different colors, making it easy to follow the paths the cohorts took in your flows.
@@ -317,7 +317,7 @@ Click the **Hide Events** button at the top of the chart and check any events

-You can also choose to hide a specific event from the flow by right clicking on it in the Flows chart.
+You can also choose to hide a specific event from the flow by right-clicking on it in the Flows chart.

@@ -331,7 +331,7 @@ You may pick custom events as the starting or ending events directly in the quer
#### Custom events as intermediate events
-Mixpanel automatically considers the most used and common custom events in your project, displaying them in intermediate steps instead of showing the underlying events. When a custom event is shown instead of the underlying event, it is annotated with the custom event icon to indicate that the event displayed is a custom event.
+Mixpanel automatically considers the most used and common custom events in your project, displaying them in intermediate steps instead of showing the underlying events. When a custom event is shown instead of the underlying event, it is annotated with the custom event icon to indicate that the event displayed is custom.

@@ -340,8 +340,8 @@ Mixpanel automatically considers the most used and common custom events in your
Mixpanel uses the following criteria to decide which custom events are shown in user flows:
1. Custom events that are shared with all users in the projects are the only ones picked to be shown in flows right now
-2. Only the 50 most frequently queried custom events in the project are used in flows analysis.
-3. If custom events have overlapping definitions (e.g. both custom events operate on the same event), we will choose the more frequently queried custom event to show in the report.
+2. Only the 50 most frequently queried custom events in the project are used in Flows analysis.
+3. If custom events have overlapping definitions (e.g., both custom events operate on the same event), we will choose the more frequently queried custom event to show in the report.
#### Expanding custom events
@@ -353,7 +353,7 @@ You may also expand custom events by event name to view the underlying events if
#### Disabling custom events
-You can disable custom events for flows by toggling the Show Custom Events in the dropdown menu below. Custom events that have been manually chosen as steps in the flow will continue to show up, but no other other custom events will be shown.
+You can disable custom events for flows by toggling the Show Custom Events in the dropdown menu below. Custom events that have been manually chosen as steps in the flow will continue to show up, but no other custom events will be shown.

@@ -361,4 +361,4 @@ You can disable custom events for flows by toggling the Show Custom Events in th
### Exclusion Steps
-You can add exclusion steps, which exclude users who did a particular step. This is useful digging into a particular view, for example to explore the 2nd most popular path taken.
\ No newline at end of file
+You can add exclusion steps, which exclude users who did a particular step. This is useful for digging into a particular view, for example, to explore the 2nd most popular path taken.
\ No newline at end of file
diff --git a/docs/reports/funnels/funnels-advanced.mdx b/docs/reports/funnels/funnels-advanced.mdx
index e2fed58c..e35f11c7 100644
--- a/docs/reports/funnels/funnels-advanced.mdx
+++ b/docs/reports/funnels/funnels-advanced.mdx
@@ -1,6 +1,6 @@
---
-sidebarTitle: "Advanced"
title: "Funnels Advanced Concepts"
+sidebarTitle: "Advanced"
---
import { ExtendedButton } from "/snippets/ExtendedButton/ExtendedButton.jsx";
@@ -12,14 +12,8 @@ This page covers advanced concepts related to funnels, including how their metri
## Conversion Criteria
-
-
+
+
### Conversion Window
@@ -28,10 +22,10 @@ The Conversion Window determines how much time a user has to convert through all
By default, all customers have 7 days to complete a funnel from the timestamp they perform the Step 1 event. To adjust this conversion window, click on the words 7 **days** in the conversion criteria. You will be able to adjust both the unit of time and the amount.
-
+ 
-The maximum amount of time you can choose for the conversion window is 366 days, or otherwise equivalent (12 months, 52 weeks, etc). For session-based conversion windows, the maximum is 12 sessions.
+The maximum amount of time you can choose for the conversion window is 366 days, or otherwise equivalent (12 months, 52 weeks, etc). For session-based conversion windows, the maximum is 12 sessions.
Keep in mind that the conversion window starts on the first instance of the Step 1 event per funnel entry, and will not be updated by later instances of the same event in the same funnel entry.
@@ -42,26 +36,26 @@ For example, let's say a user tracks the following:
3. Event B at 1:45 pm
4. Event C at 2:15 pm
-You create a Funnel looking at A → B → C, with a conversion window of 1 hour.
+You create a Funnel looking at A → B → C, with a conversion window of 1 hour.
-This user enters the funnel when they first track Event A at 1:00 pm. They convert through Event B at 1:45 pm, and then time-out of the funnel. They do not show as converting through Event C since Event C took place more than 1 hour after the entry event at 1:00 pm.
+This user enters the funnel when they first track Event A at 1:00 pm. They convert through Event B at 1:45 pm, and then time out of the funnel. They do not show as converting through Event C since Event C took place more than 1 hour after the entry event at 1:00 pm.
-The second instance of Event A at 1:30 pm does not reset the conversion window timer. Event B and Event C would need to be completed within 1 hour from the first Event A tracked for the user to be counted as converted.
+The second instance of Event A at 1:30 pm does not reset the conversion window timer. Event B and Event C would need to be completed within 1 hour of Event A, and tracked for the user to be counted as converted.
### Optimized Re-entry
-When **Optimized Re-entry** mode is enabled, we actively evaluate all funnel entry attempts - even if the user's previous funnel is still in progress. This allows us to capture potential conversions which might occur from subsequent entries, maximizing total conversions.
+When **Optimized Re-entry** mode is enabled, we actively evaluate all funnel entry attempts - even if the user's previous funnel is still in progress. This allows us to capture potential conversions that might occur from subsequent entries, maximizing total conversions.
If any user funnel entries within the report date range result in a conversion, we count the user as converted.
-
+ 
**Scenario 1**
-- Funnel Steps: A -> B
-- Event Stream: A -> Conversion Window Ends for A Ends -> A^ -> B
+- Funnel Steps: A -\> B
+- Event Stream: A -\> Conversion Window Ends for A Ends -\> A^ -\> B
**Default Mode**
@@ -73,8 +67,8 @@ We treat A^ → B as a valid conversion because A^ initiates a new funnel which
**Scenario 2**
-- Funnel: A -> B
-- Event Stream: A -> A^ -> Conversion Window for A Ends -> B
+- Funnel: A -\> B
+- Event Stream: A -\> A^ -\> Conversion Window for A Ends -\> B
**Default Mode**
@@ -82,28 +76,27 @@ Since A^ took place while the funnel entry triggered by A was still active, we i
**Optimized Reentry Mode**
-We treat A^ as a new funnel entry and restart the funnel history. When B occurs, it completes the new funnel A^ → B, which we count as a conversion. The conversion rate would be 50% from the successful conversion for A^ and the drop-off for A. (A′^ / [A + A^])
+We treat A^ as a new funnel entry and restart the funnel history. When B occurs, it completes the new funnel A^ → B, which we count as a conversion. The conversion rate would be 50% from the successful conversion for A^ and the drop-off for A. (A′^ / \[A \+ A^\])
+**PLEASE NOTE:**
-**PLEASE NOTE:**
-1. For [Unique aggregation](/docs/reports/funnels/funnels-advanced#counting-methods) during a date range with multiple funnel conversions, we consider the first converted funnel only. For example in scenario A → B → A^ → B^, there are 2 user funnels converted: A → B and A^ → B^. We only consider the first A → B as the user conversion.
-2. In a multi-step steps funnel, we only consider the first step for re-entries. For every subsequent step, we pick the first instance of the step.
-3. For the first step in a funnel, if there are multiple entries prior to step 2, we consider the most recent entry. For example, in scenario A → A^ → A^^ → B where all actions happen within the conversion window, A^^ → B would be recorded as the funnel.
-4. For all other counting types - [TTC](/docs/reports/funnels/funnels-advanced#time-to-convert), [Property Sum](/docs/reports/funnels/funnels-advanced#property-sum), we compute these based on the funnels selected to optimize maximum conversions. For example, in scenario A → A^ → A^^ → B where all actions happen within the conversion window, in the Optimized Reentry mode TTC would be calculated for A^^ → B. However in the Default mode, TTC would be calculated for A → B.
-
+1. For [Unique aggregation](/docs/reports/funnels/funnels-advanced#counting-methods) during a date range with multiple funnel conversions, we consider the first converted funnel only. For example, in scenario A → B → A^ → B^, there are 2 user funnels converted: A → B and A^ → B^. We only consider the first A → B as the user conversion.
+2. In a multi-step funnel, we only consider the first step for re-entries. For every subsequent step, we pick the first instance of the step.
+3. For the first step in a funnel, if there are multiple entries prior to step 2, we consider the most recent entry. For example, in scenario A → A^ → A^^ → B, where all actions happen within the conversion window, A^^ → B would be recorded as the funnel.
+4. For all other counting types - [TTC](/docs/reports/funnels/funnels-advanced#time-to-convert), [Property Sum](/docs/reports/funnels/funnels-advanced#property-sum) - we compute these based on the funnels selected to optimize maximum conversions. For example, in scenario A → A^ → A^^ → B, where all actions happen within the conversion window, in the Optimized Reentry mode, TTC would be calculated for A^^ → B. However, in the Default mode, TTC would be calculated for A → B.
### Ordering
-The order control determines how much flexibility there can be to the sequence of your user's actions to be counted as a conversion. By default, funnels are based on a specific order.
+The order control determines how much flexibility there can be in the sequence of your user's actions to be counted as a conversion. By default, funnels are based on a specific order.
#### Specific Order
-Specific Order Funnels require the user to complete each of the funnel steps in the order laid out to be counted as a conversion from one step to another. In other words, Step 1 must be completed before Step 2, which must be completed before Step 3, and so on. The user can engage in other actions in between funnel steps - including additional occurrences of the actions listed as funnels steps - but they will only be counted as converted if they complete all the funnel steps in order.
+Specific Order Funnels require the user to complete each of the funnel steps in the order laid out to be counted as a conversion from one step to another. In other words, Step 1 must be completed before Step 2, which must be completed before Step 3, and so on. The user can engage in other actions in between funnel steps - including additional occurrences of the actions listed as funnel steps - but they will only be counted as converted if they complete all the funnel steps in order.
To illustrate with an example, let's say a specific order funnel has steps: A → B → C → D → E
1. The user does events A → B → C → D → E in exact order. Mixpanel counts this as a conversion.
-2. The user does event A → B → **F** → C → D → E. Mixpanel counts this as a conversion. Users can do additional actions in between funnels steps and still convert.
+2. The user does event A → B → **F** → C → D → E. Mixpanel counts this as a conversion. Users can do additional actions in between funnel steps and still convert.
3. The user does events A → B → **D** → C → D → E. Mixpanel counts this as a conversion. Even though the user did D before the first time they did C, they will continue to convert because they eventually did a D after C.
4. The user does events A → B → C → E. Mixpanel will not count this as a full conversion, and the customer will drop off after step C. The customer's completion of step E is excluded from the funnel because step D did not occur.
@@ -115,58 +108,49 @@ A good example of this could be a job application flow, where a user must input
To switch to **Any Order**, expand the “Advanced” menu in the Conversion Criteria and toggle on “Any Order”.
-When you switch to **Any Order,** you have the option to anchor specific steps in your funnel by clicking on the step number.
+When you switch to **Any Order,** you have the option to anchor specific steps in your funnel by clicking on the step number.
-A step will either appear with a number beside it, indicating where it must fall in the funnel, or with an asterisk (*), indicating that it can be performed in any order before the next anchored step.
+A step will either appear with a number beside it, indicating where it must fall in the funnel, or with an asterisk (\*), indicating that it can be performed in any order before the next anchored step.
-If you have selected any order for your funnels steps, you have the option to select **Top paths** from the drop-down visualization list to view a [Sankey visualization](/docs/reports/flows#sankey-chart) of how your users are performing the steps in your funnel.
+If you have selected any order for your funnel steps, you have the option to select **Top paths** from the drop-down visualization list to view a [Sankey visualization](/docs/reports/flows#sankey-chart) of how your users are performing the steps in your funnel.
-
+ 
### Hold Property Constant
-Holding a property constant in a funnel requires that a user retains the same value for a given event property for each step to convert. In other words, a user must perform the funnel events in the order you specified with the same property value.
+Holding a property constant in a funnel requires that a user retain the same value for a given event property for each step to convert. In other words, a user must perform the funnel events in the order you specified with the same property value.
-For example, let's say your product is an e-commerce retail site, and you have a three-step funnel of Browse → Add to Cart → Purchase. If you want to examine the conversion of users through this funnel that browse, add to cart, and purchase the same item - meaning that they cannot convert if they do not complete each step with the same item - you would hold the Item Name property constant.
+For example, let's say your product is an e-commerce retail site, and you have a three-step funnel of Browse → Add to Cart → Purchase. If you want to examine the conversion of users through this funnel who browse, add to cart, and purchase the same item - meaning that they cannot convert if they do not complete each step with the same item - you would hold the Item Name property constant.
-Since all the events must have the property, you can only select event properties that apply to all of the events in your funnel. You can select multiple properties, but when you do ALL of them must be kept constant. A maximum of 3 properties can be held constant at the same time.
+Since all the events must have the property, you can only select event properties that apply to all of the events in your funnel. You can select multiple properties, but when you do, **all** of them must be kept constant. A maximum of 3 properties can be held constant at the same time.
The way entry values are determined when "Holding Property Constant" depends on the selected counting method:
-- **Uniques:** With “Uniques” counting method, users will only enter the funnel once, on the first time they do Step 1. Mixpanel will hold constant the property value from the first Step 1 event.
+- **Uniques:** With the “Uniques” counting method, users will only enter the funnel once, the first time they do Step 1. Mixpanel will hold the property value constant from the first Step 1 event.
- **Totals or Sessions:** “Totals” and “Sessions” counting methods allow users to re-enter the funnel. Mixpanel will hold the property constant that is set with each new re-entry at the Step 1 event. This means the user can enter multiple times with different property values.
To hold a property constant in your funnel, expand the “Advanced” menu and click “Holding property constant”.
-
+ 
## Exclusion Steps (Exclude users who did…)
-Exclusion steps operate as a “did not do” filter for funnels. This provides the ability to create a funnel where users are excluded from converting if they track a specific event between the funnel steps.
+Exclusion steps operate as a “did not do” filter for funnels. This provides the ability to create a funnel where users are excluded from converting if they track a specific event between the funnel steps.
A few things to note about exclusion steps:
-1. An exclusion step can be placed between any steps in the funnel. It cannot be the first or last step.
-
- Example scenario: The user tracks (1) Event A → (2) Event A → (3) Event A → (4) Event B
-
- Totals conversion funnel looking at A → B, with Exclusion Step: Event A
-
- The user enters the funnel when they track (1). They then drop-off when they track (2) since Event A is excluded. With the totals conversion criteria, the user will re-enter the funnel at (3) and then convert with (4). Overall, there will be two entries and one conversion.
-
- Example reports for reference from our demo dataset:
-
- - [User activity](https://mixpanel.com/s/2it5gE)
- - [Funnel](https://mixpanel.com/s/2CpCuq)
-2. A user will qualify for each step in the funnel until they track the exclusion step. This means users who tracked the exclusion step are still able to enter the funnel and convert through steps. Use a [cohort](/docs/users/cohorts) filter if you want users who did a particular event at any point excluded from entering the funnel.
+1. An exclusion step can be placed between any steps in the funnel. It cannot be the first or last step. Example scenario: The user tracks (1) Event A → (2) Event A → (3) Event A → (4) Event B Totals conversion funnel looking at A → B, with Exclusion Step: Event A The user enters the funnel when they track (1). They then drop off when they track (2) since Event A is excluded. With the totals conversion criteria, the user will re-enter the funnel at (3) and then convert with (4). Overall, there will be two entries and one conversion. Example reports for reference from our demo dataset:
+ - [User activity](https://mixpanel.com/s/2it5gE)
+ - [Funnel](https://mixpanel.com/s/2CpCuq)
+2. A user will qualify for each step in the funnel until they track the exclusion step. This means users who tracked the exclusion step are still able to enter the funnel and convert through the steps. Use a [cohort](/docs/users/cohorts) filter if you want users who did a particular event at any point to be excluded from entering the funnel.
3. There may be any number of exclusion events between steps.
-4. Exclusion steps have the same [two second grace period](/docs/reports/funnels/funnels-faq#how-does-the-funnel-handle-simultaneous-events) as other steps in the funnel.
+4. Exclusion steps have the same two-second [grace period](/docs/reports/funnels/funnels-faq#how-does-the-funnel-handle-simultaneous-events) as other steps in the funnel.
-As an example, let's say you want to understand if users who add additional products to their cart and checking out are less likely to complete a purchase. To answer this question, you could create a funnel with four steps:
+As an example, let's say you want to understand if users who add additional products to their cart and check out are less likely to complete a purchase. To answer this question, you could create a funnel with four steps:
Step 1: Product Viewed
@@ -178,22 +162,22 @@ Step 4: Purchase Completed
You can exclude users who did another “Product Added” event between Step 2 and Step 3 to see how that affects your funnel's conversion rate.
-To add an exclusion step in your funnel, expand the “Advanced” menu and click “Exclude users who did…”.
+To add an exclusion step in your funnel, expand the “Advanced” menu and click “Exclude users who did…”.
-Select an event from the list and choose whether you would like the event to be excluded between all steps, or between specific steps. Click the Filter icon beside the step to filter that event by an event or user profile property.
+Select an event from the list and choose whether you would like the event to be excluded from all steps or between specific steps. Click the Filter icon beside the step to filter that event by an event or user profile property.
-
+ 
## Saved Funnel Behaviors
-You can save the Funnel Behavior you built and reuse them in other reports. This can be helpful when there is a sequence of events that you frequently analyze (such as sign up flow), or if you want to analyze your Funnels Behavior along-side other metrics in an Insights report.
+You can save the Funnel Behavior you built and reuse it in other reports. This can be helpful when there is a sequence of events that you frequently analyze (such as sign-up flow), or if you want to analyze your Funnels Behavior alongside other metrics in an Insights report.
-Select the "..." button in the top right corner of the metric, then click "Save Behavior". Note that saving a behavior and saving a metric is different; a saved behavior consists of the events/Funnels/Retention, while a saved metrics consists of the saved behavior and the measurements of the behavior.
+Select the "..." button in the top right corner of the metric, then click "Save Behavior". Note that saving a behavior and saving a metric are different; a saved behavior consists of the events/Funnels/Retention, while a saved metric consists of the saved behavior and the measurements of the behavior.
-
+ 
Learn more about [Saved Metrics and Behaviors](/docs/features/saved-metrics-and-behaviors).
@@ -204,31 +188,31 @@ You have a variety of options to measure your funnel behavior.
### Counting Methods
-| Counting Method | Description |
-|-----------------|--------------|
-| Uniques | Users will enter the funnel the first time that they track Step 1 in the time period selected. When a breakdown is applied, they can enter up to once per segment. |
-| Totals | Users can re-enter a totals funnel after they have exited their previous attempt through the funnel. Users exit in three ways: successful conversion through the funnel, time out of the [conversion window](/docs/reports/funnels/funnels-advanced#conversion-window), or track an [exclusion step](/docs/reports/funnels/funnels-advanced#exclusion-steps-exclude-users-who-did). |
-| Sessions | Users can enter the funnel in each session that qualifies. |
+| Counting Method | Description |
+| --- | --- |
+| Uniques | Users will enter the funnel the first time that they track Step 1 in the time period selected. When a breakdown is applied, they can enter up to once per segment. |
+| Totals | Users can re-enter a totals funnel after they have exited their previous attempt through the funnel. Users exit in three ways: successful conversion through the funnel, time out of the [conversion window](/docs/reports/funnels/funnels-advanced#conversion-window), or track an [exclusion step](/docs/reports/funnels/funnels-advanced#exclusion-steps-exclude-users-who-did). |
+| Sessions | Users can enter the funnel in each session that qualifies. |
### Measurements
-| Measurements | Description | Counting Method |
-|-------------------|-------------|-----------------|
-| Conversion Rate | The rate at which funnels are completed for the selected steps of the funnel. | Uniques (default), Totals, or Sessions. |
-| Unique Users | The number of users who completed the selected steps of the funnel. | Uniques |
-| Total Conversions | The total number of funnels that have reached the selected step of the funnel. | Totals |
-| Total Sessions | The total number of unique users sessions that reached the selected step of the funnel | Sessions |
-| Time to Convert | Allows for selection of an aggregation: Average, Median, Percentile, Min and Max. Measures the aggregated time to convert for the selected steps of the funnel. See more [here](/docs/reports/funnels/funnels-advanced#time-to-convert-measurement). | Totals |
-| Property Sum | Sums up a chosen property value for each step of the funnel, and measures the total amount of the property converted for the selected step of the funnel. See more [here](/docs/reports/funnels/funnels-advanced#property-sum). | Totals |
+| Measurements | Description | Counting Method |
+| --- | --- | --- |
+| Conversion Rate | The rate at which funnels are completed for the selected steps of the funnel. | Uniques (default), Totals, or Sessions. |
+| Unique Users | The number of users who completed the selected steps of the funnel. | Uniques |
+| Total Conversions | The total number of funnels that have reached the selected step of the funnel. | Totals |
+| Total Sessions | The total number of unique users sessions that reached the selected step of the funnel | Sessions |
+| Time to Convert | Allows for selection of an aggregation: Average, Median, Percentile, Min and Max. Measures the aggregated time to convert for the selected steps of the funnel. See more [here](/docs/reports/funnels/funnels-advanced#time-to-convert-measurement). | Totals |
+| Property Sum | Sums up a chosen property value for each step of the funnel, and measures the total amount of the property converted for the selected step of the funnel. See more [here](/docs/reports/funnels/funnels-advanced#property-sum). | Totals |
### Step Selection
-You can select which step of the funnel you would like to measure. By default this is set to All Steps. To change your step selection, press “All Steps” and choose the desired range.
+You can select which step of the funnel you would like to measure. By default, this is set to All Steps. To change your step selection, press “All Steps” and choose the desired range.
-When measuring “Unique Users”, “Total Conversions” or “Total Sessions”, you can select “Entering Funnel” in order to get a top-of-funnel count. Similarly, if you would like to get the bottom-of-funnel count, you can choose “All Steps”.
+When measuring “Unique Users”, “Total Conversions”, or “Total Sessions”, you can select “Entering Funnel” in order to get a top-of-funnel count. Similarly, if you would like to get the bottom-of-funnel count, you can choose “All Steps”.
-
+ 
## Time to Convert
@@ -237,83 +221,85 @@ Time to Convert is a feature within the Funnels report that measures how long it
### Time to Convert Measurement
-You can select a Time to Convert aggregation to see how quickly or slowly your funnel converts. You can see this as a summarized value by selecting “Metric” or “Bar” visualizations, or you can see it as a trend using the “Line” visualization. You can also see the time to convert for a particular chosen step selection. (Note: Our percentiles are calculated using an approximate algorithm and when this algorithm is run on small/sparse datasets, the results can be non-deterministic, i.e. the results can differ by a small amount across runs.)
+You can select a Time to Convert aggregation to see how quickly or slowly your funnel converts. You can see this as a summarized value by selecting “Metric” or “Bar” visualizations, or you can see it as a trend using the “Line” visualization. You can also see the time to convert for a particular chosen step selection. (Note: Our percentiles are calculated using an approximate algorithm, and when this algorithm is run on small/sparse datasets, the results can be non-deterministic, i.e., the results can differ by a small amount across runs.)
-
+ 
### Time to Convert Breakdown
-You can select the Time to Convert breakdown to see a distribution of time users took across the funnel or between any two steps. The steps selected in the breakdown are independent of the step of the metric you are measuring, for example, you can measure the overall conversion rate broken down by Time to Convert between Steps 1 and 2.
+You can select the Time to Convert breakdown to see a distribution of the time users took across the funnel or between any two steps. The steps selected in the breakdown are independent of the step of the metric you are measuring. For example, you can measure the overall conversion rate broken down by Time to Convert between Steps 1 and 2.
-Time to Convert works like any other property in that you can filter to specific range of times or customize the bucketing of the breakdown. You can't use it as a inline filter since it is used to filter funnels which have been measured rather than changing the per step conversion window.
+Time to Convert works like any other property in that you can filter to a specific range of times or customize the bucketing of the breakdown. You can't use it as an inline filter since it is used to filter funnels, which have been measured, rather than changing the per-step conversion window.
-You can can see a distribution of the conversions time to convert by using the Time to Convert breakdown in combination with measuring total conversion. You can also use this to see how other metrics such as conversion rate are affected based on how quickly users convert on a particular step range.
+You can see a distribution of the conversion time to convert by using the 'Time to Convert' breakdown in combination with measuring total conversion. You can also use this to see how other metrics, such as conversion rate, are affected based on how quickly users convert on a particular step range.
-
+ 
## Property Sum
This measurement type allows you to visualize a numeric event property through a funnel. Instead of seeing how many users move through your flow, you can select an event property that exists on each step of the funnel. Mixpanel will sum up the total value of this property at each stage of the funnel and visualize the total amount converted, or the drop-off at each step if “Funnel Steps” visualization is selected. For example, this could be used to visualize the revenue across the funnel steps.
-**Note**: For many e-commerce flows, you will want to pair property sum with [hold property constant](/docs/reports/funnels/funnels-advanced#hold-property-constant) on item ID so you can track each individual item.
+**Note**: For many e-commerce flows, you will want to pair the property sum with [hold property constant](/docs/reports/funnels/funnels-advanced#hold-property-constant) on item ID so you can track each individual item.
-To use property sum, select property sum from the measurement menu, and select a numeric property.
+To use this property, select Property Sum from the measurement menu and select a numeric property.
-
+ 
## Behavioral Properties
-Behavioral properties allow you to use your user’s activity and use it as a property in your other analysis. Behavioral properties work like any other numeric property in that you are able to filter to a specific range of frequencies or customize how it is bucketed.
+Behavioral properties allow you to use your user’s activity and use it as a property in your other analysis. Behavioral properties work like any other numeric property in that you can filter to a specific range of frequencies or customize how it is bucketed.
-In funnels, the behavioral property is computed in the time range between 2 steps in your funnel. You can specify which steps in the funnel this applies to. The step selection is separate from the overall funnel measurement, for example, you can measure overall conversion rate but breakdown by the frequency of an event between Step 1 and 2.
+In funnels, the behavioral property is computed in the time range between 2 steps in your funnel. You can specify which steps in the funnel this applies to. The step selection is separate from the overall funnel measurement; for example, you can measure the overall conversion rate but break it down by the frequency of an event between Steps 1 and 2.
-The behavioral properties will only count the events in between the chosen range. The event that original satisfied the funnel definition does not count towards the behavioral property between steps.
+The behavioral properties will only count the events in the chosen range. The event that originally satisfied the funnel definition does not count towards the behavioral property between steps.
For example, if a user performs “Step 1 → Step 2”:
+
- Frequency: “0 times” — there is no extra “Step 1” event, so the frequency will be “0 times”
For example, if a user performs “Step 1 → Step 1 → Step 2”:
-- Frequency: “1 time” — we will count the second “Step 1” event so the frequency will be “1 time”
+
+- Frequency: “1 time” — we will count the second “Step 1” event, so the frequency will be “1 time”
See [here](/docs/features/computed-properties#behavioral-properties) for more information about behavioral properties.
-
+ 
### Frequency per User
-Use the Frequency per User to see the number of times users performed an event between any two funnel steps. For example, see the number of times a user listened to a song between sign up and purchasing the song.
+Use the Frequency per User to see the number of times users performed an event between any two funnel steps. For example, see the number of times a user listened to a song between signing up and purchasing the song.
### Aggregate Property per User
-User the Aggregate Property per User to see the aggregation on an event property between steps. For example, you can see the sum of a purchase amount between steps.
+Use 'Aggregate Property per User' to see the aggregation on an event property between steps. For example, you can see the sum of a purchase amount between steps.
-## Attributed by Breakdown
+## "Attributed by..." Breakdown
-You can select the "Attributed by…" breakdown to attribute credit for the funnel to touchpoints along the user journey. The attribution is calculated on the first step of the funnel. See the [Attribution doc](/docs/features/computed-properties#attribution) for more information.
+You can select this breakdown to attribute credit for the funnel to touchpoints along the user journey. The attribution is calculated on the first step of the funnel. See the [Attribution doc](/docs/features/computed-properties#attribution) for more information.
## Comparison Events
-You can select multiple events at a particular step in a funnel, and Mixpanel will compute a segmented funnel that shows what percent of users reached each of these comparison events.
+You can select multiple events at a particular step in a funnel, and Mixpanel will compute a segmented funnel that shows what percent of users reached each of these comparison events.
To do this, click on the ”…” menu and select “Event Comparison”
-
+ 
## Breakdowns
### User Count in Breakdown
-Users will count in each breakdown segment in which they qualify. In order to qualify for a new segment, the user must have exited their previous funnel attempt unless the funnel is [holding a property constant](/docs/reports/funnels/funnels-advanced#hold-property-constant). The breakdown segment value is determined by the selected [property attribution.](/docs/reports/funnels/funnels-advanced#property-attribution)
+Users will count in each breakdown segment in which they qualify. In order to qualify for a new segment, the user must have exited their previous funnel attempt unless the funnel is [holding a property constant](/docs/reports/funnels/funnels-advanced#hold-property-constant). The breakdown segment value is determined by the selected [property attribution](/docs/reports/funnels/funnels-advanced#property-attribution).
For example, let's say a user tracks the following:
@@ -322,9 +308,9 @@ For example, let's say a user tracks the following:
3. Add to Cart
4. Browse Product, item = shoes
-The funnel looks at Browse Product → Add to Cart, with a breakdown on "item" set to attribute the funnel on the value of "Step 1".
+The funnel looks at Browse Product → Add to Cart, with a breakdown on "item" set to attribute the funnel on the value of "Step 1".
-This user would enter the funnel when they first track "Browse Product" with "item = shirt". The second "Browse Product" event is not counted as a new entry since the user has not exited the current funnel attempt. They then convert on event 3, when they track "Add to Cart". With the breakdown applied on "item", they will re-enter the funnel when they track "Browse Product" with the new item value of "shoes".
+This user would enter the funnel when they first track "Browse Product" with "item = shirt". The second "Browse Product" event is not counted as a new entry since the user has not exited the current funnel attempt. They then convert on event 3, when they track "Add to Cart". With the breakdown applied to "item", they will re-enter the funnel when they track "Browse Product" with the new item value of "shoes".
Overall, the funnel would show two entries, "shirt" and "shoes", with one conversion on "shirt".
@@ -340,10 +326,10 @@ In order to clarify this statistical significance, the segmentation chart shows
- \< 0.95 = not statistically significant, indicated in red. This variation in conversion rate is likely driven by random chance.
-
+ 
-Scrolling further down the table takes you to the statistically insignificant segments. If a segment has less than 30 samples, the p-value is not shown, as the sample size is too low to detect differences from the overall population. This is indicated by “Insufficient samples”.
+Scrolling further down the table takes you to the statistically insignificant segments. If a segment has fewer than 30 samples, the p-value is not shown, as the sample size is too low to detect differences from the overall population. This is indicated by “Insufficient samples”.
The number of samples is the same as the count of entries into the funnel. If the funnel is looking at the unique count, this is the number of unique users who entered the funnel in that segment. If the funnel is looking at the total count, this is the total number of entries into the funnel in that segment.
@@ -360,27 +346,27 @@ Inline filters allow you to apply event or user property filters to each step of
Inline filters are performed pre-query. Thus, these filters will impact your funnel's conversion by removing events that don't qualify from consideration of being included in a funnel calculation.
-
+ 
Let's illustrate this with some examples.
Consider a three-step funnel where a user must View Item → Add to Cart → Purchase, all within a one-hour conversion window.
-As you can see in the below activity feed, this user's first "View Item" event happens more than one hour before they "Add to Cart", so they would drop off after the initial "View Item". As such, the funnel would show one entry with no conversions.
+As you can see in the activity feed below, this user's first "View Item" event happens more than one hour before they "Add to Cart", so they would drop off after the initial "View Item". As such, the funnel would show one entry with no conversions.
-
+ 
However, if you put an **inline filter on the "View Item" event with "Browser = Safari"**, then users will only enter the funnel with "View Item" events on Safari browsers.
-Below we see the same user's activity stream where their first "View Item" is with the Chrome browser, and thus this user's first "View Item" event **is not** included in a funnels calculation.
+Below we see the same user's activity stream, where their first "View Item" is with the Chrome browser, and thus this user's first "View Item" event **is not** included in a funnel's calculation.
-They have a second "View Item" that is using Safari, and this event qualifies them to enter into the funnel. Each of their subsequent steps happens within the conversion window, and this user reaches full conversion to the end of the funnel.
+They have a second "View Item" that is using Safari, and this event qualifies them to enter into the funnel. Each of their subsequent steps happens within the conversion window, and this user reaches full conversion at the end of the funnel.
-
+ 
If we were to take it further and place an inline filter on each and every step in this funnel, so that all steps must be completed with events where Browser = Safari, then this user would only convert to the second step of "Add to Cart". This is because the "Purchase" event doesn't have a browser set.
@@ -394,48 +380,48 @@ For example, let's use the same three-step funnel where a user must View Item
In the below example, the same user's funnel entry would be their first "View Item" event, with a "Browser = Chrome" since this is the first defined property value. When the global filter is applied, the entire entry is filtered out since it doesn't meet the filter criteria. This means the report would show no users entering the funnel at "View Item".
-
+ 
## Property Attribution
### First Step Defined vs Last Step Defined
-Event property values can vary from step to step in your funnel, you can choose which step the value is derived from for breakdowns and filters.
+Event property values can vary from step to step in your funnel. You can choose which step the value is derived from for breakdowns and filters.
To access this feature, filter or breakdown by a property in the funnel chart below the query builder. Click on **Step 1** to select either “Last Step Defined”, “First Step Defined”, or a specific step number. Your selected choice will determine which step of your funnel determines the property value for the whole funnel.
-
+ 
-### First Step Defined Attribution and Forwardfilling
+### "First Step Defined" Attribution and Forwardfilling
-By default, Mixpanel “forwardfills” [event properties](/docs/data-structure/events-and-properties) in instances where properties are sent in earlier steps of a Funnel but not sent in subsequent steps of the same funnel. This means that the property that is present in early steps of a funnel is appended to the later steps of the funnel where it was previously absent.
+By default, Mixpanel _forward-fills_ [event properties](/docs/data-structure/events-and-properties) in instances where properties are sent in earlier steps of a Funnel but not sent in subsequent steps of the same funnel. This means that the property that is present in the early steps of a funnel is appended to the later steps of the funnel, where it was previously absent.
-Select **First Step Defined** to attribute the first property value to the whole funnel, regardless of whether the property value changes in subsequent steps. First Step Defined is not the same as the first step of the funnel, rather it is the first time the property is given a non-null defined value.
+Select **First Step Defined** to attribute the first property value to the whole funnel, regardless of whether the property value changes in subsequent steps. First Step Defined is not the same as the first step of the funnel; it is the first time the property is given a non-null defined value.
For example, say that the user is shopping on your website and you want to track a funnel from Page View → View Item → Add to Cart → Checkout, with a breakdown on "color". With "First Step Defined", the first color will be applied to the entire funnel, in this case, "red" seen on View Item.
-
+ 
### Last Step Defined Attribution
-By default, Mixpanel “backfills” [event properties](/docs/data-structure/events-and-properties) in instances where properties are sent in later steps of a Funnel but not sent in the earlier steps of the same funnel. This means that the property that is present in later steps of a funnel is appended to the earlier steps of the funnel where it was previously absent.
+By default, Mixpanel “backfills” [event properties](/docs/data-structure/events-and-properties) in instances where properties are sent in later steps of a Funnel but not sent in the earlier steps of the same funnel. This means that the property that is present in later steps of a funnel is appended to the earlier steps of the funnel, where it was previously absent.
-Select **Last Step Defined** to attribute the last property value to the whole funnel, regardless of the property value in previous steps. Last Step Defined is not the same as the last step of the funnel, rather it is the last time the property is given a non-null defined value.
+Select **Last Step Defined** to attribute the last property value to the whole funnel, regardless of the property value in previous steps. Last Step Defined is not the same as the last step of the funnel; it is the last time the property is given a non-null defined value.
-For example, say that the user is shopping on your website and you want to track a funnel from Page View → View Item → Add to Cart → Checkout, with a breakdown on "color". With "Last Step Defined", the last defined color value will be applied to the entire funnel, in this case "blue" seen on Add to Cart.
+For example, say that the user is shopping on your website and you want to track a funnel from Page View → View Item → Add to Cart → Checkout, with a breakdown on "color". With "Last Step Defined", the last defined color value will be applied to the entire funnel, in this case, "blue" seen on Add to Cart.
-
+ 
### Per-Step Attribution
-You can choose to attribute a property value from any step to the whole funnel by selecting the step number. Note that with this option you may see an “undefined” null value for the property, as this option is not tied to when the property value was defined.
+You can choose to attribute a property value from any step to the whole funnel by selecting the step number. Note that with this option, you may see an “undefined” null value for the property, as this option is not tied to when the property value was defined.
## View as Flow
@@ -448,25 +434,22 @@ For example, you might use this to discover that most users who dropped off are
## Rename a Step
-Click on the “...” icon besides a step and click "Rename" to rename it.
+Click on the “...” icon beside a step and click "Rename" to rename it.
+
+{/* Next Section */}
+
+
+
+ Next: Frequently Asked Questions
+
+
+ Still got questions? Get answers to the most frequently asked Funnels questions below.
+
-{/* Next Section */}
+
-
-
-
-
- Next: Frequently Asked Questions
-
-
- Still got questions? Get answers to the most frequently asked Funnels questions below.
-
-
-
-
-
+
+
+
\ No newline at end of file
diff --git a/docs/reports/funnels/funnels-faq.mdx b/docs/reports/funnels/funnels-faq.mdx
index ec9233a4..9f2fe159 100644
--- a/docs/reports/funnels/funnels-faq.mdx
+++ b/docs/reports/funnels/funnels-faq.mdx
@@ -1,11 +1,11 @@
---
-sidebarTitle: "FAQ"
title: "Funnels FAQ"
+sidebarTitle: "FAQ"
---
#### Why is my user shown as dropped off even though they've just completed the full funnel today?
-Assuming that the user performed all actions in the funnel, on their first try, in the right sequence, within the conversion window, the user should be counted as converted. However, there is an ID Merge delay where it can take up to 24 hours for the anonymous and identified user activity to be linked together across Mixpanel. If you are looking at the Funnel report for today, the events may not be linked to one user if it is soon after ingestion. Once the identities are merged, the funnel should display the conversion if the user performs the steps in the funnel in the specified sequence.
+Assuming that the user performed all actions in the funnel, on their first try, in the right sequence, within the conversion window, the user should be counted as converted. However, there is an ID Merge delay where it can take up to 24 hours for the anonymous and identified user activity to be linked together across Mixpanel. If you are looking at the Funnel report for today, the events may not be linked to one user if they are soon after ingestion. Once the identities are merged, the funnel should display the conversion if the user performs the steps in the funnel in the specified sequence.
#### Can users do other actions during the funnel?
@@ -13,7 +13,7 @@ Users can complete the steps you designate in your funnel in loose order. Loose
#### Why do I get differing numbers when comparing Funnels and Insights?
-Funnels and Insights are fundamentally different when it comes to counting events. A Funnels report expects users to convert through a series of events within a specified time period, with additional logic around re-entries and filtering. An Insight metric is giving the actual count of users or events.
+Funnels and Insights are fundamentally different when it comes to counting events. A Funnels report expects users to convert through a series of events within a specified time period, with additional logic around re-entries and filtering. An Insight metric gives the actual count of users or events.
For example, let's say we are looking at a Funnel from Step 1 → Step 2. In the Funnel report, the user will need to enter the report at "Step 1" and then track "Step 2" within the conversion window. If they don't do both of those things, "Step 2" will not be counted in the report. An Insight metric, on the other hand, will count the "Step 2" event without those criteria being met.
@@ -43,9 +43,9 @@ What does this mean in terms of your funnel? In a funnel with step A → B, if a
#### What is the difference between Inline Filtering and Global Filtering?
-You can use both inline and global filters to decide which users and events to include in a funnel. Inline filters apply pre-query to a specified step while global filters apply post-query based on the [property attribution](/docs/reports/funnels/funnels-advanced#property-attribution) selected.
+You can use both inline and global filters to decide which users and events to include in a funnel. Inline filters apply pre-query to a specified step, while global filters apply post-query based on the [property attribution](/docs/reports/funnels/funnels-advanced#property-attribution) selected.
-At a high level, an inline filter query will filter for the funnel entry for the user that meets that filter criteria. With a global filter, the user will enter the funnel the first time that they track Step 1. That entry will then be filtered based on the global filter criteria.
+At a high level, an inline filter query will filter for the funnel entry for the user that meets the filter criteria. With a global filter, the user will enter the funnel the first time that they track Step 1. That entry will then be filtered based on the global filter criteria.
See the [Filters](/docs/reports/funnels/funnels-advanced#filters) for more information.
@@ -59,16 +59,16 @@ This section is intended for users who want to understand the mathematics involv
To determine whether a particular segment's conversion rate is significantly different from the overall conversion rate, we use a hypergeometric distribution to calculate statistical significance. The hypergeometric distribution is used to model the probability of picking k items of a particular type in n attempts without replacement from a population of size N having K items of the same type.
-For example, let's say we have a sock drawer with 20 socks, 10 blue and 10 red. If we randomly picked 10 socks one at time from the drawer without putting them back between picks, and we wanted to know the probability of 9 of those socks being red and 1 of them being blue, we would use a hypergeometric distribution to calculate that.
+For example, let's say we have a sock drawer with 20 socks, 10 blue and 10 red. If we randomly picked 10 socks one at a time from the drawer without putting them back between picks, and we wanted to know the probability of 9 of those socks being red and 1 of them being blue, we would use a hypergeometric distribution to calculate that.
-This is applied to funnels by considering the total number of users who enter the funnel to be a finite population of size N, out of which a subset of users convert (K). We then estimate the probability of getting k conversions in a particular segment (given that there were n users who entered the funnel in that segment) if users in that particular segment were picked at random from the overall user set. The higher the probability, the higher likelihood that variations we see in conversion rate are due to random chance.
+This is applied to funnels by considering the total number of users who enter the funnel to be a finite population of size N, out of which a subset of users convert (K). We then estimate the probability of getting k conversions in a particular segment (given that there were n users who entered the funnel in that segment) if users in that particular segment were picked at random from the overall user set. The higher the probability, the higher the likelihood that variations we see in conversion rate are due to random chance.
To calculate the actual p-value, we estimate the hypergeometric cumulative distribution function (CDF) for N, K, n.
-
+ 
-In the CDF, the value of any point (X) represents the probability that a random draw would result in fewer conversions P(k < X). 1 - P(k < X) represents the probability that a random draw would result in more conversions P(k >= X).
+In the CDF, the value of any point (X) represents the probability that a random draw would result in fewer conversions, P(k \< X). 1 - P(k \< X) represents the probability that a random draw would result in more conversions, P(k \>= X).
-These two probabilities are used to represent the probability that the selected segment will either outperform (P(k < X)) or underperform (P(k > X)) the overall set of users. Mixpanel takes the higher probability of the two, and calculate the p-value as 1 - max(P(outperform), P(underperform)).
+These two probabilities are used to represent the probability that the selected segment will either outperform (P(k \< X)) or underperform (P(k \> X)) the overall set of users. Mixpanel takes the higher probability of the two and calculates the p-value as 1 - max(P(outperform), P(underperform)).
\ No newline at end of file
diff --git a/docs/reports/funnels/funnels-overview.mdx b/docs/reports/funnels/funnels-overview.mdx
index b4465ad0..44ea1231 100644
--- a/docs/reports/funnels/funnels-overview.mdx
+++ b/docs/reports/funnels/funnels-overview.mdx
@@ -31,10 +31,6 @@ Imagine your product is a B2B messaging application. You might use Funnels to an
- What departments complete the payment funnel most often?
- Why did the successful users purchase?
-{/* Next Section */}
-
-
-
diff --git a/docs/reports/funnels/funnels-quickstart.mdx b/docs/reports/funnels/funnels-quickstart.mdx
index 5d555fe0..73a6718b 100644
--- a/docs/reports/funnels/funnels-quickstart.mdx
+++ b/docs/reports/funnels/funnels-quickstart.mdx
@@ -1,19 +1,13 @@
---
-sidebarTitle: "Quickstart"
title: "Funnels Quickstart"
+sidebarTitle: "Quickstart"
---
import { ExtendedButton } from "/snippets/ExtendedButton/ExtendedButton.jsx";
-
-
+
+
A funnel is a sequence of events done within a defined period of time. A converted user is one who triggers the funnel events, in the specified order, within the defined time period.
@@ -24,10 +18,10 @@ A Funnel Behavior is the basic building block of the Funnels report. A Funnel Be
For example, let's say your signup flow contains five steps. Within the funnel definition, you can add one event for each step, in the following order: “Product Viewed” → “Product Added” → “Checkout Started” → “Purchase Completed”. At this point, your query should look like this.
-
+ 
-You can save the Funnel Behavior you built and reuse them in other reports. Select the "..." button in the top right corner of the metric, then click "Save Behavior". Note that saving a behavior and saving a metric is different; a saved behavior consists of the events/Funnels/Retention, while a saved metrics consists of the saved behavior and the measurements of the behavior.
+You can save the Funnel Behavior you built and reuse it in other reports. Select the "..." button in the top right corner of the metric, then click "Save Behavior". Note that saving a behavior and saving a metric are different; a saved behavior consists of the events/Funnels/Retention, while a saved metric consists of the saved behavior and the measurements of the behavior.
Learn more about [Saved Metrics and Behaviors](/docs/features/saved-metrics-and-behaviors).
@@ -36,14 +30,14 @@ Learn more about [Saved Metrics and Behaviors](/docs/features/saved-metrics-and-
After your Funnel Behavior is defined, you can choose how you want to measure the Funnel. By default, the Funnels report will select the unique conversion rate of the funnel as the measurement.
-**Advanced** - See [Counting Method and Measurements](/docs/reports/funnels/funnels-advanced#counting-methods-and-measurements) section for more information on the measurements.
+ **Advanced** - See [Counting Method and Measurements](/docs/reports/funnels/funnels-advanced#counting-methods-and-measurements) section for more information on the measurements.
-
+ 
-Your Funnel Behavior combined with the measurement forms a Metric. You can save the Funnels Metric you built and reuse them in other reports (such as the Insights report). Select the "..." button in the top right corner of the metric, then click "Save Behavior". Note that saving a behavior and saving a metric is different; a saved behavior consists of the events/Funnels/Retention, while a saved metrics consists of the saved behavior and the measurements of the behavior.
+Your Funnel Behavior combined with the measurement forms a Metric. You can save the Funnels Metric you built and reuse it in other reports (such as the Insights report). Select the "..." button in the top right corner of the metric, then click "Save Behavior". Note that saving a behavior and saving a metric are different; a saved behavior consists of the events/Funnels/Retention, while a saved metric consists of the saved behavior and the measurements of the behavior.
Learn more about [Saved Metrics and Behaviors](/docs/features/saved-metrics-and-behaviors).
@@ -52,11 +46,11 @@ Learn more about [Saved Metrics and Behaviors](/docs/features/saved-metrics-and-
In this case, we only care about events performed on the iOS platform. Therefore, add a “Platform” filter, where Platform equals “iOS Native”. At this point, your query should look like this.
-**Advanced** - See [Filter](/docs/reports/funnels/funnels-advanced#filters) section for more information on the filters.
+ **Advanced** - See [Filter](/docs/reports/funnels/funnels-advanced#filters) section for more information on the filters.
-
+ 
## Step 4: Choose Breakdowns
@@ -64,11 +58,11 @@ In this case, we only care about events performed on the iOS platform. Therefore
Breakdowns segment data into groups. In this case, we want to break our funnel down by marketing medium, tracked via UTM tags. Therefore, you can add a “UTM Medium” breakdown.
-**Advanced** - See [Breakdowns](/docs/reports/funnels/funnels-advanced#breakdowns) section for more information on the breakdowns.
+ **Advanced** - See [Breakdowns](/docs/reports/funnels/funnels-advanced#breakdowns) section for more information on the breakdowns.
-
+ 
## Step 5: Choose Visualization
@@ -81,26 +75,23 @@ You can visualize your metric in a variety of ways. Mixpanel allows you to choos
- Metric - see a summary view of your metric
-
+ 
+{/* Next Section */}
+
+
+
+ Next: Advanced Funnels Concept
+
-{/* Next Section */}
+
+ Explore how funnel metrics are measured and the various configuration options below.
+
+
+
-
-
-
-
- Next: Advanced Funnels Concept
-
-
- Explore how funnel metrics are measured and the various configuration options below.
-
-
-
-
-
+
+
+
\ No newline at end of file
diff --git a/docs/reports/insights.mdx b/docs/reports/insights.mdx
index 45e004b0..63a1e6e7 100644
--- a/docs/reports/insights.mdx
+++ b/docs/reports/insights.mdx
@@ -553,15 +553,20 @@ See this [video walkthrough](https://www.loom.com/share/5568e266532b4804a1c2d36d
Click on a chart segment in Insights and view the raw events that made up that metric. You will be redirected to the Events page.
- 
+
### View Sample Events
-You can hover over any event and in the context panel, you now have the ability to "View Sample Events", which redirects you to the Events page with the 100 most recent samples of that hovered event: You can see a few samples of an event to help you decide whether that's the right event you want for your analysis or which property you should use for filters/breakdowns.
+If you hover over any event and click "View Sample Events" in the context panel, it redirects you to the Events page with the 100 most-recent samples of that hovered event. You can see a few samples of an event to help you decide whether that's the right event you want for your analysis, or which property you should use for filters/breakdowns.
- 
+ 
### Date Range Guardrails
diff --git a/docs/reports/retention.mdx b/docs/reports/retention.mdx
index 3baf3397..4cf3132d 100644
--- a/docs/reports/retention.mdx
+++ b/docs/reports/retention.mdx
@@ -21,7 +21,7 @@ Retention can be accessed from the left-side navigation by clicking the '\+ Crea
Here are some of the sample questions you can answer in Retention:
-- On average, how many users are still active after two weeks from signing up?
+- On average, how many users are still active after two weeks of signing up?
- What percent of all users are still sending messages after seven days?
- How has my 7-day messaging retention changed over time?
- What percent of users sent messages in 2, 3, or 4 distinct hours of the day?
@@ -32,17 +32,17 @@ Here are some of the sample questions you can answer in Retention:
-Building a Retention report follows the same high-level steps as building any other report. You can read about report building basics [here](/docs/reports).
+Building a Retention report follows the same high-level steps as building any other report. You can read about report-building basics [here](/docs/reports).
### Step 1: Define your Retention Behavior
-The Retention Behavior is the basic building block of a Retention report. A Retention Behavior is doing an event and then coming back to do another event. In this case, since we want to know retention after signup, choose "Sign Up Completed" in the first event slot. Then, we want to know if users are coming back and using the product, so choose "Any Event" in the second event slot. At this point, your query should look like this:
+The Retention Behavior is the basic building block of a Retention report. A Retention Behavior is doing an event and then coming back to do another event. In this case, since we want to know retention after signup, choose "Sign Up Completed" in the first event slot. Then, we want to know if users are coming back and using the product, so we choose "Any Event" in the second event slot. At this point, your query should look like this:

-You can save the Retention Behavior you built and reuse it in other reports. Select the "..." button in the top right corner of the metric, then click "Save Behavior". Note that saving a behavior and saving a metric is different; a saved behavior consists of the events/Funnels/Retention, while a saved metric consists of the saved behavior and the measurements of the behavior.
+You can save the Retention Behavior you built and reuse it in other reports. Select the "..." button in the top right corner of the metric, then click "Save Behavior". Note that saving a behavior and saving a metric are different: a saved behavior consists of the events/Funnels/Retention, while a saved metric consists of the saved behavior and the measurements of the behavior.
Learn more about [Saved Metrics and Behaviors](/docs/features/saved-metrics-and-behaviors).
@@ -52,22 +52,20 @@ After your retention behavior is defined, you can choose how you want to measure
There are 4 types of measurement
-- Retention Rate: Percentage of users retained within window
-- Unique Users: Absolute number of users retained within window
-- Property Sum: Total sum of property within a window (eg. total video watch duration)
-- Property Average: Average across users of sum of property within window (eg average watch time per user)
+- Retention Rate: Percentage of users retained within the window.
+- Unique Users: Absolute number of users retained within the window.
+- Property Sum: Total sum of property within a window (eg, total video watch duration).
+- Property Average: Average across users of the sum of properties within the window (e.g., average watch time per user).

-Your Retention Behavior combined with the measurement forms a Metric. You can save the Retention Metric you built and reuse it in other reports (such as the Insights report). Select the "..." button in the top right corner of the metric, then click "Save Behavior". Note that saving a behavior and saving a metric is different; a saved behavior consists of the events/Funnels/Retention, while a saved metric consists of the saved behavior and the measurements of the behavior.
-
-Learn more about [Saved Metrics and Behaviors](/docs/features/saved-metrics-and-behaviors).
+Your Retention Behavior, combined with the measurement, forms a Metric, which you can also save like a Retention Metric.
### Step 3: Choose Filters
-Filters exclude unwanted data. In this case, we only care about events performed on the Chrome browser. Therefore, add a "Browser" filter, where Browser equals "Chrome". At this point, your query should look like this:
+Filters exclude unwanted data. In this case, we only care about events performed on the "Chrome" browser. Therefore, add a "Browser" filter, where Browser equals "Chrome". At this point, your query should look like this:

@@ -75,7 +73,7 @@ Filters exclude unwanted data. In this case, we only care about events performed
### Step 4: Choose Breakdowns
-Breakdowns segment data into groups. In this case, we want to break our report down based on the browser version they are using to Sign Up. Therefore, add an "Browser Version" breakdown. At this point, your query should look like this:
+Breakdowns segment data into groups. In this case, we want to break our report down based on the browser version they are using to Sign Up. Therefore, add a "Browser Version" breakdown. At this point, your query should look like this:

@@ -85,8 +83,8 @@ Breakdowns segment data into groups. In this case, we want to break our report d
You can visualize your metric in a variety of ways. Mixpanel allows you to choose how you would like to visualize your data. Select "Retention Curve" in the top right to change your visualization. In Retention, you can choose:
-- Retention Curve - see how users retain over time. Users are bucketed by when they initially entered the product.
-- Line - see how your metric is trending over time. Used to see a particular retention group rate is trending over time.
+- Retention Curve - see how users are retaining over time. Users are bucketed based on when they initially entered the product.
+- Line - see how your metric is trending over time. Used to see if a particular retention group rate is trending over time.
- Metric - see a summary view of your metric
@@ -107,9 +105,9 @@ The retention curve chart displays retention data as both a line chart and a tab

-**Incomplete Buckets** Boxes with an asterisk (\*) indicate that the data is still in flux and not set yet because the time is still ongoing. Hover over a box to see when the last qualifying date for that bucket will occur.
+**Incomplete Buckets:** Boxes with an asterisk (\*) indicate that the data is still in flux and not set yet because the time is still ongoing. Hover over a box to see when the last qualifying date for that bucket will occur.
-**Color Mapping** Each box within a row is assigned a shade of purple. The shading gets darker the higher the retention percentage. It's important to note that the scale is relative to each cohort row.
+**Color Mapping:** Each box within a row is assigned a shade of purple. The shading gets darker the higher the retention percentage. It's important to note that the scale is relative to each cohort row.
### Line chart
@@ -123,7 +121,7 @@ Select **Line** from the visualization drop-down list to see how your retentio
Retention counts users, not event totals. In other words, each of the user cohort buckets will include every unique user that met the "A event" criteria in that time window, starting at 0:00 of the first day of the bucket and ending at midnight of the last day. A customer can only be counted once per bucket, but can be included in more than one bucket.
-The first column (Date) indicates the day/week/month when the user performed the "A event". The Size column indicates the number of users that performed the "A event" within the time period.
+The first column (Date) indicates the day/week/month when the user performed the "A event". The Size column indicates the number of users who performed the "A event" within the time period.
For example, if you are bucketing based on your "Item Purchased" event and creating weekly buckets, a customer who purchased at least one item each week will be in every bucket, not just the bucket of their first purchase.
@@ -147,27 +145,27 @@ We think "On or After" retention is a better fit for most businesses, and it is
"On" Retention calculates the percentage of users who come back on a specific time unit (e.g., day, week, month).
-After a user completes the “A criteria”, they will belong to a time unit cohort that corresponds with when they did the "A event," and the Retention report will start the clock counting from the time that particular user performed that "A event". When using "On" Retention, that same user must return to fulfill the “came back and did B criteria” on a specific and exact time unit relative to when they did the A criteria to be counted as retained.
+After a user completes the “A criteria”, they will belong to a time unit cohort that corresponds with when they did the "A event", and the Retention report will start the clock counting from the time that particular user performed that "A event". When using "On" Retention, that same user must return to fulfill the “came back and did B criteria” on a specific and exact time unit relative to when they did the A criteria to be counted as retained.
For example, day 5 retention is the percentage of users who “came back and did B” exactly on the fifth day after they did the A event.
-"On" retention is useful to understand high-level usage patterns. We also recommend using "on" retention when your product relies on users returning in each and every time unit.
+"On" retention is useful to understand high-level usage patterns. We also recommend using "on" retention when your product relies on users returning on every time unit.
#### 'On or Before' time interval
-“On or Before” is a retention criteria most commonly used with measurement type of property sum or average. It looks at total activity done during the period between the start and end event
+“On or Before” is a retention criterion most commonly used with a measurement type of property sum or average. It looks at the total activity done during the period between the start and end events.
-For example, if you want to look at 30 Day LTV (Lifetime value) of e-commerce users, you would look at total money spent on purchases from sign-up for 30 Days. This includes looking at revenue spent from Day 0, Day 1 ..to Day 30, where revenue is a property on the event purchase. Similarly, if you want to look at 30-day ARPU (average revenue per user), you would look at averaging the total revenue spent per user within the first 30 days
+For example, if you want to look at the 30-day LTV (lifetime value) of e-commerce users, you would look at the total money spent on purchases from sign-up for 30 Days. This includes looking at revenue spent from Day 0, Day 1, ..., to Day 30, where revenue is a property on the event purchase. Similarly, if you want to look at 30-day ARPU (average revenue per user), you would look at averaging the total revenue spent per user within the first 30 days.
#### 'Streak mode'
“Streak mode” is mostly meant to count unique users doing consecutive actions across time intervals. If the birth event and retention event are the same, the birth event will count towards the streak.
-For example played a game for 5 consecutive days since sign-up, or visited the doctor for 8 consecutive months since registering for a clinic.
+For example, played a game for 5 consecutive days since sign-up, or visited the doctor for 8 consecutive months since registering for a clinic.
#### Advanced Use-Cases
-These use-cases, use a combination of different retention criteria & measurement types
+These use-cases use a combination of different retention criteria & measurement types
@@ -179,7 +177,7 @@ These use-cases, use a combination of different retention criteria & measurement
- What is the average video watch-time for a new subscriber in their first 30 days since subscription? How has this changed over time?
- Retention Criteria: On or Before
- Measurement: Property Average; 30 Days
-- How many new users have a wordle streak for 5 days or 10 days?
+- How many new users have a Wordle streak for 5 days or 10 days?
- Retention Criteria: Streak Mode
- Measurement: Unique Users; 5 days
@@ -191,19 +189,19 @@ Custom bracket retention gives you the flexibility to split up your retention bu
#### Use Cases
-For example, let's answer an important mobile gaming question: How often do my users come back and play a game between 15 and 30 days after sign-up to represent mid-term players?
+For example, let's answer an important mobile gaming question: How often do my users come back and play a game between 15 and 30 days after signing up to represent mid-term players?
-In mobile gaming, industry-standard intervals typically examine retention for users who came back and played a game on Day \< 1, Days 1-3, Days 4-7, Days 8-14, and Day 15-30.
+In mobile gaming, industry-standard intervals typically examine retention for users who came back and play a game on Day \< 1, Days 1-3, Days 4-7, Days 8-14, and Days 15-30.
-Typical "exact day" retention buckets don't quite solve for this use case because users should be able to play a game on any day between Day 15 and 30 and be counted in a single bucket to understand how many users were retained in that entire period. Exact day retention will log users in each individual day bucket (15, 16, 17, ..., 30), which, while more granular, doesn't give a retention percentage for the entire interval. Instead, we want to know how many users played a game at all in any of the days 15-30.
+Typical "exact day" retention buckets don't quite solve for this use case because users should be able to play a game on any day between day 15 and 30 and be counted in a single bucket to understand how many users were retained in that entire period. Exact day retention will log users in each day bucket (15, 16, 17, ..., 30), which, while more granular, doesn't give a retention percentage for the entire interval. Instead, we want to know how many users played a game at all in any of the days 15-30.
-**Free trials:** If you want to understand how many users come back to use the product during a 7-day free trial and also who came back and kept using the product in the 30 days after the free trial is up, you could do something like this:
+**Free trials:** If you want to understand how many users come back to use the product during a 7-day free trial, and also who came back and kept using the product in the 30 days after the free trial is up, you could do something like this:

-**In between cadences:** Are you somewhere in between a DAU or WAU product? You can group daily buckets to understand how your users retain every 3 days (bi-weekly).
+**In between cadences:** Are you somewhere between a DAU or WAU product? You can group daily buckets to understand how your users retain every 3 days (bi-weekly).

@@ -211,19 +209,19 @@ Typical "exact day" retention buckets don't quite solve for this use case becaus
#### Setting Custom Brackets
-First, go into the time unit drop-down in the Retention query builder and select **Custom**
+First, go into the time unit drop-down in the Retention query builder and select **Custom.**

-Then, select the size of each bracket for the given time unit. In this example, we are selecting the number of days that are in each custom bracket. Apply.
+Then, select the size of each bracket for the given time unit and click "Apply". In this example, we are selecting the number of days that are in each custom bracket.

-Each of these intervals is its own retention bucket, and if the user does the "come back and did B" event anytime inside that bucket, they are counted as retained. Now I will be able to understand what percent of users come back to play at least one game in any day between day 15 and day 30 from signing up.
+Each of these intervals is its own retention bucket, and if the user does the "come back and did B" event anytime inside that bucket, they are counted as retained. Now I will be able to understand what percent of users come back to play at least one game on any day between day 15 and day 30 from signing up.
#### Calendar Retention Mode
@@ -233,7 +231,7 @@ You can go into the advanced menu under Retention Criteria to switch the retenti

-This may be useful in scenarios where you want to check engagement on a strict day basis, OR if you want to check retention of your user base for the entire month and when they return, regardless of when in the month they first entered or when in the next month they returned.
+This may be useful in scenarios where you want to check engagement on a strict day basis, OR if you want to check retention of your user base for the entire month, and when they return, regardless of when in the month they first entered or when in the next month they returned.

@@ -241,28 +239,28 @@ This may be useful in scenarios where you want to check engagement on a strict d
In the above example, we're looking at retention on a calendar week basis.
-- In the \< Week 1 bucket, there were 6 users who did "Sign Up" at any point during the week of Dec 23 - Dec 30, and returned to do "Post Content" in that same week of Dec 23 - Dec 30.
-- In the Week 1 bucket, there were 10 users who did "Sign Up" in the same Dec 23 - Dec 30 interval, but returned to do "Post Content" only sometime between Dec 30 - Jan 6.
+- In the \< Week 1 bucket, 6 users did "Sign Up" at any point of the week of Dec 23 - Dec 30, and returned to do "Post Content" in that same week of Dec 23 - Dec 30.
+- In the Week 1 bucket, 10 users did "Sign Up" in the same Dec 23 - Dec 30 interval, but returned to do "Post Content" only sometime between Dec 30 - Jan 6.
##### How is this different than the basic retention mode?
-This [loom video](https://www.loom.com/share/5484c7bdd61a4332818ceef20f475176) should provide an overview of what calendar interval retention is and how it works vs the default rolling window retention
+This [Loom video](https://www.loom.com/share/5484c7bdd61a4332818ceef20f475176) should provide an overview of what calendar interval retention is and how it works vs the default rolling window retention
-**\[Basic\] Rolling interval retention** - Considers time intervals based on user’s time of birth; i.e
+**\[Basic\] Rolling interval retention** - Considers time intervals based on the user’s time of birth; i.e:
- Day 1 retention = 24-48 hrs since person’s birth
- Week 1 retention = 7-14 days since person’s birth
- Month 1 retention = 30-60 days since person’s birth
-**\[Advanced\] Calendar interval retention** - Considers time intervals based on ‘calendar’ time; i.e
+**\[Advanced\] Calendar interval retention** - Considers time intervals based on ‘calendar’ time; i.e:
-- Day 1 retention = next ‘calendar’ day since person’s birth. If a person did an activity at 8pm on Monday and then 6am on Tuesday, the person is counted under Day 1 retention even though it’s just 10 hrs later
-- Week 1 retention = next ‘calendar’ week since person’s birth. If a person did an activity on Friday and then Monday, person is counted under Week 1 retention even though it’s just 3 days, since the ‘calendar’ week changed
+- Day 1 retention = next ‘calendar’ day since person’s birth. If a person did an activity at 8 pm on Monday and then 6 am on Tuesday, the person is counted under Day 1 retention even though it’s just 10 hrs later
+- Week 1 retention = next ‘calendar’ week since person’s birth. If a person did an activity on Friday and then Monday, the person is counted under Week 1 retention even though it’s just 3 days, since the ‘calendar’ week changed
- Month 1 retention = next ‘calendar’ month since person’s birth. Similarly, if a person made a purchase on 25th Feb and then again on 3rd March, the person will be counted under Month 1 retention metrics
-NOTE — All the above cases would NOT qualify under Day 1 or Week 1 or Month 1 rolling interval retention
+NOTE — All the above cases would NOT qualify under Day 1, Week 1, or Month 1 rolling interval retention.
-**When should you use the calendar vs rolling interval retention mode? **
+**When should you use the calendar vs rolling interval retention mode?**
Both modes are extremely useful. It totally depends on the use-case you’re trying to answer. Some examples -
@@ -271,17 +269,16 @@ Both modes are extremely useful. It totally depends on the use-case you’re try
| Day 1 retention for apps focused on “daily engagement” like music, meditation, or workout apps | Calendar-interval |
| How many users come back after month 1 (30 days)? How many come back after 3 months (90 days)? | Rolling-interval |
| Understanding the effect of a marketing promotion, how many people came back the week after the promotion ended? | Calendar-interval |
-| What’s Mixpanel's quarterly revenue retention? How was gross and net retention in Q4 vs Q3? | Calendar-interval |
-| How many users renewed their Netflix subscription? To note, renewals happen 30 days after last payment | Rolling-interval |
+| What’s Mixpanel's quarterly revenue retention? How were gross and net retention in Q4 vs Q3? | Calendar-interval |
+| How many users renewed their Netflix subscription? To note, renewals happen 30 days after the last payment | Rolling-interval |
-As stated above, the general expectation is that product use-cases which focus on user stickiness are likely to use rolling interval mode. Marketing & Revenue teams which focus on calendar dates for their activities are likely to use calendar interval mode.
+Above said, the general expectation is that product use-cases which focus on user stickiness are likely to use rolling interval mode. Marketing & Revenue teams that focus on calendar dates for their activities are likely to use the calendar interval model.
### Saved Retention Behaviors
-You can save the Funnel Behavior you built and reuse it in other reports. This can be helpful when there is a sequence of events that you frequently analyze (such as sign up flow), or if you want to analyze your Funnel Behavior alongside other metrics in an Insights report.
-
-Select the "..." button in the top right corner of the metric, then click "Save Behavior". Note that saving a behavior and saving a metric is different; a saved behavior consists of the events/Funnels/Retention, while a saved metric consists of the saved behavior and the measurements of the behavior.
+You can save the Funnel Behavior you built and reuse it in other reports. This can be helpful when there is a sequence of events that you frequently analyze (such as sign-up flow), or if you want to analyze your Funnels Behavior alongside other metrics in an Insights report.
+Select the "..." button in the top right corner of the metric, then click "Save Behavior".\
Learn more about [Saved Metrics and Behaviors](/docs/features/saved-metrics-and-behaviors).
### Frequency View
@@ -292,7 +289,7 @@ Learn more about [Saved Metrics and Behaviors](/docs/features/saved-metrics-and-
You can use the Frequency report to learn how frequently users return to use your product or service.
-To generate Frequency reports, click **Reports**, **Retention,** and select the **Frequency** option under the toggle for retention.
+To generate Frequency reports, click **Reports**, **Retention**, and select the **Frequency** option under the toggle for retention.

@@ -300,7 +297,7 @@ To generate Frequency reports, click **Reports**, **Retention,** and select t
Mixpanel groups unique users in time-incremented buckets when they first complete an action, and then groups those same users in subsequent buckets when they return and perform the same or different actions.
-The buckets measure the number of unique time buckets in which a user was active. Depending on the interval chosen, this will one of:
+The buckets measure the number of unique time buckets in which a user was active. Depending on the interval chosen, this will be one of:
- unique hours in a day
- unique days in a week
@@ -324,13 +321,13 @@ Currently, when using "Day" retention, Retention reports are limited to 60 days.
When you create an unsegmented retention query (i.e., a retention query that is not segmented by a property or cohort), Mixpanel will automatically intervalize the retention calculation.
-In other words, we will calculate the retention of each and every cohort based upon the selected birth interval unit (day/week/month cadence that the user performed the A action) and then summarize it into one line by taking the average of all complete buckets. You can see the retention of each individual interval by expanding the Average Retention column:
+In other words, we will calculate the retention of each and every cohort based upon the selected birth interval unit (day/week/month cadence that the user performed the A action) and then summarize it into one line by taking the average of all complete buckets. You can see the retention of each interval by expanding the Average Retention column:

-Segmented queries are now calculated with that same intervalized average method, but for each particular property value or cohort segment. You can now expand out any particular segment's name in a retention query to see the retention of each day, week, or month interval within that segment:
+Segmented queries are now calculated with that same intervalized average method, but for each particular property value or cohort segment. You can now expand any particular segment's name in a retention query to see the retention of each day, week, or month interval within that segment:

@@ -338,7 +335,7 @@ Segmented queries are now calculated with that same intervalized average method,
Intervalized averages to segmented retention queries have two key advantages:
-1. **Not including users in incomplete periods:** The non-intervalized method did not give all users an equal chance to qualify for the later retention buckets. Newer, more recent users who come into the query towards the end of your date range would not have enough time pass to have the opportunity to be retained in the later date buckets. This would sandbag the last retention buckets in your query. With intervalized retention, Mixpanel only counts the completed time periods into the Average Retention calculation so that all users have the same opportunity to be retained.
+1. **Not including users in incomplete periods:** The non-intervalized method did not give all users an equal chance to qualify for the later retention buckets. Newer, more recent users to come into the query towards the end of your date range would not have enough time to pass to have the opportunity to be retained in the later date buckets. This would sandbag the last retention buckets in your query. With intervalized retention, Mixpanel only counts the completed time periods into the Average Retention calculation so that all users have the same opportunity to be retained.
2. **More granular analysis:** Users are now able to see how the individual birth interval cohorts are performing within a particular segment. This unlocks the ability to get more answers and dive deeper into particular cohorts of interest.
### How is the "Average" row for Retention reports calculated?
@@ -351,9 +348,9 @@ Mixpanel calculates the "Average" row values by taking the average of all the co
| March 2 | 500 | 400 |
| March 3 | 700 | 10 (incomplete) |
-From our sample data, the average value for day 1 retained users is calculated as follows:
+From our sample data, the average value for day-1 retained users is calculated as follows:
-#### When examining a Retention report in % / Retention Rate view:
+#### When examining a Retention report in the % / Retention Rate view:
C\_March 1 = 500 (count retained for March 1)
@@ -371,7 +368,7 @@ P\_March 2 = 500 (total profiles for March 2)
In our sample data, this computes to: ( 500 \* 0.66 ) \+ ( 400 \* 0.33 ) = 466.66
-Next, we have to get the weighted average of the total profiles that were eligible for being retained
+Next, we have to get the weighted average of the total profiles that were eligible for being retained.
\*\*Weighted Average of Total Users = P\_March 1 \* W\_March 1 \+ P\_March 2 \* W\_March 2
@@ -399,4 +396,4 @@ In our sample data, this computes to:(500 \* (1000 / 1500)) \+ (400 \* (500 / 15
### What does the Metric view in the Retention Trends report show?
-The Metric view in the Retention Trends Report shows the **_overall value_** for the retention trend for that time period. There is a `Cohortize` option under the `Advanced` menu that, when enabled will show the **_weighted average bucket_** for that retention trend.
+The Metric view in the Retention Trends Report shows the **_overall value_** for the retention trend for that time period. There is a `Cohortize` option under the `Advanced` menu that, when enabled, will show the **_weighted average bucket_** for that retention trend.
\ No newline at end of file
diff --git a/images/applications_impact.png b/images/applications_impact.png
new file mode 100644
index 00000000..078ac71f
Binary files /dev/null and b/images/applications_impact.png differ
diff --git a/images/date_picker_fixed.png b/images/date_picker_fixed.png
new file mode 100644
index 00000000..52cc7272
Binary files /dev/null and b/images/date_picker_fixed.png differ
diff --git a/images/date_picker_fixed_time_ranges.png b/images/date_picker_fixed_time_ranges.png
new file mode 100644
index 00000000..93569091
Binary files /dev/null and b/images/date_picker_fixed_time_ranges.png differ
diff --git a/images/date_picker_last.png b/images/date_picker_last.png
new file mode 100644
index 00000000..a12b4207
Binary files /dev/null and b/images/date_picker_last.png differ
diff --git a/images/date_picker_last_rolling_window.png b/images/date_picker_last_rolling_window.png
new file mode 100644
index 00000000..2db9da47
Binary files /dev/null and b/images/date_picker_last_rolling_window.png differ
diff --git a/images/date_picker_period_to_date.png b/images/date_picker_period_to_date.png
new file mode 100644
index 00000000..1aa77a56
Binary files /dev/null and b/images/date_picker_period_to_date.png differ
diff --git a/images/date_picker_previous_period.png b/images/date_picker_previous_period.png
new file mode 100644
index 00000000..94d8cf4b
Binary files /dev/null and b/images/date_picker_previous_period.png differ
diff --git a/images/date_picker_recently_applied.png b/images/date_picker_recently_applied.png
new file mode 100644
index 00000000..979c2ae1
Binary files /dev/null and b/images/date_picker_recently_applied.png differ
diff --git a/images/date_picker_since.png b/images/date_picker_since.png
new file mode 100644
index 00000000..7ce9e909
Binary files /dev/null and b/images/date_picker_since.png differ
diff --git a/images/event_options.png b/images/event_options.png
new file mode 100644
index 00000000..d46b9acb
Binary files /dev/null and b/images/event_options.png differ
diff --git a/images/flows_breakdown_cohort.png b/images/flows_breakdown_cohort.png
new file mode 100644
index 00000000..7584b2e4
Binary files /dev/null and b/images/flows_breakdown_cohort.png differ
diff --git a/images/flows_expand_event_property.gif b/images/flows_expand_event_property.gif
new file mode 100644
index 00000000..dca057bb
Binary files /dev/null and b/images/flows_expand_event_property.gif differ
diff --git a/images/flows_expand_event_property2.gif b/images/flows_expand_event_property2.gif
new file mode 100644
index 00000000..af9d0ffc
Binary files /dev/null and b/images/flows_expand_event_property2.gif differ
diff --git a/images/impact2.png b/images/impact2.png
new file mode 100644
index 00000000..080731fb
Binary files /dev/null and b/images/impact2.png differ
diff --git a/images/impact3.png b/images/impact3.png
new file mode 100644
index 00000000..d1d26f0f
Binary files /dev/null and b/images/impact3.png differ
diff --git a/images/impact_add_event.png b/images/impact_add_event.png
new file mode 100644
index 00000000..bb736bb3
Binary files /dev/null and b/images/impact_add_event.png differ
diff --git a/images/impact_add_filters.png b/images/impact_add_filters.png
new file mode 100644
index 00000000..b68283bb
Binary files /dev/null and b/images/impact_add_filters.png differ
diff --git a/images/impact_add_impacted_event.png b/images/impact_add_impacted_event.png
new file mode 100644
index 00000000..181578d1
Binary files /dev/null and b/images/impact_add_impacted_event.png differ
diff --git a/images/impact_aggregate_event.png b/images/impact_aggregate_event.png
new file mode 100644
index 00000000..521c351d
Binary files /dev/null and b/images/impact_aggregate_event.png differ
diff --git a/images/impact_causal_report.png b/images/impact_causal_report.png
new file mode 100644
index 00000000..fe9301b3
Binary files /dev/null and b/images/impact_causal_report.png differ
diff --git a/images/impact_correlation_events.png b/images/impact_correlation_events.png
new file mode 100644
index 00000000..03e077a1
Binary files /dev/null and b/images/impact_correlation_events.png differ
diff --git a/images/impact_date_range_picker.png b/images/impact_date_range_picker.png
new file mode 100644
index 00000000..5eeac0a5
Binary files /dev/null and b/images/impact_date_range_picker.png differ
diff --git a/images/impact_impact_chart.png b/images/impact_impact_chart.png
new file mode 100644
index 00000000..374b3148
Binary files /dev/null and b/images/impact_impact_chart.png differ
diff --git a/images/impact_impact_trends_graph.png b/images/impact_impact_trends_graph.png
new file mode 100644
index 00000000..4425fb4f
Binary files /dev/null and b/images/impact_impact_trends_graph.png differ
diff --git a/images/impact_user_definition.png b/images/impact_user_definition.png
new file mode 100644
index 00000000..52642800
Binary files /dev/null and b/images/impact_user_definition.png differ
diff --git a/images/new_date_range.png b/images/new_date_range.png
new file mode 100644
index 00000000..a406306c
Binary files /dev/null and b/images/new_date_range.png differ
diff --git a/images/reports_query_time_sampling.png b/images/reports_query_time_sampling.png
new file mode 100644
index 00000000..95dcb206
Binary files /dev/null and b/images/reports_query_time_sampling.png differ
diff --git a/images/reports_save_to_board.png b/images/reports_save_to_board.png
new file mode 100644
index 00000000..af6cdda1
Binary files /dev/null and b/images/reports_save_to_board.png differ
diff --git a/images/reports_view_events.gif b/images/reports_view_events.gif
new file mode 100644
index 00000000..429c546e
Binary files /dev/null and b/images/reports_view_events.gif differ
diff --git a/images/reports_view_sample_events.gif b/images/reports_view_sample_events.gif
new file mode 100644
index 00000000..787a614c
Binary files /dev/null and b/images/reports_view_sample_events.gif differ
diff --git a/images/reports_view_users.gif b/images/reports_view_users.gif
new file mode 100644
index 00000000..86583fa6
Binary files /dev/null and b/images/reports_view_users.gif differ
diff --git a/images/signal.png b/images/signal.png
new file mode 100644
index 00000000..8ce14ad4
Binary files /dev/null and b/images/signal.png differ
diff --git a/images/signal_access.png b/images/signal_access.png
new file mode 100644
index 00000000..40d2f319
Binary files /dev/null and b/images/signal_access.png differ
diff --git a/images/signal_query_builder.png b/images/signal_query_builder.png
new file mode 100644
index 00000000..ce3c8f44
Binary files /dev/null and b/images/signal_query_builder.png differ
diff --git a/insights_properties_section.png b/insights_properties_section.png
new file mode 100644
index 00000000..b291e641
Binary files /dev/null and b/insights_properties_section.png differ