Skip to content

Home

Jump to bottom
ComputerElite edited this page Nov 16, 2023 · 13 revisions

Welcome to the ComputerAnalytics wiki!

Here you'll learn a bit about the Analytics process!

First, what even is this?

ComputerAnalytics is inspired by Google Analytics. It's basically an open source analytics software with which you can see the traffic on your website.

What data is being collected and stored?

Everything is stored in plain text atm

Every Analytic is stored in a MongoDB Collection. Analytics can only be recieved if the server is on. However if you get the analytics from somewhere else you can import them

We'll devide this into 2 sections:

Data provided via a POST request (what you send)

  • where you are on the website including everything in the address bar (excluding query strings for security reasons)
  • When you opened the site and when you closed it
  • From which site you came
  • Your screen size in pixels (e. g. width: 1920, height: 1080)
  • A randomly generated id for your browser. This is used to anonymously count how many people visit the site

This data is being collected in this file

Date collected by the server (which come by default with every http request)

  • Your User Agent (aka browser and operating system)

This data is being collected in the Function Recieve in AnalyticsData which is in this file at the bottom.

How do I set it up?

Deploy the server on some PC. Then start it as administrator and open http://[server ip here]:502 (you can change the port in the config). Then get the master token for your server by running ComputerAnalytics.exe -dmt (it is recommended to save the token somewhere for easy access). Type it in the token box and log in. From here you can manage the server:

Set the public address (required)

Put in the ip under which your server is always accessible. (e. g. I use http://analytics.rui2015.me). Click Save public address and you're set up.

Add a website for which you want to see analytics

  1. Add the website on the analytics server by putting in your website in the Website URL box (e. g. https://computerelite.github.io; THE WEBSITE MUST NOT END WITH /).

You'll see a new box at the bottom with labels public and private. Save the private token for later (it is used to see analytics. If you ever leak it press Renew tokens)

  1. Add the analytics script to your website: a) Got a script which is linked on every page of your site? Add following to the script:
var script = document.createElement("script");
script.src = "https://PublicAddressHere/analytics.js?origin=" + location.origin;
document.head.appendChild(script);

where you replace PublicAddressHere with your ComputerAnalytics server ip or domain which is always accessible (e. g. analytics.rui2015.me)

Want to see your Analytics?

Go back to the login and put in the private token of the site you want to see Analytics (this is under the manage section of ComputerAnalytics once you log in with the master token).

Want daily updates to your sites status over Discord?

Don't worry. I got ya covered. Create a Discord webhook and copy it's url (you'll find plenty of guides online). Now it depends where you paste it: a) Want to only get updates aboout your side? Paste it into the webhook url box under your sites url and click save webhook url. b) Want to get updates about the ComputerAnalytics server status? Paste it into the master webhook url box and hit save

You'll now get daily updates about the status of ComputerAnalytics and your website. For detailed real time data you can always check the analytics online.

You're set. You can now see everything what's going on on your site.

You're set up

If you get issues, have questions or have any suggestions feel free to open an GitHub issue

Want to see the implementation on my site?

Click here

Need help setting everything up?

Create a GitHub issue and describe your problem as well as you can

Clone this wiki locally