medic / medic-docs

Replaced by https://github.com/medic/cht-docs. This repo was the former source of documentation for developing, configuring, and using Medic Mobile tools.
https://docs.communityhealthtoolkit.org
GNU Affero General Public License v3.0
29 stars 35 forks source link

CHT documentation site telemetry implementation #202

Closed MaxDiz closed 4 years ago

MaxDiz commented 4 years ago

Gaining insights into how users engage with the CHT documentation site will help us to determine user uptake, what self-help information users reference most frequently, and which information sets are largely disregarded. Since the documentation site is an online-first resource, implementing telemetry should be straight forward, using an off-the-shelf tool like google analytics. Relevant telemetry points include:

kennsippell commented 4 years ago

I'd like to propose using Google Analytics. I've confirmed that it supports all of the above metrics + a bunch of basic metrics that we will maybe one day learn to love. It integrates easily with most web platforms via a small javascript snippet and will take less than one day to setup end-to-end.

We've added integration with an analytics platform into our list of tooling requirements https://github.com/medic/medic-docs/issues/198.

@MaxDiz How can we "review/test" this proposal?

SCdF commented 4 years ago

I think this is a great idea, especially since it's less than a day we might as well get a branch out there to see how it feels.

Specifically it would be good to see what the end bandwidth requirement is, how it sends requests out etc.

One question, and idk who can answer this: how do we feel about Google hosting this data? Is that something we're OK with, do we have any concerns?

On Tue, Apr 14, 2020 at 6:01 PM Kenn Sippell notifications@github.com wrote:

I'd like to propose using Google Analytics https://analytics.google.com/analytics/web/. I've confirmed that it supports all of the above metrics + a bunch of basic intuitive metrics. It integrates easily with most web platforms via a small javascript snippet and will take less than one day to prepare end-to-end.

— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub https://github.com/medic/medic-docs/issues/202#issuecomment-613561960, or unsubscribe https://github.com/notifications/unsubscribe-auth/AAEORKYT356AKVX5IUMLXWTRMSJFNANCNFSM4MEYW4FA .

kennsippell commented 4 years ago

Discussed on squad call today and did not have any concerns.