Website analytics

[feross]

How popular are the Node.js docs? I'm curious about the total monthly page views, unique visitors, and time spent on site for everything in /docs/api.

It would also be interesting to know how many page views the website as a whole receives.

[fhemberger]

Here are the stats compared for the last two months:

Hope that helps, if you need further details, please let me know.

[feross]

@fhemberger Thank you. Can you confirm if those counts are for the specific individual pages or for all of the pages that are in subfolders, e.g. /en/docs/*?

It appears that those numbers may be just for the individual pages, excluding most of the hits in the subfolders.

[fhemberger]

@feross Sorry, those were the stats of /docs/, not the API docs. D'oh!

Here are the (hopefully) correct ones for the same time period:

The problem here is that /latest/ doesn't redirect to /latest-vX.X, which influences the stats

[feross]

@fhemberger Thanks for the updated stats. I still think something doesn't look right.

How can it be that the docs were viewed only a few hundred times? I believe the stats are showing the number of times that the specific page is loaded, not including pages that are nested within.

For example, hits to https://nodejs.org/dist/latest-v8.x/ are included, but hits to https://nodejs.org/dist/latest-v8.x/docs/api/ and https://nodejs.org/dist/latest-v8.x/docs/api/buffer.html are not being included.

Otherwise, I don't see how the stats could be so low, but please correct me if I'm missing something.

[feross]

Actually, it appears that the API docs are missing the Google Analytics script.

I see that these pages request the script:

https://nodejs.org/en/
https://nodejs.org/en/docs/

But these pages do not:

https://nodejs.org/dist/latest-v8.x/docs/api/
https://nodejs.org/dist/latest-v8.x/docs/api/buffer.html

@fhemberger Can you also confirm this?

[fhemberger]

@feross Yes, I can confirm this. There's only a comment <!-- __TRACKING__ --> at the end of the page, but the actual tracking code seems to be missing.

Should have been replaced during the build process: /tools/doc/html.js#L155. Looks like /tools/doc/generate.js was called without the --analytics=… parameter, which seems to be the case for all latest-vX.x versions.

Just found an issue for that, dating back to January:
nodejs/node#11050

[phillipj]

That's right, the docs do have support for GA tracking, but it hasn't been enabled yet because I've never been able to find where that --analytics parameter have to be added. Ref the issue @fhemberger just mentioned ^.

[fhemberger]

@phillipj Found it:
https://github.com/nodejs/node/blob/master/Makefile#L463

Referenced here:
https://github.com/nodejs/node/blob/master/Makefile#L501

[phillipj]

@fhemberger: yeah, that's the $ENV variable that allows the GA code to be set when building the docs. The problem is that I haven't found where/whom $ make doc is actually run. Assumed it was some hidden CI somewhere that's only visible to those cutting new versions, but as said, never got an answer from the ones that probably has the correct answer..

Please feel free to help pinging "someone" ;)

[fhemberger]

@nodejs/jenkins-admins to the resuce!

[rvagg]

yep, one of the jenkins admins can indeed do that, is DOCS_ANALYTICS="UA-67020396-1" enough for this?

[rvagg]

That's in there now, someone keep an eye on the next release and make sure that it comes out as you expect. As a test you should also see them show up in the nightlies and v8-canary releases from now on too.

[fhemberger]

@rvagg Thanks, if everything works out, can we re-generate existing docs (at least latest-vX.x) as well?