Downloads

Das Ereignis download misst heruntergeladene Dateien von Ihrer Website. Es ist ein integriertes Ereignis (siehe Benutzerdefinierte Ereignisse). Es erscheint als download in der Karte „Ausgelöste Ereignisse“ des Tabs Dashboard (Bereich Ereignisse) sowie im CSV-Export. Eine eigene Karte „Downloads“ im Bereich Verhalten listet die meistgeladenen Dateien Ihrer Website auf.

#Auslösen von Ihrer Website

Im Gegensatz zu ausgehenden Links wird der Download nicht automatisch erfasst: Ihre Website weiß, welche Links Dateien sind, der Tracker jedoch nicht. Sie lösen das Ereignis beim Klick aus:

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 nützlichsten sind:

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

Die Karte „Ausgelöste Ereignisse“ zeigt die Anzahl der download-Ereignisse; die Aufschlüsselung pro Datei (über url) steht im Ereignis-CSV-Export zur Verfügung.

#Best Practice

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