# coolAnalytics Try it!

Fast, privacy-centric user & error analytics for your web apps & sites.

# Features

  • Easy setup, with one line.
  • User Analytics:
    • Cookie free, no cookies stored in the browser.
    • GDPR & CCPA compliant.
    • Simple & privacy focused, only relevant metrics are shown.
  • Error Analytics:
    • Super fast error tracking. Catch errors before users reporting them.
    • Automatically apply source maps.

# What we collect?

In addition to the general data we collect during registration we collect the followings.

# User-Agent

We collect, but store anonymized user agents in our database.
Why? To determine the visitor's browser.

What anonymized storing means?
We do not store your user agent as it is. Instead, we parse it & save only the required parts.
Only the browser name is stored.

# Timezone

We collect and store your timezone in our database.
Why? To measure the visitor's country.

# Screen Width

We collect and store your device's screen width in our database.
Why? To measure the visitor's device type.

# How you can measure unique visitors?

There are 2 ways to measure unique visitors.

# GDPR compliant way (default)

It means no cookie is used to determine if a visitor is unique or not!
We use hash algorithms for guessing the uniqueness. This means it is not 100% accurate, but compliant with GDPR & CCPA. There is no need for any cookie banner on your site!

# More accurate way

The other option is to set it "false". In this case, we place a cookie with a totally random id in the visitor's browser and change it every month. The random id could not identify the user itself, as we do not store any relationship between this id & the visitor. But in this case, it's more accurate than the default setting.

In this case, you need to have a cookie consent on your website!

<script async defer src="https://cdn.coollabs.io/save.js" data-gdpr="false"></script>

# Usage

# User Analytics

  1. Go to dashboard, add your site & validate it!
  2. Add the following line to the <body> tag of all HTML files where you would like to measure the visitors:
<script async defer src="https://cdn.coollabs.io/save.js"></script>

That's all!

# Error Analytics

  1. Go to dashboard, add your site & validate it!
  2. Add the following line to the <body> tag:
<script src="https://cdn.coollabs.io/error.js"></script>

Native Javascript errors are catched with no additional configuration.

For frontend framework specific configuration, see below.

# Vue

Add the following line to the main.js file:

typeof coolAnalytics !== 'undefined' && coolAnalytics.init({ Vue })

Where Vue is the imported Vue instance.

# Example in main.js

import Vue from 'vue'
import App from './App.vue'
typeof coolAnalytics !== 'undefined' && coolAnalytics.init({ Vue })
[...]

# React

WIP

# Angular

WIP

# Configuration

# User Analytics

You can use data attributes to configure:

<script async defer src="https://cdn.coollabs.io/save.js" data-gdpr="false"></script>

# Error Analytics

coolAnalytics instance in main.js has the following configurations:

  • saveProps : Save props if it's available. Default: true
  • consoleError : Send error to console after sent to our servers. Default: true

# Example in main.js

import Vue from 'vue'
import App from './App.vue'
typeof coolAnalytics !== 'undefined' && coolAnalytics.init({ Vue, saveProps: false, consoleError: false })
[...]

# In-App configuration

# I would like to see my visitors in a different timezone. How?

Go to Settings menu and add your preferred timezone for each sites. Default is GMT.

# Why we created it?

We would like to create a good alternative to the analytics's out there, which does not track users, just trends, in a GDPR & CCPA compliant way & to catch errors before the user reports it! These helps us to provide good applications!

# For devs

Check out the code