Traduit de l'anglais à l'aide de l'IA
Veuillez noter que cet article a été traduit à l'aide de la technologie IA. Bien que nous travaillions à maintenir l'exactitude, certains détails peuvent ne pas refléter parfaitement le texte original. Si vous avez des doutes sur une information, veuillez vous référer à la version anglaise.
Les événements représentent des actions qu'un utilisateur a effectuées sur votre site. Ces événements sont définis et transmis à Contentsquare via votre code côté client par le biais de l'API des événements. L'événement peut être envoyé dès que la page se charge, lorsqu'un modal apparaît, ou lorsqu'un utilisateur voit une variation spécifique de votre page à travers un test A/B.
Appels à l'API des événements
Utilisation de base :
window._uxa.push(["event", "eventName"]);Exemple d'utilisation :
window._uxa.push(["event", "subscribed_to_email_list"]);Définitions des paramètres
| Champ | Type | Description |
|---|---|---|
event |
string |
Doit toujours être le premier paramètre - chaîne littérale "event". |
eventName |
string |
Le nom personnalisé attribué à votre événement (par exemple : opened_modal). |
Considérations clés
- Règles de nommage des événements : Max 250 caractères. Les caractères autorisés incluent a-z, A-Z, 0-9, espaces, traits de soulignement (_), tirets (-), points (.), deux-points (:) et barres obliques (/).
- Limite d'événements uniques : 10 000 événements uniques par site. Seuls les événements les plus utilisés seront conservés au-delà de cette limite.
- Aucun attribut d'événement : Vous ne pouvez pas passer d'attributs d'événement - seulement le nom.
Meilleures pratiques
- Ne pas transmettre d'informations personnelles identifiables (PII) telles que des adresses e-mail ou des adresses IP. Pour connecter des données avec des utilisateurs spécifiques, explorez la fonctionnalité Attributs utilisateur.
- Ne pas utiliser d'événements pour transmettre des numéros à 9 chiffres ou plus (pour éviter les informations de carte de crédit).
- Évitez de transmettre des journaux d'erreurs détaillés ou des codes de référence.
- Évitez de transmettre des chaînes de date, des horodatages ou des données d'objets tels que les couches de données de Google Tag Manager qui peuvent contenir des valeurs excessives.
- Si vous utilisez également l'API Identify, déclenchez l'appel Identify avant l'appel Event.
- Évitez d'envoyer des informations spécifiques au produit (par exemple : codes SKU), généralement les URL sont plus utiles et sont capturées par défaut.
Tester les événements
1. Activez la journalisation de débogage.
Ouvrez la page où vous souhaitez tester l'événement et ajoutez le paramètre ?hjDebug=1 à la fin de l'URL.
Par exemple :
- https://www.example.com/?hjDebug=1
- https://www.example.com/?utm_1234&hjDebug=1
2. Ouvrez la console de développement de votre navigateur.
3. Déclenchez votre événement manuellement en exécutant la commande de l'API des événements.
Ajoutez le code de l'API des événements dans la console de votre navigateur et appuyez sur Entrée ou Retour sur votre clavier. Recherchez ce journal de confirmation :
COMMAND: Processing command: event example_actionNous vous recommandons également de suivre les étapes que votre utilisateur suivrait pour déclencher l'événement automatiquement. Si l'événement est déclenché automatiquement, alors vous saurez que votre code est implémenté avec succès. Si le manuel fonctionne mais que l'automatique ne fonctionne pas, vous devrez revoir votre implémentation de code.