Événements personnalisés

Tout ce à quoi vous pouvez attacher un gestionnaire de clic peut devenir un événement.

window.seean.track("signup");
window.seean.track("download", { file: "pricing.pdf" });

Les événements apparaissent dans la vue d’ensemble (carte Événements), dans le journal d’activité des événements, dans les tunnels comme étapes, et dans les rapports de campagne lorsqu’ils correspondent aux objectifs de conversion activés (ou tous les événements personnalisés si aucun objectif n’est activé). Les propriétés sont envoyées avec l’événement, mais la table actuelle du journal d’activité ne les affiche pas.

Nommage

Utilisez des noms courts et stables : signup, cta_click, newsletter_signup. Renommer plus tard divise votre historique.

Charger avant d’appeler

Appelez track après l’exécution du script de traqueur généré. Il n’existe pas de file d’attente intégrée pour les appels effectués avant le chargement. En HTML simple, placez le script différé de votre application après le script Seean différé ; pour un framework, suivez son guide d’installation.

Pour un bouton de téléchargement, attachez le gestionnaire une fois ce bouton présent :

document.querySelector("#download-pricing")?.addEventListener("click", () => {
  window.seean?.track("download", { file: "pricing.pdf" });
});

Cela compte le clic, et non la preuve qu’un téléchargement s’est terminé. Le chaînage optionnel évite une exception lorsque le traqueur est indisponible, mais n’enregistre pas l’événement et ne le réessaie pas. Un visiteur ignoré peut avoir des méthodes de traqueur sans effet ; la seule présence de window.seean ne prouve donc pas la collecte.

Pour un formulaire, appelez le traqueur dans votre chemin existant de soumission réussie :

// Après que votre serveur a confirmé la réussite de l'inscription à la newsletter :
window.seean?.track("newsletter_signup", { form: "footer" });

N’envoyez pas aussi cet événement de succès depuis le clic sur le bouton d’envoi : la validation ou la requête peut échouer, et câbler les deux compterait deux fois les envois réussis. Conservez la validation et la gestion d’erreurs normales de votre formulaire.

Clics et formulaires déclaratifs

Ajoutez data-seean-event="signup" à un bouton ou à un lien pour envoyer cet événement au clic, y compris les clics sur ses éléments imbriqués. Sur un formulaire, l’attribut envoie à la soumission plutôt qu’au clic sur ses champs. Les éléments dynamiques fonctionnent grâce à des écouteurs délégués. Les préréglages de conversion automatiques ignorent les éléments marqués pour éviter le double comptage ; n’appelez pas aussi seean.track() pour la même action. Les attributs déclaratifs ne nécessitent pas l’option data-conversions. Les noms doivent être non vides, de 64 caractères au plus, et différents de pageview.

<button data-seean-event="download" data-seean-event-source="footer">Download</button>
<form data-seean-event="contact_submit">…</form>

Ajoutez data-seean-event-PROPERTY="value" au même élément marqué pour envoyer une propriété. L’exemple ci-dessus envoie { "source": "footer" }. Les valeurs d’attribut restent des chaînes ("2" n’est pas le nombre 2) ; le HTML normalise les noms d’attributs en minuscules. Seuls les attributs explicitement préfixés de cet élément sont lus. Les propriétés des ancêtres ou des enfants, les valeurs des champs de formulaire et les attributs sans rapport ne sont pas collectés. Modifier un attribut avant une interaction ultérieure utilise sa nouvelle valeur.

Les limites des propriétés ci-dessous s’appliquent. Une clé invalide, trop de propriétés ou une valeur trop grande amène le collecteur à rejeter l’événement ; les valeurs ne sont pas tronquées silencieusement. Utilisez l’API JavaScript pour des valeurs typées nombre, booléen ou null.

Un événement de clic ou de soumission ne confirme pas que votre serveur a terminé l’action. Utilisez la méthode du gestionnaire de succès ci-dessus lorsque vous avez besoin de cette confirmation.

Identifier les utilisateurs connectés

window.seean?.identify("user_42", { plan: "pro" });

identify(id, properties?) attache votre propre identifiant utilisateur (1 à 64 caractères parmi A–Z a–z 0–9 _ . : @ -, jamais un e-mail) à chaque enregistrement ultérieur de la page ouverte et enregistre un événement identify avec les propriétés facultatives. Il n’a d’effet que pour les sites web ayant activé Identify users (Identifier les utilisateurs) sous Settings → Installation ; voir Personnes et rétention.

Limites des propriétés

Les noms d’événements acceptent jusqu’à 64 caractères. Chaque événement peut inclure jusqu’à 20 propriétés ; l’objet de propriétés sérialisé ne doit pas dépasser 4 096 caractères. Les clés de propriété commencent par une lettre et ne contiennent que des lettres, des chiffres ou des tirets bas, jusqu’à 64 caractères. Les valeurs peuvent être une chaîne de 512 caractères au plus, un nombre fini, un booléen ou null. Les objets imbriqués et les tableaux sont rejetés.

Utilisez des libellés non sensibles tels qu’un emplacement de formulaire ou une catégorie de produit. N’envoyez jamais de mots de passe, d’adresses e-mail, de données de paiement ou de jetons privés. Les propriétés ne sont pas disponibles actuellement comme colonnes du journal d’activité ni comme filtres de propriété du tableau de bord ; envoyer une propriété ne crée pas de nouveau contrôle de rapport.

Vérifier un événement

Effectuez l’action une fois et ouvrez le journal d’activité des événements du site web sélectionné sur la période en cours. Vérifiez son nom, son chemin et son nombre. Les événements personnalisés utilisent les mêmes signaux de confidentialité, exclusions et quota de collecte que les pages vues ; une requête rejetée ou ignorée peut ne laisser aucune ligne. Un événement nommé pageview est compté comme une page vue plutôt que comme un événement personnalisé.

Si une ligne manque, vérifiez que le script est prêt, la charge utile de la requête et le dépannage de l’installation. track() ne renvoie pas d’accusé de réception confirmant le stockage, et le traqueur ne fournit pas de file de nouvelles tentatives persistante.

Pages 404

Ajoutez <meta name="seean:status" content="404"> à votre page introuvable : sa page vue automatique porte status: 404 et apparaît sous Pages → 404 sans second événement.

Appeler track("pageview", { status: 404 }) à la place ajoute une seconde page vue. Voir suivi des 404.

Quelque chose n'est pas clair ? Contacter le support.