Was ist ein Datenexport?

Available for the following Plan Types:

Fullstory Enterprise

Fullstory Advanced

Fullstory | Business

Fullstory für mobile Apps

Die Fullstory ist kostenlos.

Available for the following User roles:

Admin

Architekt:in

Standard


What information is available with Data Export?

Unten findest du eine vollständige Liste der Datenexportinhalte.

Wie verwende ich die Informationen aus dem Datenexport?

Die Möglichkeiten sind endlos! Dieser Datensatz kann eigenständig oder als Ergänzung zu bestehenden Modellen zur Analyse des Benutzerverhaltens verwendet werden. Du kannst die Daten einfach verwenden, um deinem Marketingteam ein Point-and-Click-Analysetool zur Verfügung zu stellen. Du kannst es z. B. auch in deinen Betrugserkennungsalgorithmus einbinden, um deinem Modell äußerst leistungsfähige Daten hinzuzufügen. In jedem Fall weißt aber du natürlich am besten, welche Daten für deine Geschäftsanforderungen am relevantesten sind.

Wann sind Daten im Datenexport verfügbar?

Datenexporte werden „on demand“ generiert, d. h. die Daten in den JSON-Dateien werden direkt von unseren Servern abgerufen, wenn der Export angefordert wird.

Die meisten Ereignisse sind etwa 30 Minuten nach dem Auftreten des Ereignisses im Datenexport verfügbar. Einige der Daten können jedoch zum Zeitpunkt des Exports noch nicht „finalisiert“ sein. Fullstory wendet Logik an, um die Daten der Ereignisse nützlicher zu machen, sodass kürzlich erfasste Ereignisse aktualisiert werden können, wenn mehr Informationen einfließen. Beispiele hierfür sind das Verknüpfen von Ereignissen mit einer Person über FS.identify, das Berechnen von Metriken wie die aktive Session-Zeit oder das Erhalten von Abgesang-Bundles. Da einige Sessions Stunden dauern können, können sich die exportierten Daten ändern, je nachdem, wann du den Export ausführst.

Fullstory empfiehlt, 24 Stunden zu warten, bevor du Daten exportierst, wenn du nach endgültigen Werten suchst, die über mehrere Exportläufe hinweg statisch bleiben. Es ist möglich, Daten näher an der Echtzeit zu exportieren. Wenn du dich für diesen Weg entscheidest, empfehlen wir, dass deine Pipeline ein rollierendes Exportfenster mit überlappenden Zeiträumen, Deduplizierung und Aktualisierung von Datensätzen mit aktuelleren Werten berücksichtigt.

Datenexportdateien stehen ab Abschluss des Exports 7 Tage lang zum Download zur Verfügung. Die Ablaufzeit der Datei findest du auch in der API.

Wie interagiert die Benutzerlöschung mit dem Datenexport?

Alle Datenexporte werden „on demand“ generiert. Das bedeutet, dass wenn du heute „Max Mustermann“ löschst und morgen Datendateien exportierst, sich die Daten von Max Mustermann nicht in diesen Datendateien befinden, da Fullstory nicht mehr über die Daten des Benutzers verfügt, die in die Datei aufgenommen werden können. 

Wenn du Datenexportdateien täglich abrufst, können die Daten, die du abrufst und auf deinen Servern speicherst, personenbezogene Daten enthalten. Das bedeutet: Wenn ein:e Benutzer:in eine Löschung anfordert, musst du möglicherweise auch die Daten dieser Person aus dem Data Warehouse löschen, in dem du die Datenexporte von Fullstory speicherst.

Wie weit in die Vergangenheit kann ich Daten exportieren?

Die Verfügbarkeit von Datenexporten entspricht der Retention-Dauer für Produktanalysen, die du derzeit abonniert hast. Das bedeutet, dass du Daten exportieren kannst, die bis zu 12 Monate alt sind, wenn dein Konto für eine 12-monatige Retention von Produktanalysen konfiguriert ist. Es ist wichtig zu beachten, dass Daten, sobald sie ablaufen und gelöscht werden, keinesfalls wiederherstellbar sind.

Wie lange sollte ich mit dem Exportieren von Daten warten?

Beim Exportieren von Daten ist eine Verzögerung erforderlich, da zwischen der Aufzeichnung eines Ereignisses und seiner Verfügbarkeit und Vollständigkeit eine gewisse Latenzzeit besteht. 24 Stunden ist der Standard, wobei es sich dabei um einen vorsichtigen Wert handelt. In vielen Fällen kann dies sicher auf 3 Stunden reduziert werden. Beachte aber, dass Ereignisse aus „Abgesängen“ möglicherweise nicht verfügbar sind.


Inhalt des Datenexports

 

Benutzer-/Session-Felder

Name Name des Exportfelds

Beschreibung

Benutzer-ID UserId Eine eindeutige Kennung für ein Benutzer-Cookie auf einem bestimmten Gerät/Browser. Diese ID kann zurückgesetzt werden, wenn der:die Benutzer:in seine Cookies löscht, das Gerät wechselt, den Browser ändert usw.

Dieses Feld ist in der Fullstory-Benutzeroberfläche nicht sichtbar – siehe „UserAppKey“ unten für weitere Informationen.
Benutzer-App-Schlüssel UserAppKey Die Benutzerkennung, die von deinem System mit FS.identify an Fullstory übergeben wurde.

Dieses Feld ist in der Fullstory-Benutzeroberfläche als „Benutzer-ID“ sichtbar, wenn du dir das Profil eines:einer Benutzer:in ansiehst.
Individuelle ID IndvId

Eine eindeutige Kennung für die Einzelperson, die alle Benutzer:innen mit demselben Benutzer-App-Schlüssel kombiniert. Wenn du beispielsweise Benutzer 123 identifiziert hast, wenn er deine Website besucht, werden für seine Person alle seine Sessions auf allen Geräten, Browsern usw. zusammengefasst.

Der IndvdId-Wert ist in der Fullstory-Benutzeroberfläche nicht sichtbar, aber er ist Teil der Session-URL.

 

Beispiel:

https://app.fullstory.com/ui/<ORG_ID>/session/<INDVID>:<SESSIONID>

 

Session-ID SessionId Die Kennung für eine bestimmte Session im Kontext eines:einer einzelne:n Benutzer:in. Verwende die Session-ID und die Benutzer-ID kombiniert als zusammengesetzten Schlüssel, um Sessions in allen Exportdaten eindeutig zu identifizieren.
E-Mail-Adresse des:der Benutzer:in UserEmail Die E-Mail-Adresse, die über FS.identify oder FS.setUserVars festgelegt wurde.
Anzeigename des:der Benutzer:in UserDisplayName Der Anzeigename, der über FS.identify oder FS.setUserVars festgelegt wurde.
IP-Adresse PageIp Die zu Beginn der Session erfasste IP-Adresse.
Benutzerdefinierte Benutzervariablen (custom var name) Wenn du Benutzervariablen an Fullstory übergibst, werden wir sie in den Export aufnehmen. Jede zusätzliche Variable erscheint als separates Feld in der Exportdatei, wobei der Feldname der Variablenname ist, wie er für die Funktion FS.setUserVars bereitgestellt wird. Beachte, dass beim Laden von Export-Bundles in Redshift oder BigQuery mit hauser die benutzerdefinierten Variablenfelder vor dem Import in die Export-Staging-Tabelle in einem einzigen JSON-Dokument unter einem Feld namens „CustomVars“ zusammengeführt werden.
Zeitstempel für erstellte:n Benutzer:in UserCreated UTC RFC 3339-Zeitstempel für den Zeitpunkt, zu dem das mit UserId verbundene Cookie zum ersten Mal gesehen wurde.
Zeitstempel für Session SessionStart Die absolute Uhrzeit in UTC, zu der die Session gestartet wurde, dargestellt als dateTime aus der XML-Schemaspezifikation, z. B. 2018-01-04T20:07:11.191Z.
Anfrage-URL ReqURL Die URL für die entsprechende XHR-Anfrage, wenn EventType „request“ ist.
Status der Anfrage ReqStatus Der HTTP-Antwort-Statuscode für die entsprechende XHR-Anfrage, wenn der EventType „request“ ist.

Seitenfelder

Eine „Seite“ verfolgt jeden Fall, in dem ein:e Benutzer:in eine Seite mit einer bestimmten URL geladen hat. Die „PageId“ ist eine ID, die angibt, dass die Seite vom Webserver geladen oder aktualisiert wurde. Eine Reihe von Ereignissen für eine einzelne Session kann eine PageId und mehrere PageURLs haben, wenn es sich um eine Single Page App handelt, die einmal vom Server geladen wird (eine PageId) und dann die URLs ändert, ohne erneut vom Server zu laden (ein gängiges Muster).

Name Name des Exportfelds Beschreibung
Seiten-ID PageId Die Kennung für das Laden/die Aktualisierung einer bestimmten Seite im Kontext einer einzelnen Session. Verwende die Seiten-ID, Session-ID und Benutzer-ID kombiniert als zusammengesetzten Schlüssel, um Seiten in allen Exportdaten eindeutig zu identifizieren.
Zeitstempel für den Seitenstart PageStart Die absolute Uhrzeit in UTC, zu der die Seite als dateTime aus der XML-Schemaspezifikation dargestellt wurde, z. B. 2018-01-04T20:07:11.191Z.
Seiten-URL PageUrl Die vollständige URL der Seite, auf der das angegebene Ereignis aufgetreten ist.
Dauer des Seitenbesuchs PageDuration Die Gesamtzeit, die diese:r Benutzer:in während dieser Session auf dieser Seite verbracht hat (Millisekunden). Dies ist keine laufende Summe. Jedes Ereignis für eine bestimmte Seite zeigt die gleiche Gesamtdauer.
Dauer des aktiven Besuchs der Seite PageActiveDuration Die aktive Zeit (Mausbewegung, Texteingabe, Klicks usw.), die diese:r Benutzer:in während dieser Session auf dieser Seite verbracht hat (Millisekunden).  Dies ist keine laufende Summe. Jedes Ereignis für eine bestimmte Seite zeigt die gleiche Gesamtdauer.
Seiten-Referrer-URL PageRefererURL Die Seite, von der der:die Benutzer:in auf diese Seite gelangt ist. Der Referrer kann leer sein, wenn der:die Benutzer:in die Seiten-URL manuell eingegeben hat oder wenn der Referrer gereinigt wurde usw.
Anzahl der Ereignisse auf einer Seite PageNumEvents Die Gesamtzahl der Ereignisse, die im Lebenszyklus des Browser-Tabs aufgetreten sind (der Zeitpunkt, zu dem die HTML-Seite zum ersten Mal gerendert und angezeigt wurde, bis der:die Endbenutzer:in zu einer neuen Webseite navigierte oder den Tab schloss).
Von Fullstory abgeleitete Ereignisse PageNumDerivedEvents Die Gesamtzahl der von Fullstory abgeleiteten Ereignisse, die auf der Seite aufgetreten sind. Dazu gehören FS-API-Validierungsereignisse wie Rate-Limit- und ungültige Argumente.
Bildschirmbreite PageScreenWidth Die Breite der CSS-Auflösung des Bildschirms in Pixel.
Bildschirmhöhe PageScreenHeight Die Höhe der CSS-Auflösung des Bildschirms in Pixel.
Breite des Darstellungsfelds PageViewportWidth Die Breite des Darstellungsfelds des Browsers in Pixel.
Höhe des Darstellungsfelds PageViewportHeight Die Höhe des Darstellungsfelds des Browsers in Pixel.
Page-Insights-IDs PageClusterId Eine interne Kennung, die von Fullstory verwendet wird, um Seiten für die Analyse von Page Insights zu gruppieren.

 

Ereignisfelder

Name Name des Exportfelds Beschreibung
Ereigniszeit EventStart Die absolute Uhrzeit in UTC, zu der das Ereignis aufgetreten ist, dargestellt als dateTime aus der XML-Schemaspezifikation, z. B. 2018-01-04T20:07:11.191Z.
Ereignistyp EventType Die Art des erfassten Ereignisses. Häufige Typen sind:
  • „abandon“: Ein Formular wurde abgebrochen. Erfahre mehr über das Abbrechen von Formularen.
  • „change“: Der Text in einem Texteingabefeld wurde geändert. Das Ereignisziel-Textfeld enthält den neuen Textwert.
  • „click“: Ein Element auf der Seite wurde angeklickt. Das Ereignisziel-Textfeld enthält ggf. den Text des angeklickten Elements.
  • „custom“: Ein benutzerdefiniertes Ereignis, das über die REST-API (Serverereignisse) oder FS.event gesendet wurde.
  • „navigate“: Ein URL-Wechsel, entweder zu einer komplett neuen Seite oder einem neuen Hash-Fragment.
  • „thrash“: Der:die Benutzer:in hat den Mauszeiger unregelmäßig oder im Kreis bewegt. Erfahre mehr über Thrashed Cursor.
  • „load“: Eine Seite wurde vom Server geladen. Dies kann ein passendes „navigate“-Ereignis haben.
  • „request“: Eine XHR-Anfrage wurde vom Browser initiiert.
  • „seen“: Ein beobachtetes Element war im Browser sichtbar.
