Maîtriser le suivi des téléchargements : utiliser AEP WebSDK pour la surveillance des événements

Introduction:

Le suivi des événements de téléchargement de fichiers sur les sites Web est crucial pour comprendre l’engagement des utilisateurs et sur la base des stratégies numériques qui peuvent être optimisées. L’utilisation de l’extension AEP WebSDK offre une solution robuste pour capturer de tels événements. En tirant parti de cette extension, les entreprises peuvent surveiller et capturer de manière transparente les événements de téléchargement, fournissant ainsi des informations précieuses sur les performances du contenu. Cette approche s’intègre bien aux flux de travail d’analyse existants, permettant une vue complète des interactions des utilisateurs et une prise de décision mieux informée.

Prérequis :

• Accès à Adobe Experience Platform Data Collection (anciennement Adobe Launch).
• La propriété Web doit être disponible.
• L’extension Adobe Experience Platform Web SDK doit être installée dans la propriété Web souhaitée.
• L’extension AEP Web SDK doit être configurée.

Il existe trois solutions potentielles pour suivre efficacement tous les téléchargements de fichiers sur n’importe quel site Web. Ils sont:

Solution 1 : Utilisation d’une règle personnalisée avec une couche de données comme déclencheur d’événement.

Dans cette approche, nous allons créer une règle comme « Global|AA|File_Download »

Configurer Événements comme ci-dessous :

estTélécharger

Pour la configuration ci-dessus, nous utilisons l’élément de données « isDownload » pour valider si le fichier est téléchargé avec succès ou non. Voici l’exemple d’élément de données « isDownload »

Nom : isDownload

Extension : Noyau

Type d’élément de données : Code personnalisé

isDownloadCustomCode

Note : Ici, digitalData.page.content.isDownload est un chemin de couche de données configuré dans le code back-end par l’équipe de développement du site Web. Il renvoie « vrai » si un fichier est téléchargé avec succès.

Ajouter pertinent Conditions dans Adobe Launch selon votre cas d’utilisation.

Par exemple : si l’exigence est que nous devons capturer uniquement un type spécifique de téléchargement de fichier, disons (pdf/docs) uniquement. Ensuite, nous devons ajouter des conditions ici. Considérant que la couche de données « isDownload » est disponible pour tous les types possibles de téléchargements de fichiers sur le site Web.

Mais si la couche de données « isDownload » est disponible uniquement pour les téléchargements de type de fichier pdf/docs, ce qui est défini par l’équipe de développement à partir du backend, il n’est pas nécessaire d’ajouter explicitement des conditions ici.

Conditions des règles

Configurons le Actes dans la règle de lancement :

Extension : Noyau
Type d’action : Code personnalisé
Nom : définir XDM et envoyer une balise (/ou tout nom pertinent de votre choix/)

Code personnalisé d’action de règle

Note : digitalData.page.content.filename renseigne le nom du fichier à partir de la couche de données.

digitalData.page.content.fileSource renseigne la source du fichier à partir de la couche de données.

digitalData.page.content.fileType renseigne le type du fichier (pdf/doc/other) à partir de la couche de données.

Ainsi, chaque fois qu’un fichier est téléchargé sur un site Web, nous avons au total 4 nœuds dans la couche de données.

fileName/fileSource/fileType/isDownload.

Référence Exemple de code pour « _expérience (websdk) » élément de données (élément de données principal pour mapper les objets xdm)

Pour initialiser l’objet :

Initialisation d’objet

Créez quelques fonctions comme suit :

Fonctions personnalisées

Après avoir effectué toutes les modifications mentionnées ci-dessus, construisez votre bibliothèque et validez vos modifications.

Note: Le code ci-dessus consiste en l’initialisation de toutes les variables/événements d’analyse. N’hésitez pas à annexer cette partie en fonction de vos besoins. De plus, les fonctions définies sont totalement facultatives, si vous le souhaitez, vous pouvez mapper directement les variables/événements d’analyse.

Solution 2 : Événements personnalisés sans dépendre de la couche de données pour le déclencheur d’événement.

Dans cette approche, nous allons créer une règle comme « Global|AA|File_Download »

Configurer Événements comme ci-dessous :

Configurer l’événement

Ajouter pertinent Conditions code pour détecter le téléchargement de fichiers :

Conditions

Condition d’expression régulière

Note : Vous pouvez modifier la liste des extensions de fichiers en fonction de vos besoins/cas d’utilisation.

Configurons le Actes partie:

Extension : Noyau
Type d’action : Code personnalisé
Nom : définir XDM et envoyer une balise (/ou tout nom pertinent de votre choix/)

Action Code personnalisé

Après avoir effectué toutes les modifications mentionnées ci-dessus, construisez votre bibliothèque et validez vos modifications.

Solution 3 : Utilisation de la fonctionnalité de téléchargement OOTB (prêt à l’emploi) à partir de l’extension AEP Web SDK.

Effectuez la configuration ci-dessous dans l’extension AEP WebSDK.

Configurations du SDK Web AEP

Note : Les qualificatifs de lien de téléchargement sont modifiables en fonction de vos besoins.

Ajoutez le code ci-dessous dans la section « Collecte de données » dans l’extension AEP Web SDK « Modifier avant le rappel d’envoi d’événement »

Initialisation d’objet

Le code ci-dessus initialisera les objets pour des événements allant de 1 à 100/evars/props. Vous pouvez ajouter des listVars si nécessaire.
Ajoutez ensuite le code ci-dessous pour vérifier les variables d’analyse de téléchargement et de mappage.

Vérifiez le téléchargement du code personnalisé

Note: La fonction _satellite.getVar() est utilisée pour récupérer la valeur de l’élément de données. Dans ce cas, « dl.fileName »/« dl.fileType » sont des éléments de données de type variable javascript qui récupèrent les valeurs du datalayer.

Après avoir effectué toutes les modifications mentionnées ci-dessus, construisez votre bibliothèque et validez vos modifications.

Note: Pour la solution 1/solution 2, vous pourrez voir les données d’analyse mappées dans l’appel d’interaction dans l’onglet réseau.

Pour la solution 3, vous pourrez voir les données d’analyse mappées dans l’appel à frais virés dans l’onglet Réseau.

Bon marquage !

VOUS TROUVEZ CELA UTILE ? PARTAGEZ-LE