Comment marquer le téléchargement d'un PDF ?

Limitation importante : vous ne pouvez pas marquer les "vues de PDF"

Piano Analytics ne peut pas suivre l'affichage d'un document PDF une fois qu'il est ouvert (par exemple, dans un visualiseur PDF du navigateur ou après son téléchargement et son ouverture en local). Cela est dû au fait que les fichiers PDF ne fournissent pas un environnement d'exécution JavaScript fiable pour les tags Piano Analytics.

En pratique, les "téléchargements" de PDF sont mesurés en suivant le clic sur le lien ou le bouton qui pointe vers le PDF.

Approche recommandée pour les téléchargements de PDF

Pour la mesure des téléchargements de PDF, il est généralement recommandé d'implémenter un hit click.download sur l'élément qui initie le téléchargement (lien, bouton, etc.). Cela permet de séparer le comportement de téléchargement de la navigation normale dans les rapports et facilite l'interprétation des données.

Si nécessaire, vous pouvez également passer un paramètre/valeur qui identifie la ressource (par exemple, l'URL du PDF ou le nom du fichier) afin de pouvoir distinguer les téléchargements dans les rapports.

Pour les détails d'implémentation, référez-vous à la documentation Piano Analytics pour les développeurs sur le marquage des clics.

Valider votre implémentation (Tag Inspector)

Veuillez noter qu'une fois le tag implémenté, vous pouvez utiliser le plugin Tag Inspector de Piano Analytics pour Chrome. Vous pourrez ainsi examiner directement votre marquage (cela vaut pour le marquage en général, pas seulement pour les clics).

Lors du test d'un lien PDF :

Cliquez sur le lien/bouton PDF
Confirmez qu'un hit est envoyé et que le clic est catégorisé comme click.download
Notez le nom/label du clic et toutes les propriétés utiles (comme l'URL de destination), que vous pourrez utiliser ultérieurement pour le filtrage et l'analyse

Si aucun hit n'est envoyé lorsque vous cliquez sur un lien PDF, le téléchargement n'est pas marqué (ou le marquage des clics n'est pas implémenté sur cet élément).

Analyser les téléchargements de PDF dans Piano Analytics

Une fois que vos liens PDF sont marqués, vous pouvez analyser les téléchargements dans Explorer sous les analyses de clics/contenu en :

Filtrant sur le type de clic click.download
Filtrant ou décomposant par la propriété Clic (le nom/label du clic)

Les façons courantes d’analyser les téléchargements incluent :

Utiliser la métrique Clics de téléchargement pour compter les interactions de téléchargement
Ajouter la propriété Page pour identifier à partir de quelle page le téléchargement a été initié (utile pour comprendre le contexte source)
Utiliser l'URL de l'événement (souvent exposée comme event_url) lorsque vous avez besoin de l'URL complète de destination du PDF, selon votre configuration de marquage

Dépannage

Tous les liens PDF ne sont pas marqués : Seuls les clics avec un marqueur de clic configuré sont suivis.
Aucun hit n'est envoyé au clic : Vérifiez en utilisant Tag Inspector. Vous pouvez également utiliser les outils de développement de votre navigateur (F12) pour vérifier qu'une requête de suivi est déclenchée lors du clic sur le lien PDF.
Les données d'URL semblent incomplètes : Dans certains cas, les informations d'URL/référent capturées peuvent être affectées par les politiques du navigateur ou du site (par exemple, des politiques de référent restrictives). Si vous avez besoin d'un identifiant fiable pour chaque PDF, envisagez d'envoyer explicitement l'URL/nom de fichier du PDF dans le cadre des données de clic.
Choisissez intentionnellement le type de clic : C'est à vous de décider du type de clic que vous souhaitez pousser en fonction des tags existants et de la façon dont vous voulez que vos données soient affichées dans l'interface. Pour les téléchargements, click.download est généralement le choix le plus clair.