Skip to content
This repository has been archived by the owner on May 21, 2021. It is now read-only.

Collected Data

Thomas Greiner edited this page Mar 13, 2018 · 1 revision

This is an overview of the data that is collected while using the Flattr extension. You can find out more about when and why we collect certain data at flattr.com/privacy.

Formats

Manual data export

[
  [<timestamp>, <tab ID>, <name>, <value>],
  ...
]

Automatic data submission

{
  "error": <error message>
  "name": <feedback interval name>,
  "source": <extension ID>,
  "data": [
    [<timestamp>, <tab ID>, <name>, <value>],
    ...
  ]
}

Names and Values

Extension events

Object authenticated – The user authenticated with a Flattr account.

Object started – The extension was started.

  • string build - build ID (<git-revision-number>/<git-revision-hash>)
  • string version - extension version (as specified in extension manifest)

string updated – The extension was updated (see OnInstalledReason).

Browser events

string idle – The idle state changed (see IdleState).

Tab events

boolean audible – The tab changed from/to being audible.

Object attached – The tab was attached to a window.

  • number index – The position of the tab in a new window.
  • number windowId – The ID of the new window.

Object created – The tab was created.

  • number index – The position of the tab in a window.
  • number openerId – The ID of the tab from which it was created.
  • number windowId – The ID of the window in which it was created.

Object detached – The tab was detached from a window.

  • number index – The position of the tab in the old window.
  • number windowId – The ID of the old window.

Object moved – The tab was moved.

  • number index – The new position of the tab in a window.
  • number windowId - The ID of the window to which it was moved.

boolean muted – The tab changed from/to being muted.

number page-loaded – The page loaded successfully with the given HTTP response status code.

(null) removed – The tab was removed.

(null) selected – The tab was selected.

(null) selected-initial – The selected state of the tab on extension start.

string title – The tab title changed.

URL|(null) url – The tab location changed.

number zoom – The tab's zoom level changed.

Object state – The state of the tab on extension start.

  • boolean audible
  • number index – The position of the tab in a window.
  • boolean muted
  • boolean selected
  • string title
  • URL|(null) url
  • number windowId

Content events

string|(null) author – The author ID (only on domains with multiple authors).

(null) keypressed – The key was pressed.

(null) pointerclicked – The mouse was clicked.

(null) pointermoved – The mouse was moved.

Object scrolled-start – The page scrolling action was started.

  • number height – The total page height.
  • number width – The total page width.
  • number x – The absolute x-coordinate on the page.
  • number y – The absolute y-coordinate on the page.

Object scrolled-ongoing – The page scrolling action is still in progress.

  • number height – The total page height.
  • number width – The total page width.
  • number x – The absolute x-coordinate on the page.
  • number y – The absolute y-coordinate on the page.

Object scrolled-end – The page scrolling was finished.

  • number height – The total page height.
  • number width – The total page width.
  • number x – The absolute x-coordinate on the page.
  • number y – The absolute y-coordinate on the page.

User events

(null) user-flattr-added – The user manually flattred a URL.

(null) user-flattr-viewed – The user viewed list of flattrs.

(null) user-notification-dismissed – The user dismissed the notification in the icon pop-up.

Status user-status-changed – The user changed the status of an entity.

Special properties

URL
  • string entity – The entity the URL belongs to that should be flattred.
  • Object status – The status of the URL.
    • Status combined – The aggregate status.
    • Status preset – The status based on the default list.
    • Status user – The status based on the user list.
  • string url – The page URL.
Status

Values

  • 0: undefined
  • 1: enabled
  • 2: disabled
  • 3: blocked

Notes:

  • entity and url are substituted before automatic data submission with a non-invertible number.
  • entity is not substituted if it is a domain that is known to have multiple authors.
  • title strings are removed before automatic data submission.