search

matomo-org / matomo

Empowering People Ethically with the leading open source alternative to Google Analytics that gives you full control over your data. Matomo lets you easily collect data from websites & apps and visualise this data and extract insights. Privacy is built-in. Liberating Web Analytics. Star us on Github? +1. And we love Pull Requests!
https://matomo.org/
GNU General Public License v3.0
19.77k stars 2.63k forks source link

Event tracking documentation link to tag manager installation does not link to anywhere useful #17184

Open unikitty37 opened 3 years ago

unikitty37 commented 3 years ago

The document at https://matomo.org/docs/event-tracking/ states "If you have Matomo Tag Manager installed, it is the easiest way to implement event tracking on your site." Underneath it, there is a set of instructions, the first of which is "Set up and configure Matomo Tag Manager (create a container and install the container code)" which is linked to https://matomo.org/free-tag-manager/#how-can-i-set-up-matomo-tag-manager-on-my-website.

Expected Behaviour

The documentation contains both a link to the installation instructions for on-premise Matomo, and a link to the instructions for Matomo-as-a-service.

When I click the self-hosted link, I am given instructions on how to create a container running the tag manager and install it on a self-hosted Matomo instance.

Actual Behaviour

There is only the one link. When I click it, I am taken to a page which gives me no instructions on how to install the tag manager, and instead tries to get me to sign up for a 21-day free trial of the hosted version. If I click on the "on-premise" link in the "commitment to open source" section, I am still not taken to installation instructions, but to a page which compares on-premise to hosted, presumably with the goal of getting me to say "oh, I'll just pay for hosted instead".

If I do not fall for this trap, and click "Install now", I am taken to a list of instructions which make no mention whatsoever of how to install the tag manager.

So, where are the instructions for setting this up, and why are they not linked to directly from the first page?

Clicking a link labelled "Set up and configure Matomo Tag Manager (create a container and install the container code)" should take you to a page that tells you how to do exactly that, no?

And surely a "commitment to open source" should include not burying the usage instructions below repeated upsells?

sgiehl commented 3 years ago

Hi @unikitty37 We are constantly trying to keep our documentation up to date. In the last few months we have even completely revised parts of it. It is quite possible that at one or the other place a link was overlooked and not updated correctly. Many thanks for the hint. We will try to adjust the broken links as soon as possible.

I guess the page you are looking for might be this one: https://matomo.org/docs/tag-manager/

unikitty37 commented 3 years ago

Thanks — I was quite surprised to find out that the container it referred to was nothing to do with Docker, actually 🙂

tsteur commented 3 years ago

@mattab are we maybe putting these issues into our KB project in the future?

mattab commented 3 years ago

@tsteur the bug here is actually a bug in the website that we had several times in the past. it rewrites the links to the wrong URL. Here is the rendered text: Screenshot from 2021-02-05 08-13-53 which links to: https://matomo.org/free-tag-manager/#how-can-i-set-up-matomo-tag-manager-on-my-website

While the original is: Screenshot from 2021-02-05 08-13-59 linking correctly to https://matomo.org/docs/tag-manager/#how-can-i-set-up-matomo-tag-manager-on-my-website

randy-innocraft commented 3 weeks ago

Hi @unikitty37. Thank you for creating the issue and bringing this to our attention, that's very appreciated. We have reviewed and triaged the problem internally, and we have confirmed it is an issue. Our team will prioritise this, and we will update you on the progress here when we have an update to share. If you have any further information or questions, please feel free to add them here.