From 3d7aeb4e5ab6f7b9809e4f59ca2d5642c67f108c Mon Sep 17 00:00:00 2001 From: Garrett Date: Tue, 30 Nov 2021 13:48:40 -0500 Subject: [PATCH] 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: