View a markdown version of this page

Capturez l'activité des visiteurs du site Web avec le traqueur de données Web - Client Amazon Connect

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

Étape 1 : activer la collecte de données dans le widget Communications

  1. Connectez-vous au site Web de l' Connect Customer administrateur.

  2. Dans le menu de navigation, choisissez Canaux, puis choisissez Widgets de communication.

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

  4. Activez la collecte de données pour activer le suivi du parcours de navigation.

  5. (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.

  6. (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.

  7. Ajoutez les domaines du site Web où le widget sera intégré à la liste des domaines autorisés.

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

eventType

chaîne

Le nom de l'événement professionnel : un type réservé ou une chaîne personnalisée.

eventPayload

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

item_id*, item_name*, quantity*, category, price, currency, impression_type, impression_id

Un seul produit ou article

liste_d'articles

Liste <item>

Tableau d'objets objets (minimum 1)

chariot

cart_id*, item_list*, total_value, currency

Panier d'achats

commande

order_id*, item_list*, total_value, currency, payment_method, shipping_address, discount

Une commande terminée

search

search_query*, total_matching_results, results_per_page, filter_expression, sort_criteria

Une action de recherche

formulaire

form_id*, form_name, form_length, validation_errors, fields_completed

Une interaction avec le formulaire

parchemin

depth_percentage, position_x, position_y

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

add_to_cart

item

Suit le moment où un visiteur ajoute un article à son panier

purchase

order

Suit un achat terminé

view_items

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 exemplecart_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 CustomerId champ 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).