Ereignisziel-Text EventTargetText Gegebenenfalls enthält dies den Text des Ereignisziels und seiner untergeordneten Elemente. Wenn ein:e Benutzer:in beispielsweise auf die Schaltfläche „Jetzt bezahlen“ geklickt hat, lautet der Zieltext des Ereignisses „Jetzt bezahlen“. Langer Text kann in einigen Fällen aus Performancegründen abgeschnitten werden.
Ereignisziel-Selektor EventTargetSelector Gegebenenfalls enthält dies den CSS-Selektor für das Ereignisziel. Dies ist ein vollständig qualifizierter untergeordneter Selektor, beginnend mit dem HTML-Element und einschließlich aller CSS-Selektoren von Elementen, die im DOM erscheinen (vom HTML-Element über seine untergeordneten Elemente zum Ereignisziel). Die meisten nicht alphanumerischen Zeichen innerhalb eines Selektors werden kodiert, z. B. „.my%2Dclass“ statt „.my-class“.
Name des benutzerdefinierten Ereignisses EventCustomName Der Name des Ereignisses, wenn es sich um ein benutzerdefiniertes Ereignis handelt. Das EventType-Feld hat für benutzerdefinierte Ereignisse ebenfalls den Wert „custom“.

Verhaltensheuristik

Bei einigen Ereignissen wird eines einer Reihe von Modifikatorfeldern festgelegt, um zusätzliche Informationen zum Benutzerverhalten bereitzustellen.

Name Name des Exportfelds Beschreibung
Rage Clicks EventModFrustrated Dein:e Kund:in hat viele Male schnell hintereinander auf ein oder mehrere Elemente auf der Seite geklickt, möglicherweise weil er:sie frustriert war. Der numerische Wert dieses Felds ist eine laufende Summe der Anzahl der aufgetretenen Klicks (jeder Klick in der Reihe von Klicks wird gezählt). Für Klickereignisse, die nicht Teil einer Reihe von Rage Clicks waren, ist der Wert „0“. Erfahre mehr über Rage Clicks.
Dead Clicks EventModDead Dein:e Kund:in hat etwas angeklickt, aber es ist nichts passiert. Der Wert ist „1“ für Dead Clicks und „0“ für andere Klicks (nicht Dead Clicks).
Error Clicks EventModError

Dein:e Kund:in hat auf etwas geklickt und es wurde ein Konsolenfehler generiert, entweder durch einen tatsächlich aufgetretenen Fehler oder durch Protokollieren eines Fehlers in der Konsole. Häufige Typen sind:

  • 0 Das Ereignis hat keinen Fehler generiert.
  • 1 Das Ereignis hat einen Fehler generiert.*
  • 2 Das Ereignis hat einen Konsolenfehler generiert.
  • 3 Das Ereignis hat eine nicht erfasste Ausnahme generiert.

* Vor dem 21.06.2021 wurde in diesem Feld nicht zwischen verschiedenen Arten von Fehlern unterschieden.

Verdächtige Aktivitäten EventModSuspicious Dein:e Kund:in hat Text eingegeben oder zu einer verdächtigen URL navigiert. 0 bedeutet, dass nichts verdächtig war. 1 weist auf einen möglichen SQL-Injection-Angriff hin. 2 weist auf einen möglichen Cross-Site-Scripting-Angriff hin. Erfahre mehr über die Erkennung verdächtiger Aktivitäten.
Fehlertyp-Token EventVarErrorKind Fehlertyp-Token, das einen Fehler (wenn ein Fehler vorhanden ist) für dieses Ereignis angibt. Wird normalerweise nur bereitgestellt, wenn EventType mit „_error“ endet.
Feldfehler EventVarFields Fehlerrelevante Felder (sofern ein Fehler vorliegt). Wird normalerweise verwendet, um benutzerdefinierte Eigenschaften anzugeben, die einen Fehler ausgelöst haben.

 

Konsolenstatistik

