You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* Add dead click docs
* Add dead click docs
* Add dead click docs
* Update autocapture.mdx
putting them side by side
---------
Co-authored-by: djmixpanel <[email protected]>
Copy file name to clipboardExpand all lines: pages/docs/session-replay.mdx
+7-7Lines changed: 7 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -31,12 +31,12 @@ See our developer guides on implementing Session Replay for these platforms belo
31
31
## Watching Replays
32
32
33
33
<Callouttype="info">
34
-
By default, replays are stored for 30 days after the time of ingestion. Once a replay is expired, there is no way to view that replay. Enterprise plan customers with the paid session replay add-on can customize this retention period between 7 days and 360 days. For more information, reach out to your Account Manager or our sales team.
34
+
By default, replays are stored for 30 days after the time of ingestion. Once a replay is expired, there is no way to view that replay. Enterprise plan customers with the paid session replay add-on can customize this retention period between 7 days and 360 days. For more information, reach out to your Account Manager or our sales team.
35
35
</Callout>
36
36
37
-
Session Replay is particularly valuable for understanding user frustration and identifying problematic user experiences. To find relevant replays, you can focus on interesting users (power users, purchases), interesting trends (KPIs spikes or dips), or replays where certain events or sentiment signals (like [rage clicks](/docs/tracking-methods/autocapture#rage-clicks)) occur.
37
+
Session Replay is particularly valuable for understanding user frustration and identifying problematic user experiences. To find relevant replays, you can focus on interesting users (power users, purchases), interesting trends (KPIs spikes or dips), or replays where certain events or sentiment signals (like [dead clicks](/docs/tracking-methods/autocapture#dead-clicks)/[rage clicks](/docs/tracking-methods/autocapture#rage-clicks)) occur.
38
38
39
-
To start using Session Replay, select **Session Replay** from the side navigation in your Mixpanel project. Here, you'll see your most recent replays and can easily filter them by events, properties, or custom time ranges to focus on the replays that matter most to you. Pro tip: when getting started with implementing Session Replay, you can use this view to check if replays are coming in as expected.
39
+
To start using Session Replay, select **Session Replay** from the side navigation in your Mixpanel project. Here, you'll see your most recent replays and can easily filter them by events, properties, or custom time ranges to focus on the replays that matter most to you. Pro tip: when getting started with implementing Session Replay, you can use this view to check if replays are coming in as expected.
40
40
41
41
what makes Mixpanel Session Replay special is that it can be used seamlessly with your existing Mixpanel workflows, like:
42
42
@@ -49,7 +49,7 @@ what makes Mixpanel Session Replay special is that it can be used seamlessly wit
49
49
Reports entry point is currently supported for Event, Funnel, and User Profile metrics only.
50
50
</Callout>
51
51
52
-
Click any point on a chart for Event, Funnel, and User Profile, and select "View Replays" to view replays that show that event being fired. From here, you will be taken to our Replay Player.
52
+
Click any point on a chart for Event, Funnel, and User Profile, and select "View Replays" to view replays that show that event being fired. From here, you will be taken to our Replay Player.
53
53
54
54

55
55
@@ -77,7 +77,7 @@ The Replay Feed on the left of the player also allows you to:
77
77
- Sort replays by recency, activity, or duration
78
78
- Search for replays by user's name / email, replay date, user ID, or the name of an event in the replay
79
79
- See a feed of events that occurred during each replay
80
-
- Display properties and their values within the event feed
80
+
- Display properties and their values within the event feed
81
81
82
82
## Best Practices
83
83
@@ -146,7 +146,7 @@ Replays are available for viewing in Mixpanel ~1 minute after the recording is c
146
146
147
147
#### How long are replays stored?
148
148
149
-
By default, replays are stored for 30 days after the time of ingestion. Once a replay is expired, there is no way to view that replay. Enterprise plan customers with the paid session replay add-on can customize this retention period between 7 days and 360 days. For more information, reach out to your Account Manager or our sales team.
149
+
By default, replays are stored for 30 days after the time of ingestion. Once a replay is expired, there is no way to view that replay. Enterprise plan customers with the paid session replay add-on can customize this retention period between 7 days and 360 days. For more information, reach out to your Account Manager or our sales team.
150
150
151
151
#### Why does it say the player failed to load?
152
152
@@ -164,7 +164,7 @@ You will not see the "View Replays" button if your organization is on an older p
164
164
165
165
#### Can I use Session Replay with a CDP?
166
166
167
-
You can use Session Replay with CDPs (e.g., Segment and mParticle) on both web and mobile.
167
+
You can use Session Replay with CDPs (e.g., Segment and mParticle) on both web and mobile.
Copy file name to clipboardExpand all lines: pages/docs/tracking-methods/autocapture.mdx
+9-2Lines changed: 9 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -25,14 +25,21 @@ By default, Autocapture will automatically collect the following predefined even
25
25
- Form interactions (e.g., form submitted)
26
26
- Element interactions, including clicks and changes on page elements
27
27
- Attribution
28
+
- Dead clicks
28
29
- Rage clicks
29
30
30
31
When you enable Autocapture, you will start collecting these predefined events and property types, and they will appear for your use in analysis in your Mixpanel instance. Within your Mixpanel instance, these events will be displayed using preset labels such as “[Auto] Page View” and “[Auto] Element Click”.
31
32
32
33
Autocapture events will all be tracked as events that start with `$mp_` and will start with [Auto] as a prefix in Mixpanel, so if used in combination with other tracking and ingestion methods, you will be able to tell the difference.
33
34
35
+
### Dead Clicks
36
+
37
+
A dead click is when a user clicks an interactive element but the click produces no visible response within a certain timeframe. Dead clicks often indicate broken functionality, unresponsive UI elements, or poor user experience. Dead clicks are tracked as `[Auto] Dead Click` events.
38
+
39
+
By default, Mixpanel considers a click on an interactive element to be a dead click if there are no responses withing 0.5 seconds. You can configure these qualifying criteria to something that best suits your application by overriding the defaults in the [Javascript SDK](/docs/tracking-methods/sdks/javascript).
40
+
34
41
### Rage Clicks
35
-
A rage click is when a user clicks on the same spot on your webpage in quick succession. It happens because the user expects something to happen, but nothing does — so they click again and again, showing they are frustrated. Rage clicks are tracked as `[Auto] Rage Click` events.
42
+
A rage click is when a user clicks on the same spot on your webpage in quick succession. It happens because the user expects something to happen, but nothing does — so they click again and again, showing they are frustrated. Rage clicks are tracked as `[Auto] Rage Click` events.
36
43
37
44
By default, Mixpanel considers 4 clicks within a second and between 30 pixels apart as a rage click. You can configure these qualifying criteria to something that best suits your application by overriding the defaults in the [Javascript SDK](/docs/tracking-methods/sdks/javascript).
38
45
@@ -66,7 +73,7 @@ At any time, you can change your configuration to only capture clicks on specifi
66
73
## Privacy and security
67
74
The default configuration of Autocapture is designed to strike a balance between automatically capturing meaningful events while excluding potentially sensitive data. At the same time, the technical design of your website, your industry, the purpose of your website, and compliance requirements across jurisdictions can vary greatly. As a result, your close review of the data derived from Autocapture is always recommended. **Because there is no one-size-fits-all approach to event analytics, it's our customers' responsibility to ensure the configuration of Mixpanel on their website complies with applicable data privacy laws and regulations and their Mixpanel's Services Agreement.**
68
75
69
-
In certain contexts, a flexible configuration of Autocapture or turning off Autocapture may be appropriate to enable your company's privacy and compliance requirements. **In particular, if the purpose of your website involves the capture of highly sensitive data like Protected Health Information (PHI), we do not recommend using Autocapture. If you have entered into a BAA (Business Associate Agreement) with Mixpanel, we do not recommend using Autocapture.**
76
+
In certain contexts, a flexible configuration of Autocapture or turning off Autocapture may be appropriate to enable your company's privacy and compliance requirements. **In particular, if the purpose of your website involves the capture of highly sensitive data like Protected Health Information (PHI), we do not recommend using Autocapture. If you have entered into a BAA (Business Associate Agreement) with Mixpanel, we do not recommend using Autocapture.**
70
77
71
78
As an analytics provider, Mixpanel is committed to designing features to facilitate data privacy for our customers and their end-users. While it's our customers' responsibility to ensure use of Mixpanel complies with data privacy law, we offer a privacy-first approach to autocapture, including default omission of input elements, designed to help you complete data minimization and comply with data privacy law. We’ve additionally provided you with the following tools and resources to help you adhere to applicable data privacy legislation.
Note that disabling Autocapture does not disable Session Replay, which is [configured separately](/docs/tracking-methods/sdks/javascript#session-replay).
177
178
178
179
**Autocapture Init Options**
179
-
| Option | Description | Default |
180
+
| Option | Description | Default |
180
181
| --- | --- | --- |
181
182
|`click`| When set to `true`, Mixpanel will track element clicks. It will not track textContent unless `capture_text_content` is also set to `true`. |`true`|
182
-
| `rage_click` | When set to `true`, Mixpanel will track rage clicks on elements. You can also fine tune thresholds for classifying rage clicks as follows `{threshold_px: $number, timeout_ms: $number, click_count: $number}`. Each attribute is optional such that it reverts back to a value that is most optimal. | `true`
183
+
| `dead_click` | When set to `true`, Mixpanel will track dead clicks on elements. You can also fine tune thresholds for classifying dead clicks as follows `{timeout_ms: $number}`. Each attribute is optional such that it reverts back to a value that is most optimal. | `true`
184
+
| `rage_click` | When set to `true`, Mixpanel will track rage clicks on elements. You can also fine tune thresholds for classifying rage clicks as follows `{threshold_px: $number, timeout_ms: $number, click_count: $number}`. Each attribute is optional such that it reverts back to a value that is most optimal. | `true`
183
185
|`input`| When set to `true`, Mixpanel will track when an input is provided. It will not capture input content. |`true`|
184
186
|`pageview`| When set, Mixpanel will collect pageviews when some components of the URL change — including UTM parameters. |`"full-url"`|
185
187
|`scroll`| When set, Mixpanel will collect page scrolls at specified scroll intervals. |`true`|
@@ -396,7 +398,7 @@ The Javascript SDK is a tracking SDK designed for real-time tracking in a client
396
398
For bulk import of historical events older than 5 days, we will need to use the [/import API endpoint](https://developer.mixpanel.com/reference/import-events) which is optimized for scripting and supports ingesting historical data. We recommend the [Python SDK](/docs/tracking-methods/sdks/python) (see the [`.import_data()`](https://mixpanel.github.io/mixpanel-python/#primary-interface) function) and [mixpanel-utils module](https://github.com/mixpanel/mixpanel-utils) (see the [`import_events()`](https://github.com/mixpanel/mixpanel-utils?tab=readme-ov-file#import-events) function) which both leverages the /import API for event ingestion.
397
399
398
400
## Setting Super Properties
399
-
Super properties are global event properties that you define once and apply to all events.
401
+
Super properties are global event properties that you define once and apply to all events.
400
402
401
403
To register super properties, call [`.register()`](https://github.com/mixpanel/mixpanel-js/blob/master/doc/readme.io/javascript-full-api-reference.md#mixpanelregister).
402
404
@@ -456,7 +458,7 @@ mixpanel.identify('12345');
456
458
```
457
459
458
460
### Call Reset at Logout
459
-
Call [`.reset()`](https://github.com/mixpanel/mixpanel-js/blob/master/doc/readme.io/javascript-full-api-reference.md#mixpanelreset) to clear data attributed to a user when they logout. This will clear the cookie/local storage and allows you to handle [multiple users on a single device](/docs/tracking-methods/id-management/identifying-users-simplified#multiple-users-one-device).
461
+
Call [`.reset()`](https://github.com/mixpanel/mixpanel-js/blob/master/doc/readme.io/javascript-full-api-reference.md#mixpanelreset) to clear data attributed to a user when they logout. This will clear the cookie/local storage and allows you to handle [multiple users on a single device](/docs/tracking-methods/id-management/identifying-users-simplified#multiple-users-one-device).
460
462
461
463
**Example Usage**
462
464
@@ -588,7 +590,7 @@ A few commonly used people methods are highlighted below:
588
590
589
591
// increment "age" by 2
590
592
mixpanel.people.increment('age',2);
591
-
593
+
592
594
// use negative number to decrement
593
595
// decrement "age" by 5
594
596
mixpanel.people.increment('age',-5);
@@ -613,7 +615,7 @@ The Javascript SDK provides a few method for adding individual users to a group
613
615
### Adding Users to a Group
614
616
[All events must have the group key as an event property in order to be attributed to a group](/docs/data-structure/group-analytics#group-keys-tracked-as-event-properties). Without the group key, an event cannot be attributed to a group.
615
617
616
-
Call the [`.set_group()`](https://github.com/mixpanel/mixpanel-js/blob/master/doc/readme.io/javascript-full-api-reference.md#mixpanelset_group) method to register the current user to a group, which would add the `group_key` as an event property set to the `group_id` value to all events moving forward.
618
+
Call the [`.set_group()`](https://github.com/mixpanel/mixpanel-js/blob/master/doc/readme.io/javascript-full-api-reference.md#mixpanelset_group) method to register the current user to a group, which would add the `group_key` as an event property set to the `group_id` value to all events moving forward.
617
619
618
620
Alternatively, you can manually add the group key property to be more selective about which events to attribute to a group.
0 commit comments