Identifier les utilisateurs

Par défaut, chaque visiteur est anonyme : le SDK lui attribue un anonymousId stable (stocké dans le localStorage). Quand l’utilisateur se connecte, vous appelez identify() pour que les événements suivants portent aussi son userId et ses traits (rôle, plan, …).

Prérequis

Le SDK est installé et le provider est monté (Démarrage rapide).
Vous avez accès à l’utilisateur courant côté client (session, contexte d’auth).

Avec React : `useIdentify` (recommandé)

useIdentify(userId, traits) appelle identify() dès que userId est défini, et le rappelle si userId ou les traits changent. Si userId vaut null ou undefined, il ne fait rien.

components/IdentitySync.tsx

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

type CurrentUser = { id: string; role: string; plan: string };

export function IdentitySync({ user }: { user: CurrentUser | null }) {
  useIdentify(user?.id, user ? { role: user.role, plan: user.plan } : {});
  return null;
}

Montez ce composant sous AnalyticsProvider, là où l’utilisateur courant est disponible (par exemple dans le layout de l’espace connecté).

Sans React : `identify()`

await analytics.identify("user_42", { role: "admin", plan: "pro" });

Ce que fait `identify()`

Il enregistre userId et les traits dans le localStorage (analytics_user_id, analytics_user_traits). Ils survivent au rechargement de la page.
Il envoie un événement identify, avec les traits dans properties.user.
Tous les événements suivants portent userId et properties.user.

Les événements envoyés avant l’appel ne sont pas modifiés : ils restent rattachés au seul anonymousId. L’anonymousId est conservé après identify(), ce qui permet de relier le parcours anonyme au parcours connecté.

Appeler identify() plusieurs fois avec les mêmes valeurs est sans danger, mais envoie un événement à chaque appel. useIdentify évite les appels répétés tant que userId et les traits ne changent pas.

Choisir les traits

Envoyez uniquement ce qui sert à segmenter vos analyses :

À envoyer	À éviter
Rôle, plan, type de compte, date d’inscription	Mot de passe, jetons, numéro de carte
Identifiant interne stable (`user.id`)	Données personnelles inutiles (adresse, téléphone)

Les clés password, token, accessToken, refreshToken, secret, creditCard, cardNumber et cvv sont retirées automatiquement (Filtrage automatique). Ce filtre est un filet de sécurité, pas une politique de confidentialité.

Déconnexion

Le SDK n’a pas encore de méthode reset(). Sans action de votre part, l’utilisateur reste identifié après la déconnexion : son userId est relu depuis le localStorage à chaque chargement. Pour repartir sur un visiteur anonyme, effacez l’identité stockée puis recréez l’instance du SDK. Avec React, changez la key du provider pour forcer son remontage :

app/analytics-root.tsx

"use client";
import { AnalyticsProvider } from "@jichio/react";
import { createContext, useCallback, useContext, useState, type ReactNode } from "react";

const JICHIO_IDENTITY_KEYS = ["analytics_user_id", "analytics_user_traits"];

const ResetAnalyticsContext = createContext<() => void>(() => {});

export function useResetAnalytics() {
  return useContext(ResetAnalyticsContext);
}

export function AnalyticsRoot({ children }: { children: ReactNode }) {
  const [instanceKey, setInstanceKey] = useState(0);

  const resetAnalytics = useCallback(() => {
    JICHIO_IDENTITY_KEYS.forEach((key) => localStorage.removeItem(key));
    setInstanceKey((current) => current + 1);
  }, []);

  return (
    <ResetAnalyticsContext.Provider value={resetAnalytics}>
      <AnalyticsProvider key={instanceKey} apiKey={process.env.NEXT_PUBLIC_ANALYTICS_KEY!}>
        {children}
      </AnalyticsProvider>
    </ResetAnalyticsContext.Provider>
  );
}

Appelez ensuite resetAnalytics() dans votre action de déconnexion. Si la déconnexion recharge la page (redirection serveur), effacer les deux clés avant la redirection suffit.

Pour que le visiteur suivant sur le même navigateur soit compté comme un nouveau visiteur, effacez aussi analytics_anonymous_id. Sinon, il garde le même anonymousId, ce qui est le comportement habituel des outils d’analytics.

Vérifier

Dans l’onglet Network, la requête POST /v1/events suivant la connexion contient un événement "eventName": "identify". Les événements suivants ont un champ userId. Après la déconnexion, les nouveaux événements n’en ont plus.

​Prérequis

​Avec React : useIdentify (recommandé)

​Sans React : identify()

​Ce que fait identify()

​Choisir les traits

​Déconnexion

​Vérifier

Prérequis

Avec React : `useIdentify` (recommandé)

Sans React : `identify()`

Ce que fait `identify()`

Choisir les traits

Déconnexion

Vérifier