Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Suggested doc: add recommendation for analytics page #105

Open
a-mccarthy opened this issue Mar 31, 2022 · 5 comments
Open

Suggested doc: add recommendation for analytics page #105

a-mccarthy opened this issue Mar 31, 2022 · 5 comments
Labels
documentation Improvements or additions to the TechDocs documentation

Comments

@a-mccarthy
Copy link

This idea came out of a conversation with @nate-double-u around analytics for project sites. Analytics provide valuable information around content usage and can help a community prioritize pages to focus energy on across many levels of docs work, including release docs, localization work, etc.

Some possible recommendations ideas

  • how to get analytics information. All CNCF project teams should have access to site analytics though Netlify Analytics. This feature must be enabled on each site
  • make analytic information available to your community. Create a analytics page on your site, for example see the Kubernetes Viewing Analytics page. Or present information regularly at community meetings
@a-mccarthy
Copy link
Author

@nate-double-u hopefully this captures what we were chatting about yesterday!

@nate-double-u nate-double-u added the documentation Improvements or additions to the TechDocs documentation label Mar 31, 2022
@chalin chalin mentioned this issue Apr 26, 2022
11 tasks
@chalin
Copy link
Collaborator

chalin commented Apr 26, 2022

@chalin
Copy link
Collaborator

chalin commented Aug 17, 2022

We might also want to recommend the following approach:

@a-mccarthy
Copy link
Author

I've been working on updating the kubernetes dashboard to use GA4 and I was able to make a more "blank" template in looker studio. https://lookerstudio.google.com/u/0/reporting/df34ae1f-5ce4-452f-9f3d-87dc50273dd2/page/4VDGB/edit

The idea is that if a project wants to have a dashboard of their analytics available they can copy this dashboard template and connect to their ga4 account as a data source. Hopefully its as "simple" as that, but i dont have any way to test this b/c i dont have access to any other ga4 account :) (the dashboard is connected to the Kubernetes account so the charts work)

Some thoughts

  • It assumes that a projects ga4 account already exists and is set up similar to the kubernetes account
  • page 4 of the dashboard is a "How to set up a dashboard" docs page, but is in need of some updates specifically
    • the permissions section needs to be updated to be more generic (but i need another account to test to see how to set it up properly)
    • make sure the set up section is completed, needs another account to step through the process with to make sure the steps are all there.

Not sure how much of a need other projects have for something like this, but it was pretty straightforward to create a first pass template, so I figured i'd share it and see if there is any interest in refining it :)

@chalin
Copy link
Collaborator

chalin commented Feb 16, 2024

Wow, this is great! Thanks for having persisted in getting this to work.

I'll give it a spin for the OTel site if maintainers are open to it:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to the TechDocs documentation
Projects
None yet
Development

No branches or pull requests

3 participants