Zum Hauptinhalt springen
Pro Plan5 minutesEinsteiger

Wie trackt Zenovay Datei-Downloads auf meiner Website?

Zenovay zeichnet Datei-Downloads automatisch auf, wenn Besucher auf Download-Links klicken — ohne Codeänderungen. Hier erfahren Sie, was erfasst wird, wo Sie es sehen und wie Sie einen einzelnen Link ausnehmen.

downloadsfile-trackingtracker-api
Zuletzt aktualisiert:

Download-Tracking erfasst, wenn ein Besucher eine Datei von Ihrer Website herunterlädt. Das Tracking-Skript erfasst diese Ereignisse automatisch, sobald es installiert ist — ohne Codeänderungen erforderlich, auf jedem Plan. Um die Daten anzuzeigen, öffnen Sie das Dashboard Ihrer Website und wählen Sie die Registerkarte Downloads, die zur Funktion Download Analytics auf Pro und höher gehört.

Was als Download zählt

Zenovay erfasst einen Download, wenn ein Besucher eines der folgenden Ereignisse auslöst:

  • Ein Link zu einer herunterladbaren Datei — ein <a href>, dessen URL-Pfad auf eine bekannte Dateiendung endet: pdf, zip, exe, dmg, pkg, msi, apk, csv, xls, xlsx, doc, docx, ppt, pptx, mp4, mp3, wav, mov, avi, rar, 7z, tar, gz, tgz, iso, deb oder rpm.
  • Jeder <a download>-Link — unabhängig von der Dateiendung behandelt Zenovay einen Anker mit dem download-Attribut als Datei-Download.
  • Ein JavaScript-generierter (Blob-)Download — wenn Ihr Code eine temporäre blob:-URL erstellt und einen Speichern-Dialog auslöst.

Wo Sie es sehen

Öffnen Sie das Dashboard Ihrer Website und wählen Sie die Registerkarte Downloads (unter der Gruppe Audience in der Seitenleiste). Diese Ansicht ist Teil von Download Analytics, verfügbar auf den Plänen Pro, Scale und Enterprise. Die Registerkarte ist nur für angemeldete Eigentümer und Teammitglieder sichtbar — sie wird nicht auf öffentlichen oder gemeinsamen Dashboards angezeigt, da Dateipfade und -namen interne Strukturen preisgeben könnten, die Sie möglicherweise nicht öffentlich teilen möchten.

Die Registerkarte zeigt:

  • Top-Downloads — eine nach Download-Anzahl sortierte Tabelle der Dateien mit Anzahl eindeutiger Downloader, Dateigröße (sofern verfügbar) und durchschnittlicher Abschlusszeit (sofern messbar).
  • Downloads im Zeitverlauf — ein Flächendiagramm des Download-Volumens für den gewählten Zeitraum.
  • Aufschlüsselungen — Downloads nach Gerätetyp, Land und Traffic-Quelle.
  • Download-Abschluss — eine Zusammenfassung darüber, wie viele Downloads bestätigt abgeschlossen wurden (gilt für Blob-/Fetch-Downloads, bei denen das Timing messbar ist, und für vom Browser verwaltete Links, die eine Größe melden).

Datumsbereiche und Datenspeicherung

PlanAufbewahrung von Analysedaten
Kostenlos1 Jahr
Pro2 Jahre
Scale4 Jahre
EnterpriseBenutzerdefiniert

Dateigröße und Abschlusszeit

Dateigröße wird für Same-Origin-Downloads angezeigt (Dateien, die von Ihrer eigenen Domain bereitgestellt werden). Bei Cross-Origin-Dateien (gehostet auf einem CDN oder einer Drittanbieter-Domain) ist die Größe nur verfügbar, wenn der Dateiserver permissive CORS-Header sendet — andernfalls zeigt die Spalte „—".

Abschlusszeit ist nur bei Blob- und Fetch-Downloads messbar, bei denen der Browser die Übertragung an JavaScript übergibt und Zenovay den Abschluss beobachten kann. Bei gewöhnlichen <a href>-Dateilinks übernimmt der Browser die Übertragung vollständig im eigenen Download-Manager, und das Abschlusssignal ist nicht abfangbar — die Spalte zeigt für diese Zeilen „—". Das ist erwartetes Verhalten, keine Tracking-Lücke.

Wenn ein Link die Download-Kriterien erfüllt, aber nicht getrackt werden soll, fügen Sie dem Anker das Attribut data-download hinzu:

<a href="/files/report.pdf" data-download>Download report (nicht getrackt)</a>

Zenovay unterdrückt das Tracking für alle <a>-Elemente, die das data-download-Attribut tragen.

Browser-Kompatibilität

Download-Tracking funktioniert in Chrome, Firefox und Safari.

Datenschutz

Download-Tracking verwendet denselben Tracker, der sich bereits auf Ihrer Seite befindet — es werden keine neuen Cookies gesetzt und kein localStorage verwendet. Es funktioniert im Cookie-freien Modus, bei dem fensterseitige In-Memory-Identifikatoren anstelle von persistentem Speicher genutzt werden. Besucher, die ein Global-Privacy-Control- oder Do-Not-Track-Signal senden, werden per Design nicht getrackt und erscheinen nicht in der Registerkarte.

So testen Sie es

  1. Öffnen Sie eine Seite auf Ihrer Website, die einen Link zu einer herunterladbaren Datei enthält.
  2. Klicken Sie auf den Link, um einen Download auszulösen.
  3. Melden Sie sich bei app.zenovay.com an, öffnen Sie die Website und wählen Sie die Registerkarte Downloads.

Der Download sollte innerhalb weniger Sekunden erscheinen. Falls nicht, überprüfen Sie, ob das Tracking-Skript installiert ist und der Link eine der oben genannten Dateiendungen oder Attribute aufweist.

Verwandte Artikel

War dieser Artikel hilfreich?