Démarrage rapide

​

Avant de commencer

• Un compte Jichio et un projet. Si vous venez de vous inscrire, l’onboarding crée le projet pour vous.
• La clé d’ingestion de l’environnement voulu. Elle est affichée à la fin de l’onboarding et dans Paramètres → Clés API. Commencez avec la clé Bac à sable (jch_sb_…) pour tester, puis passez à la clé Production (jch_pr_…) sur votre site réel. Voir Environnements.

​

Installer le SDK

pnpm add @jichio/react

NEXT_PUBLIC_ANALYTICS_KEY=jch_sb_xxxxxxxxxxxxxxxx

import { AnalyticsProvider } from "@jichio/react";

export default function RootLayout({ children }: { children: React.ReactNode }) {
  return (
    <html lang="fr">
      <body>
        <AnalyticsProvider apiKey={process.env.NEXT_PUBLIC_ANALYTICS_KEY!}>
          {children}
        </AnalyticsProvider>
      </body>
    </html>
  );
}

pnpm add @jichio/react

VITE_ANALYTICS_KEY=jch_sb_xxxxxxxxxxxxxxxx

import { AnalyticsProvider } from "@jichio/react";
import { createRoot } from "react-dom/client";
import { App } from "./App";

createRoot(document.getElementById("root")!).render(
  <AnalyticsProvider apiKey={import.meta.env.VITE_ANALYTICS_KEY}>
    <App />
  </AnalyticsProvider>,
);

pnpm add @jichio/core

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

export const analytics = createAnalytics({
  apiKey: "jch_sb_xxxxxxxxxxxxxxxx",
  source: "sdk-core",
});

​

Vérifier que ça fonctionne

1. Ouvrez votre site, puis l’onglet Network des outils de développement.
2. Naviguez sur deux ou trois pages. Les événements partent par lots, toutes les 5 secondes ou dès 10 événements.
3. Cherchez une requête POST https://api.bissa.tech/v1/events. Elle doit répondre 202 avec un corps de la forme { "accepted": 3, "eventIds": [...] }.
4. Dans le dashboard, sélectionnez le même environnement que la clé utilisée. Les visites apparaissent dans Aperçu → Utilisateurs en direct.

​

Étapes suivantes