Événements personnalisés

Les événements automatiques décrivent comment les visiteurs naviguent. Les événements personnalisés décrivent ce qu’ils accomplissent : créer un compte, choisir un plan, payer. Ce sont eux qui alimentent vos objectifs et vos tunnels.

Avec du code : `track()`

components/PlanPicker.tsx

"use client";
import { useAnalytics } from "@jichio/react";

export function PlanPicker() {
  const analytics = useAnalytics();
  return (
    <button onClick={() => analytics.track("plan_selected", { plan: "pro", billing: "monthly" })}>
      Choisir Pro
    </button>
  );
}

Le premier argument est le nom de l’événement.
Le second est un objet de propriétés, facultatif. Il est rangé dans properties.custom.
track() rend la main dès que l’événement est enregistré localement. L’envoi se fait ensuite en arrière-plan : vous n’avez pas besoin d’attendre la promesse avant une redirection.

Sans React, appelez analytics.track() sur l’instance créée avec createAnalytics().

Sans code : `data-jichio-action`

Ajoutez l’attribut sur un élément. Chaque clic envoie un événement dont le nom est la valeur de l’attribut :

<button data-jichio-action="pricing_trial_started">Essai gratuit</button>

C’est la seule méthode disponible sur WordPress. L’événement n’a pas de propriétés personnalisées ; il contient le contexte du clic (élément, position, page).

data-track est un attribut différent : il ne crée pas d’événement. Il donne un nom lisible à l’élément dans les clics enregistrés (properties.element.dataTrack) et l’exclut des clics morts.

Nommer vos événements

Règle	Bon	À éviter
`snake_case`, objet puis verbe au passé	`signup_completed`, `plan_selected`	`SignUp`, `click-btn`
Un nom par action, pas par élément	`cta_clicked` + `{ location: "header" }`	`header_cta_clicked`, `footer_cta_clicked`
Jamais de valeur variable dans le nom	`article_read` + `{ articleId: 42 }`	`article_42_read`
Ne pas réutiliser un nom réservé	`signup_completed`	`pageview`, `click`, `conversion`, `identify`

Les noms réservés sont ceux des événements automatiques. Ils sont exclus de l’écran Événements.

Choisir les propriétés

Des valeurs courtes et en nombre limité : plan: "pro", pas un texte libre.
Des nombres pour les montants et les quantités : amount: 5000.
La devise à part : currency: "XAF".
Aucune donnée sensible. Les clés password, token, secret, creditCard, cardNumber, cvv, accessToken et refreshToken sont supprimées, mais le filtre ne reconnaît que ces noms exacts.

Taille maximale des propriétés d’un événement : 32 Ko.

Écrire un plan de tracking

Avant d’ajouter des track() partout, listez les 5 à 10 actions qui comptent pour votre produit. Un tableau suffit :

Événement	Déclencheur	Propriétés	Utilisé dans
`signup_completed`	Compte créé	`method`	Objectif « Inscription », tunnel d’onboarding
`plan_selected`	Clic sur un plan	`plan`, `billing`	Tunnel de paiement
`checkout_completed`	Paiement confirmé	`plan`, `amount`, `currency`	Objectif « Achat »

Pour un événement confirmé par votre serveur (paiement, webhook), envoyez-le depuis le serveur avec l’API d’ingestion : il ne sera pas perdu si le visiteur ferme l’onglet.

Retrouver vos événements

Comportement → Événements liste chaque nom avec son volume et son nombre de visiteurs uniques.
Un événement peut devenir un objectif ou une étape de tunnel. Voir Conversions.

​Avec du code : track()

​Sans code : data-jichio-action

​Nommer vos événements

​Choisir les propriétés

​Écrire un plan de tracking

​Retrouver vos événements

Avec du code : `track()`

Sans code : `data-jichio-action`

Nommer vos événements

Choisir les propriétés

Écrire un plan de tracking

Retrouver vos événements