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 in der Karte „Ausgelöste Ereignisse" des Tabs Analytics (Bereich Ereignisse) sowie im CSV-Export. Eine eigene Karte „Downloads" im Bereich Verhalten listet die meistgeladenen Dateien Ihrer Website auf.

#Von Ihrer Website auslösen

Anders als bei ausgehenden Links wird ein Download nicht automatisch gezählt: Ihre Website weiß, welche Links Dateien sind, der Snorklee-Code nicht. Sie senden das Ereignis daher selbst beim Klick:

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

#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.

Die Karte „Ausgelöste 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.