From 8efae2dfcf85ed4d587e246c1a6830efe16d73c6 Mon Sep 17 00:00:00 2001
From: Shahed Nasser <shahednasser@gmail.com>
Date: Tue, 6 Dec 2022 18:14:07 +0200
Subject: [PATCH] docs: added details about admin analytics in usage
 documentation (#2733)

---
 docs/content/usage.md | 66 +++++++++++++++++++++++++++++++++++++++----
 1 file changed, 60 insertions(+), 6 deletions(-)

diff --git a/docs/content/usage.md b/docs/content/usage.md
index 5daf0d8b90..0c61986283 100644
--- a/docs/content/usage.md
+++ b/docs/content/usage.md
@@ -1,12 +1,13 @@
-# Collected Usage Information
+# Usage Information
 
 <!-- vale docs.We = NO -->
+<!-- vale docs.FirstPerson = NO -->
 
 This document gives an overview of Medusa’s optional collected usage information, how it helps Medusa become a better platform, and how developers can opt-out of this feature.
 
 ## Overview
 
-At Medusa, we strive to provide the best experience for developers using our platform. For that reason, Medusa collects anonymous and non-sensitive data that provides a global understanding of how users are using Medusa on a live server.
+At Medusa, we strive to provide the best experience for developers using our platform. For that reason, Medusa collects anonymous and non-sensitive data that provides a global understanding of how users are using Medusa.
 
 ## Purpose
 
@@ -20,24 +21,30 @@ Collecting this data allows us to understand certain details such as:
 
 - What operating system do most Medusa developers use?
 - What version of Medusa is widely used?
+- What parts of the Medusa Admin are generally undiscovered by our users?
+- How much data do users manage through our Medusa Admin? Is it being used for large number of products, orders, and other types of data?
 - What Node version is globally used? Should we focus our efforts on providing support for versions that we don’t currently support?
 
-## Collected Data
+## Server Analytics
+
+This section covers which data in the server are collected and how to opt out of it.
+
+### Collected Data in Server
 
 The following data is being collected on your server:
 
 - Unique project ID generated with UUID.
 - Unique machine ID generated with UUID.
 - Operating system information including Node version or operating system platform used.
-- The version of the Medusa server and Medusa CLI used.
+- The version of the Medusa server and Medusa CLI are used.
 
 :::info
 
-Data is only collected when the server is run with the command `medusa start`.
+💡 Data is only collected when the server is run with the command `medusa start`.
 
 :::
 
-## How to Opt-Out
+### How to Opt Out
 
 If you prefer to disable data collection, you can do it either by setting the following environment variable to true:
 
@@ -51,4 +58,51 @@ Or, you can run the following command in the root of your Medusa server project
 medusa telemetry --disable
 ```
 
+## Admin Analytics
+
+This section covers which data in the admin are collected and how to opt out of it.
+
+### Collected Data in Admin
+
+:::info
+
+Users have the option to [enable or disable the anonymization](#how-to-enable-anonymization) of the collected data.
+
+:::
+
+The following data is being collected on your admin:
+
+- The name of the store.
+- The email of the user.
+- The total number of products, orders, discounts, and users.
+- The number of regions and their names.
+- The currencies used in the store.
+- Errors that occur while using the admin.
+
+### How to Enable Anonymization
+
+To enable anonymization of your data from the Medusa admin:
+
+1. Go to Settings → Personal Information.
+2. In the Usage insights section, click on the “Edit preferences” button.
+3. Enable the "Anonymize my usage data” toggle.
+4. Click on the “Submit and close” button.
+
+### How to Opt-Out
+
+There are two ways to opt out of analytics collected in the Medusa admin:
+
+1. Disable the feature flag that is enabled by default for the admin analytics feature:
+
+```bash
+MEDUSA_FF_ANALYTICS=false
+```
+
+2\. Alternatively, on your Medusa admin, you can disable tracking by following these steps:
+    1. Go to Settings → Personal Information.
+    2. In the Usage insights section, click on the “Edit preferences” button.
+    3. Enable the “Opt out of sharing my usage data” toggle.
+    4. Click on the “Submit and close” button.
+
 <!-- vale docs.We = YES -->
+<!-- vale docs.FirstPerson = YES -->