Skip to main content

Qu’est-ce que le Server Side SDK ?

Le Reelevant Server Side SDK (@rlvt/web-sdk) vous permet de récupérer du contenu personnalisé sur le serveur — pendant le rendu de la page — afin qu’il arrive dans le payload HTML initial. Les visiteurs voient immédiatement le bon contenu, les moteurs de recherche l’indexent et il n’y a aucun décalage de mise en page visible.

CLS nul

Le contenu est intégré dans la première réponse HTML. Pas de récupération côté client, pas de flash de contenu générique.

Visible pour le SEO

Le HTML personnalisé figure dans le code source de la page. Les moteurs de recherche et les aperçus sur les réseaux sociaux voient le contenu réel.

Natif au framework

Des adaptateurs de premier ordre pour Next.js, Nuxt, Remix et SvelteKit — ou utilisez le SDK core avec n’importe quel serveur Node.js.

Prêt pour l'Edge

Construit sur la Web Fetch API. Fonctionne avec Node.js 18+, Cloudflare Workers, Vercel Edge Functions et Deno.

Comment ça marche

1

Installer le SDK

Ajoutez le package @rlvt/web-sdk à votre projet.
2

Créer un client

Initialisez un ReelevantClient — aucune configuration n’est requise (le SDK utilise le Runner de production par défaut).
3

Appeler le Runner

Dans votre route ou votre composant serveur, appelez client.run() avec l’ID du Workflow et l’entrypoint. Le SDK appelle le Runner Reelevant et renvoie du contenu typé (HTML, JSON ou image).
4

Effectuer le rendu du contenu

Injectez le contenu renvoyé dans le template de votre page. Le SDK marque la sortie avec data-rlvt-ssr afin que le tracker côté client existant sache qu’il doit ignorer ces zones.
5

Suivre les clics

Après l’affichage du contenu, configurez toujours le tracking des clics — utilisez soit redirectionUrl comme <a href>, soit appelez result.trackClick() côté serveur. Cela garantit que les données d’attribution sont capturées pour chaque interaction.

Choisissez votre intégration

Next.js

React Server Components, middleware de l’App Router et le composant ReelevantZone.

Nuxt

Helpers d’événements H3, middleware serveur et le composable useReelevant.

Remix

Helpers de loader, gestion des cookies et extraction du contexte de requête.

SvelteKit

Fonctions de load serveur, hooks et helpers de contexte d’événement.

SDK core (tout serveur Node.js)

Utilisez le SDK core directement avec Express, Fastify, Hono ou tout runtime serveur.