iceraven-browser/docs/telemetry.md

# Telemetry

Fenix uses Mozilla's telemetry service (Glean) and LeanPlum to measure feature performance and engagement.

## Baseline ping

Fenix creates and tries to send a "baseline" ping when the app goes to the background. This baseline ping is defined by the [Glean](https://github.com/mozilla-mobile/android-components/blob/master/components/service/glean/docs/pings/pings.md) component and [documented in the Android Components repository](https://github.com/mozilla-mobile/android-components/blob/master/components/service/glean/docs/pings/baseline.md).

## Metrics ping

Fenix creates and tries to send a "baseline" ping. It is defined inside the [`metrics.yaml`](https://github.com/mozilla-mobile/fenix/blob/master/app/metrics.yaml) file. This ping includes things like whether or not Fenix is currently the default browser.

## Events

Fenix sends event pings that allows us to measure feature performance. These are defined inside the [`metrics.yaml`](https://github.com/mozilla-mobile/fenix/blob/master/app/metrics.yaml) file.

## Activation

Fenix sends an activation ping once, at startup. Further documentation can be found in the [`activation` ping](activation.md) docs.

## Leanplum
See [here](https://github.com/mozilla-mobile/fenix/blob/master/docs/mma.md) for details on Leanplum usage in Firefox Preview.

## Crash reporting
See [here](https://github.com/mozilla-mobile/fenix/blob/master/docs/crash-reporting.md) for details on crash reporting in Firefox Preview.
Closes #263: Integrate service-glean component. 2019-01-31 16:27:36 +00:00			`# Telemetry`

For #865 - Documents the OpenedApp event 2019-03-12 23:06:36 +00:00			`Fenix uses Mozilla's telemetry service (Glean) and LeanPlum to measure feature performance and engagement.`
Closes #263: Integrate service-glean component. 2019-01-31 16:27:36 +00:00
			`## Baseline ping`

Fixes #983 - Changes broken link 2019-04-03 22:49:19 +00:00			`Fenix creates and tries to send a "baseline" ping when the app goes to the background. This baseline ping is defined by the [Glean](https://github.com/mozilla-mobile/android-components/blob/master/components/service/glean/docs/pings/pings.md) component and [documented in the Android Components repository](https://github.com/mozilla-mobile/android-components/blob/master/components/service/glean/docs/pings/baseline.md).`
Documents new telemetry events 2019-03-19 21:58:49 +00:00
			`## Metrics ping`

Update telemetry.md Corrected "Whether" 2019-06-21 18:31:50 +00:00			Fenix creates and tries to send a "baseline" ping. It is defined inside the [`metrics.yaml`](https://github.com/mozilla-mobile/fenix/blob/master/app/metrics.yaml) file. This ping includes things like whether or not Fenix is currently the default browser.
For #865 - Documents the OpenedApp event 2019-03-12 23:06:36 +00:00
			`## Events`

Addresses metrics nits 2019-03-22 06:05:28 +00:00			Fenix sends event pings that allows us to measure feature performance. These are defined inside the [`metrics.yaml`](https://github.com/mozilla-mobile/fenix/blob/master/app/metrics.yaml) file.

Generate the `activation` ping and send it with Glean (#1707) This fetches the Google Advertising ID, salts it and then applies hashing before sending a ping with it, at startup. Hashing and salting are used in order to prevent ourselves to correlate advertising IDs from the same user running different products we own off a single device. We will never send the client_id and the Google Advertising ID in the same ping. 2019-05-03 14:40:22 +00:00			`## Activation`

			Fenix sends an activation ping once, at startup. Further documentation can be found in the [`activation` ping](activation.md) docs.

For #981 - Adds link to mma.md to telemetry.md 2019-06-14 19:22:03 +00:00			`## Leanplum`
Update telemetry.md Corrected "Whether" 2019-06-21 18:31:50 +00:00			`See [here](https://github.com/mozilla-mobile/fenix/blob/master/docs/mma.md) for details on Leanplum usage in Firefox Preview.`
For #235 - Add crash-reporting.md, and port over Sentry docs. 2019-09-24 01:31:02 +00:00
			`## Crash reporting`
			`See [here](https://github.com/mozilla-mobile/fenix/blob/master/docs/crash-reporting.md) for details on crash reporting in Firefox Preview.`