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 la carte « Événements déclenchés » de l'onglet Analytics (section Événements), et dans l'export CSV. Une carte « Téléchargements » dédiée, dans la section Comportement, classe les fichiers les plus téléchargés de votre site.

#À déclencher depuis votre site

Contrairement aux liens sortants, un téléchargement n'est pas compté automatiquement : votre site sait quels liens sont des fichiers, le code Snorklee ne le sait pas. C'est donc à vous d'envoyer l'événement au moment du clic :

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

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

La carte « Événements déclenchés » 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.