Downloads

Das Ereignis download zählt die Dateien, die Ihre Besucher von Ihrer Website herunterladen. Es ist ein integriertes Ereignis (siehe Benutzerdefinierte Ereignisse). Es erscheint als download im Tab Ereignisse des Blocks Ziele im Bildschirm Statistiken sowie im CSV-Export. Der Tab Downloads desselben Blocks listet die meistgeladenen Dateien Ihrer Website auf (seine Zeilen filtern die Seite nicht).

#Automatisch oder von Ihnen gesendet

Der Snorklee-Code sendet automatisch ein download-Ereignis, wenn ein Besucher auf Ihrer Website einen Link zu einer gängigen Datei anklickt: .pdf, .doc/.docx, .xls/.xlsx, .ppt/.pptx, .odt, .ods, .rtf, .csv, .zip, .7z, .gz. Er sendet die Tatsache, nie den Dateinamen, der im Browser bleibt — diese Downloads zählen also in der Summe, nicht in der Rangliste pro Datei. Damit eine Datei mit ihrem Pfad im Tab Downloads erscheint, oder für einen anderen Dateityp, senden Sie das Ereignis selbst mit der Eigenschaft url — auf Links, die der Code nicht schon zählt, sonst wird der Klick doppelt gezählt:

document.querySelectorAll('a[href$=".epub"], a[href$=".mp3"]').forEach((a) => {
  a.addEventListener('click', () => {
    window.snorklee('download', {
      url: new URL(a.href, location.href).pathname,
      ext: a.href.split('.').pop(),
    });
  });
});

#Empfohlene Eigenschaften

Das Ereignis download akzeptiert beliebige Eigenschaften (max. 10). Die zwei nützlichsten:

• url — der Pfad der Datei (ohne Domain), um jede Datei im CSV-Export wiederzuerkennen.
• ext — die Erweiterung (ohne Punkt), um nach Dateityp zu filtern.

Der Tab Ereignisse zeigt die Anzahl der download-Ereignisse; die Aufschlüsselung Datei für Datei (über url) steht im Ereignis-CSV-Export.

#Gute Gewohnheit

Beschränken Sie sich auf Dateien, die wirklich zählen (Dokumente, Medien, ausführbare Dateien). Es ist unnötig, jedes Bild oder Stylesheet zu erfassen — das wäre nur Rauschen, und die Obergrenze von 20 Ereignissen pro Seitenaufruf gilt.