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 à l'aide du 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, envoi de formulaires. Il associe cette activité à leur profil dans les profils clients. Le tracker fait partie du widget Communications et est contrôlé au niveau du widget. Pour un aperçu de la manière dont le traqueur de données Web et la notification 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

Étape 2 : Intégrez le widget et initialisez le suivi

Intégrez l'extrait du widget dans le code HTML de votre site Web. Une fois l'extrait chargé, initialisez le tracker après avoir 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();

Étape 3 : (Facultatif) Suivez les événements spécifiques à l'entreprise

Pour enregistrer des événements commerciaux personnalisés, tels que la finalisation des achats, les actions d'ajout au panier ou les consultations de produits, appelez recordBusinessMetric depuis votre site Web JavaScript lorsque l'événement se produit.

Signature de la méthode

await amazon_connect.Web.ClickStream.recordBusinessMetric(eventType, eventPayload)

Schémas d'objets

eventPayloadSupporte les objets suivants. Utilisez n'importe quelle combinaison de champs en fonction de votre cas d'utilisation.

* Champ obligatoire

Étapes d'intégration et exemples d'utilisation

Après avoir appeléamazon_connect.Web.ClickStream.init(), ajoutez recordBusinessMetric() des 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 :

Événements personnalisés

Au-delà des 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 :

await amazon_connect.Web.ClickStream.recordBusinessMetric('clear_cart', {
    cart_id: 'cart-123',
    item_list: [
        { item_id: 'p1', item_name: 'Widget', quantity: 1 }
    ]
});

Associer le flux de clics au profil du client

Les données Clickstream capturées par le traceur de données Web sont transmises en continu aux profils des clients. La manière dont les données sont associées à un profil dépend de la fourniture ou non des clés de profil lors de l'initialisation du widget.

Associer les événements d'analyse Web aux profils existants

Pour associer le suivi à un profil connu, définissez profileKeys dans vos revendications JWT de rechercher et d'associer un profil existant au moment de la connexion, et le service utilise ces clés pour trouver un profil correspondant via l'SearchProfilesAPI. Cela nécessite que la sécurité soit activée sur votre widget Communications. Pour plus de détails sur la configuration, consultezÉtape 3 : confirmer et copier le code et les clés de sécurité du widget de communication.

{
  "sub": "<widgetId>",
  "iat": 1234567890,
  "exp": 1234571490,
  "profileKeys": {
    "_email": "user@example.com",
    "_account": "ACCT-12345"
  },
  "profileKeysOperator": "OR"
}

Regrouper les événements par un identifiant personnalisé

Si vous n'avez pas besoin de créer un lien vers un profil existant mais que vous souhaitez regrouper vous-même l'activité du parcours de navigation, vous pouvez fournir un identifiant personnalisé. Les événements Clickstream partageant le même identifiant sont regroupés sous une clé de _webAnalyticsUserId profil commune.

Il existe deux manières de le fournir :

Ce qui est capturé

Pour la liste complète des activités capturées par défaut par le tracker, consultezCe que le traqueur de données Web capture.

Confidentialité et consentement

Le traceur de données Web est conçu pour être activé. 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.