From 3d7aeb4e5ab6f7b9809e4f59ca2d5642c67f108c Mon Sep 17 00:00:00 2001 From: Garrett Date: Tue, 30 Nov 2021 13:48:40 -0500 Subject: [PATCH 1/2] Updated documentation for GA4 (#3277) --- docs/setup/setting-up-site-analytics.md | 43 +++++++++++++++++++------ 1 file changed, 33 insertions(+), 10 deletions(-) diff --git a/docs/setup/setting-up-site-analytics.md b/docs/setup/setting-up-site-analytics.md index a49404f88..6cd7816ae 100644 --- a/docs/setup/setting-up-site-analytics.md +++ b/docs/setup/setting-up-site-analytics.md @@ -116,18 +116,41 @@ integrated with the [cookie consent][extra.consent] feature[^1]. ??? question "How to visualize the collected feedback ratings?" - It's quite easy to build a custom report with [Google Analytics] that will - quickly show you the worst- and best-rated pages of your project - documentation. You can generate a custom report with the following steps: + To visualize feedback ratings you'll need to create a custom report with + [Google Analytics] that will quickly show you the worst- and best-rated + pages of your project documentation. - 1. Go to your Google Analytics __dashboard__ - 2. Open the __customization__ panel on the left and go to __custom reports__ - 3. Create a __new custom report__ and set a custom __title__ and __name__ - 4. Add `Avg. Value` and `Total Events` to __metric group__ - 5. Add `Event Label` to __dimension drilldown__ - 6. Add `Event Category` to __filters__ and filter for the value __feedback__ + === ":material-google-analytics: Google Analytics 4" - Now, after you've saved the report and collected some feedback ratings, + 1. Go to your Google Analytics __dashboard__ + 2. Go to the __Configure__ page on the left hand menu, then select __Custom Definitions__ + 3. Click the __Custom metrics__ tab and then __Create custom metrics__, enter the following values: + * Metric name: Page helpful + * Description: Was this page helpful? + * Event parameter: data + * Unit of measurement: Standard + 4. Go to the __Explore__ page on the left hand menu, create a new __blank exploration__ + 5. Configure the report as follows: + * Dimensions: Add `Event name` and `Page location` + * Metrics: Add `Event count` and `Page helpful` (the custom metric created in step 3) + * Rows: `Page location` + * Values: `Page helpful` + * Filters: Add a new filter for `Event name / exactly matches / feedback` + + !!! warning "Delay in data availability" + + The report may take 24 hours or longer to begin displaying data + + === ":material-google-analytics: Universal Analytics" + + 1. Go to your Google Analytics __dashboard__ + 2. Open the __customization__ panel on the left and go to __custom reports__ + 3. Create a __new custom report__ and set a custom __title__ and __name__ + 4. Add `Avg. Value` and `Total Events` to __metric group__ + 5. Add `Event Label` to __dimension drilldown__ + 6. Add `Event Category` to __filters__ and filter for the value __feedback__ + + Now, after you've saved the report and collected some feedback ratings, you'll have a list of all pages with the total number of ratings, and an average rating per page. This should help you identify pages that need to be improved: From ae6bdb427801ac77618c22f2e00eef5e16bdb8ec Mon Sep 17 00:00:00 2001 From: Neil Hanlon Date: Tue, 30 Nov 2021 16:57:46 -0500 Subject: [PATCH 2/2] Fixed Swedish and Polish translations (#3279) --- src/partials/languages/pl.html | 0 src/partials/languages/sv.html | 2 +- 2 files changed, 1 insertion(+), 1 deletion(-) mode change 100755 => 100644 src/partials/languages/pl.html diff --git a/src/partials/languages/pl.html b/src/partials/languages/pl.html old mode 100755 new mode 100644 diff --git a/src/partials/languages/sv.html b/src/partials/languages/sv.html index dcc39d160..27f68fc0f 100644 --- a/src/partials/languages/sv.html +++ b/src/partials/languages/sv.html @@ -53,6 +53,6 @@ "source.file.date.updated": "Senaste uppdaterad", "source.file.date.created": "Skapad", "tabs.title": "Flikar", - "toc.title": "Innehållsförteckning" + "toc.title": "Innehållsförteckning", "top.title": "Tillbaka till toppen" }[key] }}{% endmacro %}