mirror of
https://github.com/offen/website.git
synced 2024-11-22 09:00:28 +01:00
GitHub
commit
ab9968d8e8
102
homepage/content/articles/0180-analyticstxt.md
Normal file
102
homepage/content/articles/0180-analyticstxt.md
Normal file
@ -0,0 +1,102 @@
|
||||
title: Disclose what you collect
|
||||
description: Why we drafted a standard that allows you to disclose information about your use of analytics software and user tracking.
|
||||
date: 2021-05-20
|
||||
slug: analytics-txt
|
||||
url: /blog/analytics-txt/
|
||||
sitemap_priority: 0.7
|
||||
image_url: /theme/images/offen-blog-0180-analyticstxt.jpg
|
||||
author: Hendrik Niefeld
|
||||
bottom_cta: cookie
|
||||
|
||||
# Disclose what you collect
|
||||
|
||||
The variety of data protection regulations and the range of methods used to collect usage data make web analytics a confusing field. A well-defined way for websites to indicate their use of analytics and tracking software is still missing. We started working on such a standard and gave it the name `analytics.txt` .
|
||||
|
||||
### Learning from building Offen
|
||||
|
||||
We recently drafted a standards proposal that allows websites and services to disclose information about their use of analytics software and user tracking. As this is related to our work on [Offen](https://www.offen.dev/), we wanted to provide some insight here into our motives, implementation and state of affairs on this matter.
|
||||
|
||||
Offen is a fair web analytics software that treats operators and users as equal parties. Operators can self-host Offen and gain insights about how users interact with their services while ensuring that users remain in full control over their data.
|
||||
|
||||
In the course of the development of our software, we came across a fundamental problem concerning the handling of user data on the internet today. The range of data protection regulations across the globe and the resulting variety of techniques for collecting usage data make web analytics a confusing field to navigate.
|
||||
|
||||
> *The range of data protection regulations across the globe and the resulting variety of techniques for collecting usage data make web analytics a confusing field to navigate.*
|
||||
|
||||
---
|
||||
|
||||
### What today's web lacks
|
||||
|
||||
Sure, terms like "data protection", "privacy-focused" or "privacy-friendly" are widespread and appear reliably in consent banners and privacy statements of of websites and services. But what do they actually [stand for?](https://www.offen.dev/blog/privacy-friendly-and-fair-web/)
|
||||
|
||||
In many cases, users still don't know what data is being collected and how it is being used. This leaves them confused about their situation and does not help to reduce the underlying mistrust towards operators and the web in general.
|
||||
|
||||
We believe that privacy has become an important aspect for users and its importance will continue to grow in the coming years. However, a clearly defined way for websites and services to signal their use of analytics and tracking software to users and make it discoverable for their tooling is still lacking.
|
||||
|
||||
A new specification is needed that can fill this gap for both operators and users. This standard should be nothing less than a comprehensive description of the usage of analytics and tracking in an unbiased way that is both understandable for a non-technical audience, but also useful for consumption by tools and software.
|
||||
|
||||
In January 2021 we started working on such a standard and gave it the name `analytics.txt` .
|
||||
|
||||
> *A clearly defined way for websites and services to signal their use of analytics and tracking software to users and make it discoverable for their tooling is still lacking.*
|
||||
|
||||
|
||||
### Why a web standard?
|
||||
|
||||
Regulations regarding the handling of user data on websites will continue to evolve swiftly. The resulting ongoing adaptation of practices is a challenge for developers that should not be underestimated. Here, standardised information can give auditors immediate insight into the approaches followed and their compliance with applicable regulations.
|
||||
|
||||
However, more important than all legal aspects is the situation of the user. Those who value services that are transparent about the privacy implications will be able to easily inform themselves without having to go through huge amounts of legal text that have become common in the industry.
|
||||
|
||||
Not least, tools such as crawlers or browser extensions can use the information provided to signal all relevant privacy metrics to users and other third parties. A feature from which especially operators with ethical business models will benefit in the future.
|
||||
|
||||
> *Those who value services that are transparent about the privacy implications will be able to easily inform themselves without having to go through huge amounts of legal text.*
|
||||
|
||||
---
|
||||
|
||||
### First version submitted
|
||||
|
||||
For a standard to be effective, it needs a forum in which it can be discussed. We have chosen the format of the [IETF](https://www.ietf.org/standards/ids/) Internet Draft for this purpose and submitted a first version there. Thereby we want to provide a draft version for the interested public. It can be used for informal review and comment on our approaches and does not yet constitute an adopted standard.
|
||||
|
||||
[View Internet-Draft](https://datatracker.ietf.org/doc/draft-ring-analyticstxt/){: data-button="outline"}
|
||||
|
||||
### How it works
|
||||
|
||||
On your website, all that is needed is a simple text file stored in an defined location on the server. This text file contains formatted information on the type of data collected, techniques used, consent settings and duration of storage. Furthermore, information can be provided on compliance with legal requirements, use of software packages and additional features. All this information is ideally supported by comments that also enable the non-expert to gain better understanding.
|
||||
|
||||
> *On your website, all that is needed is a simple text file stored in an defined location on the server.*
|
||||
|
||||
This actual website is already provided with such a text file. As we obviously use Offen, our own fair web analytics tool, information on it is included in the data. This is what it looks like:
|
||||
|
||||
```
|
||||
# analytics.txt file for www.offen.dev
|
||||
Author: Frederik Ring <hioffen@posteo.de>
|
||||
|
||||
Collects: url, referrer, device-type
|
||||
Stores: first-party-cookies, local-storage
|
||||
# Usage data is encrypted end-to-end
|
||||
Uses: javascript
|
||||
# Users can also delete their usage data only without opting out
|
||||
Allows: opt-in, opt-out
|
||||
# Data is retained for 6 months
|
||||
Retains: P6M
|
||||
|
||||
# Optional fields
|
||||
Honors: none
|
||||
Tracks: sessions, users
|
||||
Varies: none
|
||||
Shares: per-user
|
||||
Implements: gdpr
|
||||
Deploys: offen
|
||||
```
|
||||
|
||||
The original file can be found [here](https://www.offen.dev/.well-known/analytics.txt) and will most likely undergo some changes in the coming months.
|
||||
|
||||
---
|
||||
|
||||
### Looking forward to hear from you
|
||||
|
||||
As already mentioned, `analytics.txt` is available as a draft for now and is awaiting to be discussed. Therefore, we are actively looking for reviewers and welcome any feedback.
|
||||
|
||||
Are there comments on the type and range of fields? Do you have an idea for an application that could consume the provided data? Are you as enthusiastic about fair data transfer as we are?
|
||||
|
||||
Don't hesitate to [reach out to us](mailto:hioffen@posteo.de) and feel invited to take this idea forward together. More information about the standard and its implementation can be found on the dedicated website.
|
||||
|
||||
[View analyticstxt.org](https://www.analyticstxt.org/){: data-button-mb5="full"}
|
||||
@ -6,8 +6,9 @@ sitemap_priority: 0.8
|
||||
|
||||
We optimize Offen to be as simple and easy for everyone to self host. *No additional software is required to run an instance* and hardware requirements are minimal. A basic VPS or even a Raspberry Pi will be all you need to get started.
|
||||
|
||||
Choose your preferred way of running Offen below. Be sure to check out our documentation as well. If you get stuck or need help, [file an issue][gh-issues], [tweet (@hioffen)][twitter] or [email][email].
|
||||
Choose your preferred way of running Offen below. Be sure to check out our [Docs][Docs] as well. If you get stuck or need help, [file an issue][gh-issues], [tweet (@hioffen)][twitter] or [email][email].
|
||||
|
||||
[Docs]: https://docs.offen.dev/running-offen/?utm_campaign=get-started
|
||||
[gh-issues]: https://github.com/offen/offen/issues
|
||||
[twitter]: https://twitter.com/hioffen
|
||||
[email]: mailto:hioffen@posteo.de
|
||||
|
||||
@ -6,8 +6,9 @@ sitemap_priority: 0.1
|
||||
|
||||
Offen always respects your data, which is why *we don't offer a live demo showing you data of real users.* However, it's really easy to get a demo that is populated with random usage data up and running on your system.
|
||||
|
||||
If you get stuck or need help, [file an issue][gh-issues], [tweet (@hioffen)][twitter] or [email][email].
|
||||
If you get stuck or need help, [file an issue][gh-issues], [tweet (@hioffen)][twitter] or [email][email]. Be sure to check out our [Docs][Docs] as well.
|
||||
|
||||
[Docs]: https://docs.offen.dev/running-offen
|
||||
[gh-issues]: https://github.com/offen/offen/issues
|
||||
[twitter]: https://twitter.com/hioffen
|
||||
[email]: mailto:hioffen@posteo.de
|
||||
|
||||
@ -83,11 +83,11 @@ DECORATE_CONTENT = {
|
||||
'h3': ['f3', 'normal', 'mt5', 'ma0', 'mb3'],
|
||||
'h4': ['f5', 'normal', 'mt4', 'ma0', 'mb3'],
|
||||
'h5': ['f5', 'normal', 'mt5', 'ma0', 'mb1'], # text over button
|
||||
'h6': ['f5', 'lh-solid', 'normal', 'ma0', 'light-silver'], # not used
|
||||
'h6': ['f5', 'normal', 'ma0'], # Not used
|
||||
'p': ['ma0', 'pb3'],
|
||||
'blockquote': ['f4', 'ma0', 'ph4-ns', 'pv3'],
|
||||
'blockquote': ['f4', 'ma0', 'ph4-ns', 'pv3', 'mb3'],
|
||||
'blockquote p': ['nb2'],
|
||||
'hr': ['mt5', 'mb3', 'b--black-05']
|
||||
'hr': ['mt5', 'mb3', 'b--black-05'],
|
||||
}
|
||||
|
||||
GITHUB_REPO = 'https://github.com/offen/offen'
|
||||
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 24 KiB After Width: | Height: | Size: 15 KiB |
BIN
homepage/theme/static/images/offen-blog-0180-analyticstxt.jpg
Normal file
BIN
homepage/theme/static/images/offen-blog-0180-analyticstxt.jpg
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 143 KiB |
@ -610,7 +610,7 @@
|
||||
<td class="tl truncate pv2 pl2 pr1">Fully self hosted</td>
|
||||
<td class="truncate pv2 pl2 pr1">
|
||||
<svg width="15" height="15" viewBox="0 0 15 15" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||
<circle cx="7.5" cy="7.5" r="7.5" fill="#CCCCCC"/>
|
||||
<path d="M14 7.5C14 11.0899 11.0899 14 7.5 14C3.91015 14 1 11.0899 1 7.5C1 3.91015 3.91015 1 7.5 1C11.0899 1 14 3.91015 14 7.5Z" stroke="#AAAAAA" stroke-width="2"/>
|
||||
</svg>
|
||||
</td>
|
||||
<td class="truncate pv2 pl2 pr1">
|
||||
@ -634,7 +634,7 @@
|
||||
<td class="tl truncate pv2 pl2 pr1">Open Source code</td>
|
||||
<td class="truncate pv2 pl2 pr1">
|
||||
<svg width="15" height="15" viewBox="0 0 15 15" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||
<circle cx="7.5" cy="7.5" r="7.5" fill="#CCCCCC"/>
|
||||
<path d="M14 7.5C14 11.0899 11.0899 14 7.5 14C3.91015 14 1 11.0899 1 7.5C1 3.91015 3.91015 1 7.5 1C11.0899 1 14 3.91015 14 7.5Z" stroke="#AAAAAA" stroke-width="2"/>
|
||||
</svg>
|
||||
</td>
|
||||
<td class="truncate pv2 pl2 pr1">
|
||||
@ -673,7 +673,7 @@
|
||||
</td>
|
||||
<td class="wx-table-d truncate pv2 pl2 pr1">
|
||||
<svg width="15" height="15" viewBox="0 0 15 15" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||
<circle cx="7.5" cy="7.5" r="7.5" fill="#CCCCCC"/>
|
||||
<path d="M14 7.5C14 11.0899 11.0899 14 7.5 14C3.91015 14 1 11.0899 1 7.5C1 3.91015 3.91015 1 7.5 1C11.0899 1 14 3.91015 14 7.5Z" stroke="#AAAAAA" stroke-width="2"/>
|
||||
</svg>
|
||||
</td>
|
||||
</tr>
|
||||
@ -682,17 +682,17 @@
|
||||
<td class="tl truncate pv2 pl2 pr1">Users can see and manage own data</td>
|
||||
<td class="truncate pv2 pl2 pr1">
|
||||
<svg width="15" height="15" viewBox="0 0 15 15" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||
<circle cx="7.5" cy="7.5" r="7.5" fill="#CCCCCC"/>
|
||||
<path d="M14 7.5C14 11.0899 11.0899 14 7.5 14C3.91015 14 1 11.0899 1 7.5C1 3.91015 3.91015 1 7.5 1C11.0899 1 14 3.91015 14 7.5Z" stroke="#AAAAAA" stroke-width="2"/>
|
||||
</svg>
|
||||
</td>
|
||||
<td class="truncate pv2 pl2 pr1">
|
||||
<svg width="15" height="15" viewBox="0 0 15 15" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||
<circle cx="7.5" cy="7.5" r="7.5" fill="#CCCCCC"/>
|
||||
<path d="M14 7.5C14 11.0899 11.0899 14 7.5 14C3.91015 14 1 11.0899 1 7.5C1 3.91015 3.91015 1 7.5 1C11.0899 1 14 3.91015 14 7.5Z" stroke="#AAAAAA" stroke-width="2"/>
|
||||
</svg>
|
||||
</td>
|
||||
<td class="truncate pv2 pl2 pr1">
|
||||
<svg width="15" height="15" viewBox="0 0 15 15" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||
<circle cx="7.5" cy="7.5" r="7.5" fill="#CCCCCC"/>
|
||||
<path d="M14 7.5C14 11.0899 11.0899 14 7.5 14C3.91015 14 1 11.0899 1 7.5C1 3.91015 3.91015 1 7.5 1C11.0899 1 14 3.91015 14 7.5Z" stroke="#AAAAAA" stroke-width="2"/>
|
||||
</svg>
|
||||
</td>
|
||||
<td class="wx-table-d truncate pv2 pl2 pr1">
|
||||
@ -706,17 +706,17 @@
|
||||
<td class="tl truncate pv2 pl2 pr1">Opt-in only data collection</td>
|
||||
<td class="truncate pv2 pl2 pr1">
|
||||
<svg width="15" height="15" viewBox="0 0 15 15" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||
<circle cx="7.5" cy="7.5" r="7.5" fill="#CCCCCC"/>
|
||||
<path d="M14 7.5C14 11.0899 11.0899 14 7.5 14C3.91015 14 1 11.0899 1 7.5C1 3.91015 3.91015 1 7.5 1C11.0899 1 14 3.91015 14 7.5Z" stroke="#AAAAAA" stroke-width="2"/>
|
||||
</svg>
|
||||
</td>
|
||||
<td class="truncate pv2 pl2 pr1">
|
||||
<svg width="15" height="15" viewBox="0 0 15 15" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||
<circle cx="7.5" cy="7.5" r="7.5" fill="#CCCCCC"/>
|
||||
<path d="M14 7.5C14 11.0899 11.0899 14 7.5 14C3.91015 14 1 11.0899 1 7.5C1 3.91015 3.91015 1 7.5 1C11.0899 1 14 3.91015 14 7.5Z" stroke="#AAAAAA" stroke-width="2"/>
|
||||
</svg>
|
||||
</td>
|
||||
<td class="truncate pv2 pl2 pr1">
|
||||
<svg width="15" height="15" viewBox="0 0 15 15" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||
<circle cx="7.5" cy="7.5" r="7.5" fill="#CCCCCC"/>
|
||||
<path d="M14 7.5C14 11.0899 11.0899 14 7.5 14C3.91015 14 1 11.0899 1 7.5C1 3.91015 3.91015 1 7.5 1C11.0899 1 14 3.91015 14 7.5Z" stroke="#AAAAAA" stroke-width="2"/>
|
||||
</svg>
|
||||
</td>
|
||||
<td class="wx-table-d truncate pv2 pl2 pr1">
|
||||
|
||||
Loading…
Reference in New Issue
Block a user