Exportformat

Der Webanalyse-Export ist ein CSV-Export aller Seitenaufrufe einer Website.

Es gibt keinen einheitlichen “CSV-Standard”; der Export wird mit dem Paket encoding/csv erstellt. Einige Hinweise:

• Die erste Zeile ist die Kopfzeile.
• Leerzeilen sind erlaubt; Zeilen können mit \n oder \r\n enden.
• Felder können optional mit " umschlossen werden: hello,"world"
• Ein " innerhalb eines umschlossenen Feldes wird durch Verdoppelung escaped: hello,"""world"""
• Zeilenumbrüche innerhalb umschlossener Felder sind erlaubt.

CSV-Format

Die erste Zeile ist eine Kopfzeile mit den Feldnamen. Die Felder sind in folgender Reihenfolge:

2,Path	Pfadname (z.B. /a.html). Dient auch als Ereignisname. Diese Kopfzeile ist mit der Version des Exportformats versehen (siehe Versionierung unten).
Title	Übermittelter Seitentitel.
Event	Gibt an, ob dies ein Ereignis ist; true oder false.
User-Agent	Immer leer, da der User-Agent nicht mehr gespeichert wird.
Browser	Browser-Name und Version.
System	Betriebssystem-Name und Version.
Session	Die Session-ID zur Erkennung eindeutiger Besucher.
Bot	Gibt an, ob es sich um eine Bot-Anfrage handelt; 0 wenn nicht, oder einer der isbot-Konstanten wenn doch.
Referrer	Referrer-Daten.
Referrer scheme	h – HTTP; eine URL; g – Generiert; z.B. verschiedene Hacker-News-Oberflächen fügen keinen Link zur jeweiligen Story hinzu und werden daher nur als "Hacker News" erfasst; c – Campaign; Textstring aus einem Campaign-Parameter; o – Sonstiges (z.B. Android-Apps).
Screen size	Bildschirmgröße als x,y,scaling.
Location	ISO-3166-2-Ländercode (entweder "US" oder "US-TX")
FirstVisit	Erster Aufruf in dieser Session?
Date	Erstellungsdatum nach RFC 3339/ISO 8601.

Versionierung

Das Format der CSV-Datei kann sich in Zukunft ändern; die Version der Exportdatei wird am Anfang der Kopfzeile als Zahl angegeben. Es wird dringend empfohlen, diese Zahl zu prüfen, wenn Sie ein Skript zum Importieren oder Synchronisieren von Daten verwenden, und bei einer Änderung einen Fehler auszuwerfen. Künftige Inkompatibilitäten werden hier dokumentiert.

Dokumentation Version 1

Die erste Zeile ist eine Kopfzeile mit den Feldnamen. Die Felder sind in folgender Reihenfolge:

1,Path	Pfadname (z.B. /a.html). Dient auch als Ereignisname. Diese Kopfzeile ist mit der Version des Exportformats versehen (siehe Versionierung unten).
Title	Übermittelter Seitentitel.
Event	Gibt an, ob dies ein Ereignis ist; true oder false.
Bot	Gibt an, ob es sich um eine Bot-Anfrage handelt; 0 wenn nicht, oder einer der isbot-Konstanten wenn doch.
Session	Die Session-ID zur Erkennung eindeutiger Besucher.
FirstVisit	Erster Aufruf in dieser Session?
Referrer	Referrer-Daten.
Referrer scheme	h – HTTP; eine URL; g – Generiert; z.B. verschiedene Hacker-News-Oberflächen fügen keinen Link zur jeweiligen Story hinzu und werden daher nur als “Hacker News” erfasst; c – Campaign; Textstring aus einem Campaign-Parameter; o – Sonstiges (z.B. Android-Apps).
Browser	User-Agent-Header.
Screen size	Bildschirmgröße als x,y,scaling.
Location	ISO-3166-1-Ländercode.
Date	Erstellungsdatum nach RFC 3339/ISO 8601.

Import in SQL

Für eigene Auswertungen können Sie die Daten z.B. in SQLite importieren:

sqlite> .import --csv gc_export.csv gc_export
sqlite> select
   ...>   count(*) as count,
   ...>   substr(Location, 0, 3) as location
   ...> from gc_export
   ...> where location != ''
   ...> group by location
   ...> order by count desc
   ...> limit 20;
┌────────┬──────────┐
│ count  │ location │
├────────┼──────────┤
│ 113144 │ US       │
│ 27092  │ DE       │
│ 24131  │ GB       │
│ 13269  │ CA       │
│ 12977  │ FR       │
│ 9785   │ NL       │
│ 8150   │ IN       │
│ 7487   │ AU       │
│ 6864   │ PL       │
│ 6760   │ SE       │
└────────┴──────────┘

Oder PostgreSQL:

=# create table gc_export (
    "2Path"             varchar,
    "Title"             varchar,
    "Event"             varchar,
    "UserAgent"         varchar,
    "Browser"           varchar,
    "System"            varchar,
    "Session"           varchar,
    "Bot"               varchar,
    "Referrer"          varchar,
    "Referrer scheme"   varchar,
    "Screen size"       varchar,
    "Location"          varchar,
    "FirstVisit"        varchar,
    "Date"              varchar
);

=# \copy gc_export from 'gc_export.csv' with (format csv, header on);

Bei Fragen oder Schwierigkeiten stehen wir Ihnen gern zur Verfügung. Die meisten Probleme lassen sich schnell klären.

Kontakt aufnehmen: anzeigen