jazzband/django-analytical

Photos or samples of analytics

datatalking opened this issue · 7 comments

The fact that Django says it has analytics is good, but as a new user, there is no "this is what this analytics" look like so I am forced to read the code and hope that I understand what each module creates?

Couldn't you take a screenshot of what these python files create so we can see if this is what we are looking for?

I'm not exactly sure yet what you mean. Are you saying the term "analytics" is not defined clearly? Or would you like an example of the template tag expansion? Maybe you could give a suggestion in the form of a pull request?

I believe, there is a fundamental misunderstanding in what django-analytical provides.

There are no dashboards and whatsoever. This is what the services provide for evaluation that you subscribe to. Use your account with them to both set up analytics tracking and evaluate analytics results.

django-analytical is just a Python module to make integrating their code snippets more clean. It does nothing else (if you want so). From the README:

This application hides the details of the different analytics services behind a generic interface, and keeps personal information and configuration out of the templates. Its goal is to make the basic set-up very simple, while allowing advanced users to customize tracking. Each service is set up as recommended by the services themselves, using an asynchronous version of the Javascript code if possible.

And no, you're not forced to read the code. There is a very nice documentation you're invited to consume.

if I can’t see the result of what it does I can’t understand what it does.

I understand this clearly. Could it be that you are maybe not the audience this module is trying to address? Python modules are for programmers, not data analysts.

It may be needed to rephrase the very first paragraph(s) of the README or documentation in a way that conveys the purpose of this module even more clearly. But how do you do that without limiting yourself to a specific target audience?

Django is clearly for web developers (not content editors or business users). It's a framework for programmers. And all Python modules are so, too.

Anyway, if you can get your head around the workings of this Python module (which is called "a Django app", which is really more or less plain Python code) and then have an idea of making the intro paragraphs more clear, let us know!

Screenshots won't cut it in this case, because it's all about Python code and Django template code (which is some sort of HTML). It would be taking screenshots of our development environments. Of course, someone could do a video on Django + analytics good practices, but I'm not sure if then we're making people laugh about us -- for exaggerating. 😄

Yes, exactly, this project is for integrating, for example, Google Analytics and not building your own dashboards.

https://www.fiverr.com/yawyaw213/build-your-django-dashboards

There you go! That person may want to use django-analytical. Under the hood. And he may not even tell you about it.