Installer en JavaScript

@jichio/core est le SDK sans dépendance de framework. Les packages React et WordPress l’utilisent en interne. Choisissez-le si votre projet n’est ni React ni WordPress.

1. Installer

pnpm add @jichio/core

2. Créer une instance unique

Créez l’instance une seule fois, dans un module importé au démarrage de l’application :

src/analytics.ts

import { createAnalytics } from "@jichio/core";

export const analytics = createAnalytics({
  apiKey: import.meta.env.VITE_ANALYTICS_KEY,
  source: "sdk-core",
});

src/main.ts

import "./analytics";

Créer plusieurs instances sur la même page double les événements automatiques. Exportez une instance et réutilisez-la partout.

source identifie la plateforme dans vos données. Utilisez "sdk-core", ou "sdk-vanilla" pour un site sans framework.

3. Applications monopage (SPA)

Sur un site multi-pages, chaque chargement de page est enregistré automatiquement. Dans une SPA, seule la première page l’est : appelez page() après chaque changement de route.

router.afterEach(() => {
  analytics.page({ loadType: "spa-navigation" });
});

page() lit l’URL et le titre courants. Deux appels pour la même URL à moins de 300 ms d’intervalle ne comptent qu’une fois.

4. Envoyer des événements

analytics.track("checkout_started", { plan: "pro", amount: 5000 });
await analytics.identify("user_42", { plan: "pro" });

Nettoyer

Si votre application détruit et recrée son contexte (tests, micro-frontends), appelez analytics.destroy() pour retirer les écouteurs et les minuteries. Toutes les options et méthodes : Référence @jichio/core.

​1. Installer

​2. Créer une instance unique

​3. Applications monopage (SPA)

​4. Envoyer des événements

​Nettoyer

1. Installer

2. Créer une instance unique

3. Applications monopage (SPA)

4. Envoyer des événements

Nettoyer