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

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

Open
unikitty37 opened this issue Feb 3, 2021 · 4 comments
Labels
c: Documentation For issues related to in-app product help messages, or to the Matomo knowledge base. c: Website matomo.org For issues related to our matomo.org website.

Comments

@unikitty37
Copy link

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
Copy link
Member

sgiehl commented Feb 3, 2021

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/

@sgiehl sgiehl added c: Documentation For issues related to in-app product help messages, or to the Matomo knowledge base. c: Website matomo.org For issues related to our matomo.org website. labels Feb 3, 2021
@unikitty37
Copy link
Author

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

@tsteur
Copy link
Member

tsteur commented Feb 4, 2021

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

@mattab
Copy link
Member

mattab commented Feb 4, 2021

@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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
c: Documentation For issues related to in-app product help messages, or to the Matomo knowledge base. c: Website matomo.org For issues related to our matomo.org website.
Projects
None yet
Development

No branches or pull requests

5 participants