Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Capturez l'activité des visiteurs du site Web avec le traqueur de données Web
Le traqueur de données Web enregistre la façon dont les visiteurs interagissent avec votre site Web : éléments cliqués, recherches effectuées, soumission de formulaires. Il associe cette activité à leur profil dans les profils des clients. Le tracker fait partie du widget Communications et est contrôlé au niveau du widget. Pour un aperçu de la façon dont le traqueur de données Web et les notifications Web fonctionnent ensemble, voirSuivi des données Web et notification Web.
Conditions préalables
-
Une instance Connect Customer avec le widget Communications configuré. Pour de plus amples informations, veuillez consulter Ajoutez une interface utilisateur de chat à votre site Web hébergé par Connect Customer.
-
Profils clients activés sur l'instance. Pour de plus amples informations, veuillez consulter Activez les profils clients pour votre instance Connect Customer.
Étape 1 : activer la collecte de données dans le widget Communications
-
Connectez-vous au site Web de l' Connect Customer administrateur.
-
Dans le menu de navigation, choisissez Canaux, puis choisissez Widgets de communication.
-
Créez un nouveau widget ou modifiez un widget existant. Pour de plus amples informations, veuillez consulter Ajoutez une interface utilisateur de chat à votre site Web hébergé par Connect Customer.
-
Activez la collecte de données pour activer le suivi du parcours de navigation.
-
(Facultatif) Les paramètres de collecte de données incluent une option de collecte de données avancée. Activez cette option pour que le service collecte automatiquement les interactions des visiteurs avec le contenu HTML, ce qui produit des informations prédictives plus riches et plus précises.
-
(Facultatif) Activez les notifications Web si vous prévoyez d'envoyer des notifications proactives à partir de ce widget. Pour de plus amples informations, veuillez consulter Envoyez des notifications Web avec les campagnes sortantes Connect Customer.
-
Ajoutez les domaines du site Web où le widget sera intégré à la liste des domaines autorisés.
-
Enregistrez le widget et copiez le code de l'extrait de code du widget. Intégrez cet extrait sur votre site Web à l'étape suivante.
Étape 2 : Intégrer le widget et initialiser le suivi
Intégrez l'extrait de widget dans le code HTML de votre site Web. Une fois l'extrait chargé, initialisez le tracker une fois que vous avez obtenu le consentement du visiteur.
// Start tracking visitor behavior (after obtaining consent) await window.amazon_connect.Web.ClickStream.init(); // (Optional) Enable web notifications for this visitor await window.amazon_connect.Web.Notification.init();
Important
Initialisez le suivi uniquement après avoir obtenu le consentement approprié des visiteurs conformément à votre politique de confidentialité et aux réglementations applicables.
Note
Pour les applications d'une seule page, intégrez l'extrait une fois sur la page de premier niveau. Pour les applications multipages, intégrez l'extrait de code sur chaque page sur laquelle vous souhaitez enregistrer l'activité.
Étape 3 : (Facultatif) Suivez les événements spécifiques à l'entreprise
Pour capturer des événements professionnels personnalisés, tels que la finalisation d'un achat, des actions d'ajout au panier ou des vues de produits, appelez recordBusinessMetric depuis votre site Web JavaScript lorsque l'événement se produit.
Important
Si vous prévoyez d'utiliser le système de suivi des données avec des recommandations nécessitant des contextes d'éléments tels que Find Similar Items etFrequently Paired Items, vous devez utiliser des événements spécifiques à l'entreprise et inclure le champ. item_id
Signature de méthode
await amazon_connect.Web.ClickStream.recordBusinessMetric(eventType, eventPayload)
Paramètre |
Type |
Description |
|---|---|---|
|
chaîne |
Le nom de l'événement professionnel : un type réservé ou une chaîne personnalisée. |
|
objet |
Données d'événements structurées à l'aide des schémas d'objets ci-dessous. |
Schémas d'objets
Le eventPayload prend en charge les objets suivants. Utilisez n'importe quelle combinaison de champs en fonction de votre cas d'utilisation.
Objet |
Principaux domaines |
Description |
|---|---|---|
article |
|
Un seul produit ou article |
liste_d'articles |
Liste <item> |
Tableau d'objets objets (minimum 1) |
chariot |
|
Panier d'achats |
commande |
|
Une commande terminée |
search |
|
Une action de recherche |
formulaire |
|
Une interaction avec le formulaire |
parchemin |
|
Position de défilement (au moins un champ obligatoire) |
valeur_événement |
number |
Valeur numérique représentant l'importance d'un événement |
* Champ obligatoire
Étapes d'intégration et exemples d'utilisation
Après avoir appeléamazon_connect.Web.ClickStream.init(), ajoutez des recordBusinessMetric() appels dans les gestionnaires d'événements de votre site Web (par exemple, onclick).
Exemple — Ajouter au panier
await amazon_connect.Web.ClickStream.recordBusinessMetric('add_to_cart', { item: { item_id: 'prod-123', item_name: 'Wireless Headphones', price: 49.99, quantity: 1, currency: 'USD' } });
Exemple — Afficher les articles
await amazon_connect.Web.ClickStream.recordBusinessMetric('view_items', { item_list: [ { item_id: 'item_10', quantity: 1, item_name: 'Premium Wireless Headphones', category: 'Electronics', price: 89.99, currency: 'USD' } ] });
Types d'événements réservés
Les types d'événements suivants sont réservés avec des schémas prédéfinis :
Type d’événement |
Objet requis |
Description |
|---|---|---|
|
item |
Suit le moment où un visiteur ajoute un article à son panier |
|
order |
Suit un achat terminé |
|
liste_d'articles |
Suit le moment où un visiteur consulte un ou plusieurs articles |
Événements personnalisés
Outre les types d'événements réservés, vous pouvez définir n'importe quelle chaîne de type d'événement personnalisée (par exemple, clear_cart ouwishlist_add). Pour les événements personnalisés :
-
Le service n'impose pas de validation stricte à la structure de l'événement.
-
Vous pouvez utiliser n'importe quelle combinaison de champs des schémas d'objets ci-dessus en fonction de votre cas d'utilisation.
-
Utilisez les noms de champs exactement comme indiqué (par exemple
cart_id, noncartId).
await amazon_connect.Web.ClickStream.recordBusinessMetric('clear_cart', { cart_id: 'cart-123', item_list: [ { item_id: 'p1', item_name: 'Widget', quantity: 1 } ] });
Associer Clickstream à des utilisateurs authentifiés
Les données Clickstream capturées par le traqueur de données Web sont diffusées en continu vers les profils des clients et associées au profil du visiteur. Le tableau suivant décrit le comportement de cette association pour les visiteurs anonymes et authentifiés.
Type de visiteur |
Comportement des associations de profils |
|---|---|
Visiteur anonyme |
Suivi uniquement par identifiant de session. Les données comportementales sont capturées mais ne sont pas liées à l'identité d'un client connu. Aucune information personnellement identifiable n'est collectée. |
Visiteur authentifié |
Lorsque vous transmettez un identifiant utilisateur authentifié lors de l'initialisation du widget, le service associe toutes les activités du flux de clics au profil connu de cet utilisateur dans les profils clients. Cela permet une personnalisation plus riche et des conditions de déclenchement plus précises. |
Pour associer le suivi à un utilisateur authentifié, appliquez l'une des approches suivantes :
-
(Recommandé) Utilisez la réclamation CustomerId JWT — Si vous avez activé la sécurité sur votre widget de communication, incluez l'ID utilisateur authentifié dans le
CustomerIdchamp de vos demandes de jeton Web JSON (JWT). Cela lie l'activité du flux de clics au profil de l'utilisateur sans exposer l'identifiant dans le code côté client. Pour plus de détails sur la configuration, voirÉtape 3 : confirmer et copier le code et les clés de sécurité du widget de communication. -
Transmettez l'identifiant utilisateur lors de l'initialisation : si la sécurité n'est pas activée sur votre widget, transmettez l'identifiant utilisateur authentifié comme argument lors de l'initialisation du tracker :
await window.amazon_connect.Web.ClickStream.init('<authenticated-user-id>');
Important
Si un identifiant utilisateur authentifié est transmis, il est lié aux profils existants via la clé de compte. Étant donné que les événements liés au suivi des données s'accumulent au fil du temps, définissez WebAnalytics-Clickstream des limites d'objets _webAnalytics pour éviter que de nouveaux événements ne remplacent d'autres types d'objets une fois que la limite d'objets du profil est atteinte. Pour obtenir des conseils de configuration, consultez la section Limites de données relatives aux profils clients.
Ce qui est capturé
Pour la liste complète des activités que le tracker capture par défaut, voirCe que le traqueur de données Web capture.
Confidentialité et consentement
Le traqueur de données Web est facultatif dès sa conception. Si vous n'activez pas la collecte de données dans le widget Communications, aucune donnée de parcours de navigation n'est capturée. Les valeurs des champs de formulaire, les mots de passe et les informations de paiement ne sont jamais collectés automatiquement, même lorsque les événements de soumission de formulaires sont suivis.
Important
Il vous incombe d'obtenir le consentement approprié des visiteurs avant d'initialiser le suivi des données, conformément à votre politique de confidentialité et aux réglementations applicables telles que le règlement général sur la protection des données (RGPD) et le California Consumer Privacy Act (CCPA).