Skip to content

Commit 830ad59

Browse files
authored
Removing incorrect information in the tel doc (microsoft#8446)
* Removing incorrect information in the tel doc * Bit discriptive about cookie
1 parent ba3f4ed commit 830ad59

File tree

1 file changed

+8
-38
lines changed

1 file changed

+8
-38
lines changed

docs/telemetry.md

Lines changed: 8 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -8,10 +8,9 @@ Microsoft MakeCode uses the [Application Insights Javascript SDK](https://github
88

99
There are two types of cookies stored by Microsoft MakeCode.
1010

11-
- Language selection cookie. This is used to persist the language selection by user across sessions (Examples: English, French or German).
12-
- Application Insight cookie for user tracking. This is used to correlate the data across sessions.
13-
14-
There's no authentication in MakeCode and it doesn't perform any authenticated user tracking or use cookies to identify authenticated users.
11+
- Language selection cookie (PXT_LANG). This is used to persist the language selection by user across sessions (Examples: English, French or German).
12+
- Application Insight cookie (ai_user & ai_session) for user behavior tracking. This is used to correlate the data across sessions. No PII information is collected.
13+
- Identity cookie (x-mkcd-auth-token) if you log into our website where it is supported.
1514

1615
## Application Insights SDK Telemetry
1716

@@ -29,36 +28,20 @@ The following sections contain the information that the Application Insights SDK
2928

3029
#### Device telemetry
3130

32-
The device (workstation, laptop, mobile device, etc.) the website is running on.
31+
This is always set to "Browser" for the web
3332

3433
Property | Description
3534
---|---
36-
`device.type` | Type of device
37-
`device.id` | unique ID
38-
`device.oemName` |
39-
`device.model` |
40-
`device.network` | number - IANA interface type
41-
`device.resolution` | screen resolution
42-
`device.locale` | display language of the OS
43-
`device.ip` | last 8 bits zeroed out to anonymise
44-
`device.language` |
45-
`device.os` | OS running on the device
46-
`device.osversion` |
35+
`device.type` | "browser"
36+
`device.id` | "Browser"
4737

4838
#### User telemetry
4939

50-
Data about the current user. Users are identified by a cookie, so a single person can look like
51-
more than one user in the telemetry if they use different machines or browsers, or delete cookies.
40+
Data about the current user. Users are identified by a cookie. This cookie is a randomnly generated hash by the application insights. A single user will get a new hash\cookie, every time the browser cache is cleared or a different browser is used on the same machine. A single person can look like more than one user in the telemetry, if they use different machines or browsers, or delete cookies.
5241

5342
Property | Description
5443
---|---
5544
`user.id` | Unique, cookie-based user id, automatically assigned.
56-
`user.authenticatedId` | Not used by Microsoft MakeCode
57-
`user.accountId` | Not used by Microsoft MakeCode
58-
`user.accountAcquisitionDate` |
59-
`user.agent` |
60-
`user.storeRegion` |
61-
6245

6346
#### User Session telemetry
6447

@@ -71,16 +54,6 @@ Property | Description
7154
---|---
7255
`session.id` | Automatically assigned id
7356
`session.isFirst` | Boolean. True if this is the first session for this user.
74-
`session.acquisitionDate` | Number. The dateTime when this session was created.
75-
`session.renewalDate` | Number. DateTime when telemetry was last sent with this session.
76-
77-
#### Location telemetry
78-
79-
The estimated geographical location of the user's device. The last 8 bits of IP address are sanitized to zero by Application insights.
80-
81-
Property | Description
82-
---|---
83-
`location.ip` | IP address
8457

8558
#### Operation telemetry
8659

@@ -89,10 +62,7 @@ Represents the user request. The operation id is used to correlate related event
8962
Property | Description
9063
---|---
9164
`id` | Unique id
92-
`name` |
93-
`parentId` |
94-
`rootId` |
95-
`syntheticSource` | String identifying the bot or test agent.
65+
`name` | String
9666

9767
<br/>
9868
**Note:** Refer to the [Application Insights SDK API Reference](https://github.com/microsoft/ApplicationInsights-JS/blob/master/API-reference.md) documentation for further details.

0 commit comments

Comments
 (0)