Add google analytics to docs about documentation HOT 11 CLOSED

This an account level settings on Read the Docs:

Read the Docs has native support for Google Analytics. You can enable it by:
Going to Admin > Advanced Settings in your project.
Fill in the Analytics code heading with your Google Tracking ID (UA-76769778-2)

from documentation.

From @gitmate-bot on April 23, 2016 14:16

Thanks for reporting this issue!

Your aid is required, fellow coalaian. Help us triage and solving this issue!

CC @sils1297, @AbdealiJK

from documentation.

From @tfar on April 25, 2016 6:33

Don't forget to let the viewers of the documentation know that they are being watched and tracked if you happen to decide that adding visitor tracking to a online documentation of a software project provides enough useful information to be worthwhile.

from documentation.

From @sils1297 on April 25, 2016 6:43

@tfar hey are you against us doing this? We'd be happy to discuss this, privacy is important. Where would be the right place to mention something like this?

from documentation.

From @sils1297 on April 25, 2016 6:59

So my personal take on this is I'm not fully sure. The whole internet watches you already, you're being watched by GitHub as well, possibly readthedocs does that already. It's simply not possible to not watch users in a way just by observing server load. Now, taking a tool like Google Analytics gets us some more information that may help improving documentation. There's a very blurry border here somewhere that differs for different people.

I'd like to have @AbdealiJK s stand on how useful this is after all, I've never worked with that kind of data.

from documentation.

From @AbdealiJK on April 25, 2016 7:20

Google analytics would help track how many people find the documentation and how they find the documentation. It also has demographic information helping us plan conferences (maybe). This would help us in making things better.

All in all: I prefer having more data even if I don't use it. But that's subjective and the community should decide (hence the issue)

My opinion on the privacy issue: If I visit a website, I expect them to have a log of me visiting it (because apache already does it with my IP, mac, etc). Internet works two ways, If I see and use public info on a website, the website can see and use my public information too.

@sils1297 If we're doing this, it'd go into a "Terms of Usage" or so file I guess.

from documentation.

From @Uran198 on May 4, 2016 18:23

Adding this should be simple according to http://www.drmaciver.com/2015/04/getting-google-analytics-on-readthedocs/
I agree with @AbdealiJK that this can help us improve documentation and the project itself.

from documentation.

From @tushar-rishav on May 22, 2016 20:47

I think adding analytics script would also help us keep track of the bouncing rate. Things like how far user has read the docs by scrolling can be also be known. Overall I think it would be useful to have it if we provide a message somewhere saying that we are tracking your behaviour on this doc page.

from documentation.

From @Makman2 on May 22, 2016 22:33

like a cookie notification on other websites :)

from documentation.

Do i need to add that code the to all the rst files ?

from documentation.

Works, nice! @stephenbhope thanks a lot!

from documentation.