Téléchargements

L'événement download compte les fichiers que vos visiteurs téléchargent depuis votre site. C'est un événement intégré (voir Événements personnalisés). Il apparaît sous le nom download dans l'onglet Événements du bloc Objectifs, sur l'écran Statistiques, et dans l'export CSV. L'onglet Téléchargements du même bloc classe les fichiers les plus téléchargés de votre site (ses lignes ne filtrent pas la page).

#Automatique, ou envoyé par vous

Le code Snorklee envoie automatiquement un événement download quand un visiteur clique un lien de votre site vers un fichier courant : .pdf, .doc/.docx, .xls/.xlsx, .ppt/.pptx, .odt, .ods, .rtf, .csv, .zip, .7z, .gz. Il émet le fait, jamais le nom du fichier, qui ne quitte pas le navigateur — ces téléchargements comptent donc dans le total, pas dans le classement fichier par fichier. Pour qu'un fichier apparaisse dans l'onglet Téléchargements avec son chemin, ou pour un autre type de fichier, envoyez vous-même l'événement avec la propriété url — sur des liens que le code ne compte pas déjà, sinon le clic serait compté deux fois :

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(),
    });
  });
});

#Propriétés conseillées

L'événement download accepte n'importe quelles propriétés (10 au maximum). Les deux plus utiles :

• url — le chemin du fichier (sans le domaine), pour repérer chaque fichier dans l'export CSV.
• ext — l'extension (sans le point), pour filtrer par type de fichier.

L'onglet Événements affiche le nombre de download ; le détail fichier par fichier (via url) se retrouve dans l'export CSV des événements.

#Bon réflexe

Contentez-vous des fichiers qui comptent vraiment (documents, médias, exécutables). Inutile de suivre chaque image ou feuille de style — ce serait du bruit pour rien, et la limite de 20 événements par page vue s'applique.