From 360bf2fbd501289a0f0ea531bafaa6f7d737f83b Mon Sep 17 00:00:00 2001 From: Adrian Cojocariu Date: Tue, 12 Nov 2024 08:52:47 +0200 Subject: [PATCH 1/5] Umbraco Commerce 14.2.0 release notes and telemetry specification --- .../reference/telemetry/README.md | 39 +++++++++++++++++++ 14/umbraco-commerce/release-notes/README.md | 4 ++ 2 files changed, 43 insertions(+) create mode 100644 14/umbraco-commerce/reference/telemetry/README.md diff --git a/14/umbraco-commerce/reference/telemetry/README.md b/14/umbraco-commerce/reference/telemetry/README.md new file mode 100644 index 00000000000..77bf5fdfa94 --- /dev/null +++ b/14/umbraco-commerce/reference/telemetry/README.md @@ -0,0 +1,39 @@ +--- +description: Get started with Commerce telemetry. +--- + +## Telemetry + +Commerce telemetry is connected directly to the CMS telemetry pipeline and runs with the [`ReportSiteJob`](https://github.com/umbraco/Umbraco-CMS/blob/v14/dev/src/Umbraco.Infrastructure/BackgroundJobs/Jobs/ReportSiteJob.cs). + +It pulls commerce data using a custom provider. + +### Captured data + +Through the custom provider, the Commerce telemetry pipeline captures the following data defined per store: +* Store ID +* Product Count +* Order Count +* Location Count +* Country Count +* Country Codes +* Currency Count +* Currency Codes +* Payment Method Count +* Payment Providers +* Shipping Method Count +* Shipping Providers +* Shipping Method Types +* Tax Calculation Method Count +* Sales Tax Providers +* Is Custom Product Adapter Used +* Is Custom Product Calculator Used +* Is Custom Order Line Calculator Used +* Is Custom Payment Calculator Used +* Is Custom Shipping Calculator Used +* Is Storefront API Enabled + +### Settings + +Commerce telemetry reporting can be managed in the [`Telemetry Data`](https://docs.umbraco.com/umbraco-cms/fundamentals/backoffice/settings-dashboards#telemetry-data) dashbord. + diff --git a/14/umbraco-commerce/release-notes/README.md b/14/umbraco-commerce/release-notes/README.md index 491e6c65cfd..fefefa0d3b6 100644 --- a/14/umbraco-commerce/release-notes/README.md +++ b/14/umbraco-commerce/release-notes/README.md @@ -17,6 +17,10 @@ If you are upgrading to a new major version, check the breaking changes in the [ This section contains the release notes for Umbraco Commerce 14 including all changes for this version. +#### 14.2.0 (November 12th 2024) +* Added telemetry support as detailed [here](/14/umbraco-commerce/reference/telemetry/README.md). +* Added cart to order feature that will facilitate admin users to finalize an order directly from the BackOffice cart workspace. + #### [14.1.8](https://github.com/umbraco/Umbraco.Commerce.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F14.1.8) (November 11th 2024) * Fixed Rounding issue between Umbraco Commerce and Stripe payment gateway [#580](https://github.com/umbraco/Umbraco.Commerce.Issues/issues/580). From b3db83f9d39763693b6dde924b74aff4ae8bf73b Mon Sep 17 00:00:00 2001 From: Adrian Cojocariu Date: Tue, 12 Nov 2024 10:01:35 +0200 Subject: [PATCH 2/5] Update summary for telemetry --- 14/umbraco-commerce/SUMMARY.md | 1 + 1 file changed, 1 insertion(+) diff --git a/14/umbraco-commerce/SUMMARY.md b/14/umbraco-commerce/SUMMARY.md index 85d4ebbae90..d857a492da8 100644 --- a/14/umbraco-commerce/SUMMARY.md +++ b/14/umbraco-commerce/SUMMARY.md @@ -101,6 +101,7 @@ * [Content](reference/storefront-api/endpoints/content.md) * [Management API](reference/management-api/README.md) * [Go behind the scenes](reference/go-behind-the-scenes.md) +* [Telemetry](reference/telemetry/README.md) ## Tutorials From 3475403c280479584d5a9c341021bb4cbb1f3e70 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Tue, 12 Nov 2024 12:01:09 +0100 Subject: [PATCH 3/5] Update 14/umbraco-commerce/release-notes/README.md --- 14/umbraco-commerce/release-notes/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/README.md b/14/umbraco-commerce/release-notes/README.md index fefefa0d3b6..af55ae7adbd 100644 --- a/14/umbraco-commerce/release-notes/README.md +++ b/14/umbraco-commerce/release-notes/README.md @@ -19,7 +19,7 @@ This section contains the release notes for Umbraco Commerce 14 including all ch #### 14.2.0 (November 12th 2024) * Added telemetry support as detailed [here](/14/umbraco-commerce/reference/telemetry/README.md). -* Added cart to order feature that will facilitate admin users to finalize an order directly from the BackOffice cart workspace. +* Added a cart-to-order feature that will facilitate admin users to finalize an order directly from the BackOffice cart workspace. #### [14.1.8](https://github.com/umbraco/Umbraco.Commerce.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F14.1.8) (November 11th 2024) From 6fee2c7c44d6cd2c35426798ea860d0ee4e4d494 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Tue, 12 Nov 2024 12:01:16 +0100 Subject: [PATCH 4/5] Update 14/umbraco-commerce/reference/telemetry/README.md --- 14/umbraco-commerce/reference/telemetry/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/reference/telemetry/README.md b/14/umbraco-commerce/reference/telemetry/README.md index 77bf5fdfa94..61afa836e2e 100644 --- a/14/umbraco-commerce/reference/telemetry/README.md +++ b/14/umbraco-commerce/reference/telemetry/README.md @@ -35,5 +35,5 @@ Through the custom provider, the Commerce telemetry pipeline captures the follow ### Settings -Commerce telemetry reporting can be managed in the [`Telemetry Data`](https://docs.umbraco.com/umbraco-cms/fundamentals/backoffice/settings-dashboards#telemetry-data) dashbord. +Commerce telemetry reporting can be managed in the [Telemetry Data](https://docs.umbraco.com/umbraco-cms/fundamentals/backoffice/settings-dashboards#telemetry-data) dashboard. From 1048c1e0d88b15acd50d0ac8ea4fbde41daa416a Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Tue, 12 Nov 2024 12:01:21 +0100 Subject: [PATCH 5/5] Update 14/umbraco-commerce/reference/telemetry/README.md --- 14/umbraco-commerce/reference/telemetry/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/reference/telemetry/README.md b/14/umbraco-commerce/reference/telemetry/README.md index 61afa836e2e..137a477148d 100644 --- a/14/umbraco-commerce/reference/telemetry/README.md +++ b/14/umbraco-commerce/reference/telemetry/README.md @@ -4,7 +4,7 @@ description: Get started with Commerce telemetry. ## Telemetry -Commerce telemetry is connected directly to the CMS telemetry pipeline and runs with the [`ReportSiteJob`](https://github.com/umbraco/Umbraco-CMS/blob/v14/dev/src/Umbraco.Infrastructure/BackgroundJobs/Jobs/ReportSiteJob.cs). +Commerce telemetry is connected directly to the CMS telemetry pipeline and runs with the [ReportSiteJob](https://github.com/umbraco/Umbraco-CMS/blob/v14/dev/src/Umbraco.Infrastructure/BackgroundJobs/Jobs/ReportSiteJob.cs). It pulls commerce data using a custom provider.