Name Name des Exportfelds Beschreibung
Konsoleninfos/Logs PageNumInfos Die Anzahl der Aufrufe der JavaScript-Funktion console.log() plus die Anzahl der Aufrufe von console.info() auf der Seite. Dies ist eine laufende Summe für die Seite, die stetig ansteigt, bis der:die Benutzer:in zu einer neuen Seite navigiert.
Konsolenwarnungen PageNumWarnings Die Häufigkeit, mit der console.warn() auf der Seite aufgerufen wurde. Es handelt sich dabei um eine laufende Summe für die Seite.
Konsolenfehler PageNumErrors Die Anzahl der Aufrufe von console.error() plus die Anzahl der JavaScript-Fehler, die auf der Seite aufgetreten sind. Dies ist eine laufende Summe für die Seite.

 

Umgebungsfelder

Name Name des Exportfelds Beschreibung
Breiten-/
Längengrad
PageLatLong Der Breiten-/Längengrad, der dieser Session entspricht. Diese Werte werden mithilfe der IP-Geolokalisierung abgeleitet, die nur den allgemeinen Bereich eines:einer Benutzer:in lokalisieren kann (oft nur auf Stadtebene, nicht der genaue Standort).
Benutzer-Agent PageUserAgent Der vollständige Benutzer-Agent-String für das System, auf dem diese Session erfasst wurde.
Browser PageBrowser Der Browser, der für diese Session verwendet wurde, wie vom Benutzer-Agent abgeleitet. Aktuell mögliche Werte: Chrome, Firefox, Internet Explorer, Microsoft Edge, Safari, Opera, Mobile App, Yandex, Robot, Unbekannt. Dieser Liste können zu einem späteren Zeitpunkt neue Werte hinzugefügt werden.
Browser-Version PageBrowserVersion Die Browser-Version, die für diese Session verwendet wurde, wie vom Benutzer-Agent abgeleitet. Aktuell mögliche Werte entsprechen dem unterstützten Browser. 
Gerät PageDevice Der Gerätetyp, der für diese Session verwendet wurde, wie vom Benutzer-Agent abgeleitet. Aktuell mögliche Werte: Desktop, Mobil, Tablet, Roboter, Unbekannt. Dieser Liste können zu einem späteren Zeitpunkt neue Werte hinzugefügt werden.
Betriebssystem PageOperatingSystem Das Betriebssystem, das für diese Session verwendet wurde, wie vom Benutzer-Agent abgeleitet. Aktuell mögliche Werte: Chrome OS, OS X, iOS, Windows, Windows Phone, Linux, Robot, Unbekannt. Dieser Liste können zu einem späteren Zeitpunkt neue Werte hinzugefügt werden.
Plattform PagePlatform Die Plattform, die für diese Session verwendet wurde.

Aktuell mögliche Werte: Web, Native Mobile

 

Dev-Tools-Felder

Alle folgenden Felder stellen die Dauer (in Millisekunden) seit dem Beginn des Ladens der Seite dar, bis das entsprechende Ereignis ausgelöst wurde.

DOM-Inhalt wurde geladen LoadDomContentTime DOMContentLoaded wird ausgelöst, wenn das anfängliche HTML-Dokument geladen und analysiert wurde. Dieser Meilenstein tritt häufig auf, bevor das Laden von Stylesheets, Bildern und Subframes abgeschlossen ist, sodass das DOMContentLoaded-Ereignis auftritt, bevor der Paint einer Seite fertig ist.
Seitenladezeit LoadEventTime Das onload-Ereignis oder „Page Load“ wird ausgelöst, wenn die gesamte Seite und alle ihre abhängigen Ressourcen vollständig geladen sind. Der Page Load erfolgt häufig später, nach dem Zeitpunkt, zu dem die Seite gerendert und für eine:n Benutzer:in interaktiv ist.
First Contentful Paint LoadFirstPaintTime Das First Contentful Paint-Ereignis bezieht sich auf den Moment, in dem die größte Layout-Änderung des sichtbaren Bereichs stattgefunden hat und wenn Web-Fonts geladen wurden. Wir sind der Meinung, dass diese Metrik am ehesten mit der Erfahrung des:der Benutzer:in in Bezug auf die Wahrnehmung, dass eine Seite „geladen“ ist, übereinstimmt.

 

Hinweis: Zusätzliche Felder für Fullstory für mobile Apps sind unten in unserer Entwicklerdokumentation hier verfügbar.

Need to get in touch with us?

The Fullstory Team awaits your every question.

Ask the Community Technical Support