Zum Hauptinhalt springen
4 Min. Lesedauer

Download-Tracking

Sehen Sie, welche Dateien Ihre Besucher herunterladen, von welchen Geräten und Ländern aus Downloads erfolgen und wie sich Downloads über die Zeit entwickeln — alles automatisch erfasst, ohne Codeänderungen.

Überblick

Zenovay erfasst automatisch ein download_start-Ereignis, sobald ein Besucher auf Ihrer Website auf einen Link zu einer herunterladbaren Datei klickt. Die Daten erscheinen in Ihrem Dashboard unter App → Ihre Website öffnen → Tab „Downloads".

Der Downloads-Tab ist nur für authentifizierte Website-Inhaber und Teammitglieder sichtbar. Er wird auf öffentlich geteilten Dashboards absichtlich ausgeblendet, da Datei-URLs und Dateinamen interne Pfade offenbaren können.

Das Download-Tracking ist Teil des Zenovay-Tracking-Skripts. Es arbeitet zusammen mit Automatisch erfassten Ereignissen — keine separate Installation oder Konfiguration ist erforderlich.

Was automatisch erfasst wird

Ein download_start-Ereignis wird ausgelöst, wenn ein Besucher auf eines der folgenden klickt:

  • Einen <a>-Link, dessen Pfad auf eine erkannte 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, rpm
  • Jeden <a download>-Link (unabhängig von der Dateiendung)
  • Einen per JavaScript erzeugten Blob-Download (z. B. dynamisch generierte PDFs)

Da Zenovay navigator.sendBeacon verwendet, wird das Ereignis zuverlässig übertragen, auch wenn der Klick einen Datei-Download auslöst, der den Browser von der Seite wegnavigiert.

Keine Codeänderungen erforderlich. Sobald das Zenovay-Tracking-Skript installiert ist, funktioniert das Download-Tracking einfach.

Dateigröße

  • Bei Same-Origin-Downloads (Dateien, die von derselben Domain wie Ihre Website bereitgestellt werden) erfasst Zenovay die Dateigröße automatisch.
  • Bei Cross-Origin-Downloads (Dateien auf einer anderen Domain) wird die Dateigröße nur erfasst, wenn es die CORS-Richtlinie des Dateiserver erlaubt. Ist dies nicht der Fall, zeigt die Spalte „Größe" „—".

Abschluss-Timing von Downloads

Das Abschluss-Timing ist nur für In-App- oder programmgesteuerte (fetch + blob) Downloads verfügbar — zum Beispiel eine Schaltfläche, die eine PDF-Datei abruft und einen Blob-Download in JavaScript auslöst.

Bei gewöhnlichen browserseitig verwalteten Dateilinks (dem üblichen <a href> zu einer Datei) übernimmt der Browser die gesamte Übertragung. Die Webplattform stellt keine API bereit, um zu messen, wie lange der Download dauert. Die Spalte „Durchschn. Zeit" zeigt daher „—" für diese Downloads an. Dies ist eine echte Browserbeschränkung, keine Einschränkung von Zenovay.

Wenn Sie das Abschluss-Timing für eine Datei benötigen, implementieren Sie den Download über fetch() und URL.createObjectURL(). Zenovay kann dann die vollständige Übertragung messen.

Fügen Sie das Attribut data-download zu einem Ankerelement hinzu, um es vollständig vom Download-Tracking auszuschließen:

Einen Link vom Download-Tracking ausschließenHTML
<!-- Dieser Link wird NICHT als Download erfasst -->
<a href="/internal-report.pdf" data-download>Bericht herunterladen</a>

Browserübergreifende Unterstützung

Download-Tracking funktioniert in Chrome, Firefox und Safari. Es verwendet navigator.sendBeacon zum Senden des Ereignisses, was die Zustellung auch dann sicherstellt, wenn die Download-Navigation die Seite entlädt.

Datenschutz

Das Download-Tracking verwendet den bestehenden Zenovay-Tracker. Es fügt keine neuen Cookies oder localStorage-Einträge hinzu und funktioniert im cookielosen Modus. Besucher, die ein Global-Privacy-Control- oder Do-Not-Track-Signal senden, werden nicht erfasst, sodass ihre Downloads nicht im Downloads-Tab erscheinen — das ist beabsichtigt.

Planlimits

PlanDownload-Ereignisse pro Website und Tag
Free100 (Soft-Limit)
ProUnbegrenzt
ScaleUnbegrenzt
EnterpriseUnbegrenzt

Das Limit des Free-Plans ist ein Soft-Limit. Ereignisse oberhalb der täglichen Obergrenze werden an diesem Tag nicht zu den im Downloads-Tab angezeigten Summen gezählt.

Download-Daten ansehen

Öffnen Sie die Website in der App und gehen Sie zum Tab Downloads. Der Tab enthält:

BereichWas er zeigt
Top-DownloadsDatei-URL, Downloads, eindeutige Downloads, Größe, durchschnittliche Abschlusszeit
Downloads im ZeitverlaufDownload-Volumen-Trend für den gewählten Datumsbereich
Nach GerätDownloads aufgeschlüsselt nach Gerätetyp
Nach LandDownloads aufgeschlüsselt nach Besucherland
Nach QuelleDownloads aufgeschlüsselt nach Traffic-Quelle
AbschlussübersichtAnteil der Downloads mit erfasstem Abschluss-Timing vs. browserseitig verwalteter Downloads

Datumsbereiche

  • Die Bereiche 7 Tage und 30 Tage sind in allen Plänen verfügbar.
  • Der Bereich 90 Tage erfordert den Plan Scale oder Enterprise.

Verwandte Themen

War diese Seite hilfreich?