From 6f561f7c5892ce0883d64363b2766c59485d43a9 Mon Sep 17 00:00:00 2001 From: Konstantin Date: Wed, 30 Apr 2025 12:22:43 +0200 Subject: [PATCH 1/2] add: add calendar parameters which are now sent with every event --- ingest/default-parameters.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/ingest/default-parameters.md b/ingest/default-parameters.md index 9083fa4..686ab1f 100644 --- a/ingest/default-parameters.md +++ b/ingest/default-parameters.md @@ -155,6 +155,19 @@ Navigation analytics signals have these parameters, which can be included in any - `TelemetryDeck.Navigation.destinationPath` (String): The destination path of the navigation, e.g. `/host/info/about` or `app.settings.privacy`. - `TelemetryDeck.Navigation.identifier` (String): String that uniquely identifies the navigation in the format `sourcePath -> destinationPath`. +## Acquisition Analytics + + +- `TelemetryDeck.Calendar.dayOfMonth`: The day-of-month (1..31) component of the date. +- `TelemetryDeck.Calendar.dayOfWeek`: The ISO 8601 number of the given day of the week. Monday is 1, Sunday is 7. +- `TelemetryDeck.Calendar.dayOfYear`: The 1-based day-of-year component of the date. +- `TelemetryDeck.Calendar.weekOfYear`: The week number within the current year as defined by `getFirstDayOfWeek()` and `getMinimalDaysInFirstWeek()`. +- `TelemetryDeck.Calendar.isWeekend`: `true` if the day of the week is Saturday or Sunday, `false` otherwise. +- `TelemetryDeck.Calendar.monthOfYear`: The number-of-the-month (1..12) component of the date. +- `TelemetryDeck.Calendar.quarterOfYear`: The the quarter-of-year (1..4). For API 26 and earlier, it's the number of the month divided by 3. +- `TelemetryDeck.Calendar.hourOfDay`: The hour-of-day (0..23) time component of this time value. + + ## API Information about which TelemetryDeck API this signal was sent to. From 67041e70a3d1f758d4ff10e8786b82ad52cf3391 Mon Sep 17 00:00:00 2001 From: Konstantin Date: Wed, 30 Apr 2025 12:28:32 +0200 Subject: [PATCH 2/2] add acquisition and retention --- ingest/default-parameters.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/ingest/default-parameters.md b/ingest/default-parameters.md index 686ab1f..6d053fc 100644 --- a/ingest/default-parameters.md +++ b/ingest/default-parameters.md @@ -166,7 +166,12 @@ Navigation analytics signals have these parameters, which can be included in any - `TelemetryDeck.Calendar.monthOfYear`: The number-of-the-month (1..12) component of the date. - `TelemetryDeck.Calendar.quarterOfYear`: The the quarter-of-year (1..4). For API 26 and earlier, it's the number of the month divided by 3. - `TelemetryDeck.Calendar.hourOfDay`: The hour-of-day (0..23) time component of this time value. - +- `TelemetryDeck.Acquisition.firstSessionDate`: The date of the first session e.g. 2025-02-22 +- `TelemetryDeck.Retention.averageSessionSeconds`: The average session duration in seconds. +- `TelemetryDeck.Retention.distinctDaysUsed`: The number of distinct dates on which the app was used. +- `TelemetryDeck.Retention.totalSessionsCount`: The total number of sessions. +- `TelemetryDeck.Retention.previousSessionSeconds`: The duration of the previous session in seconds. +- `TelemetryDeck.Retention.distinctDaysUsedLastMonth`: The number of distinct dates on which the app was used in the last month. ## API