Skip to main content

Installation

Mise en place

1. Créer l’instance du client

Créez une instance de client partagée dans un module réservé au serveur :

2. Ajouter le middleware d’identité

Créez middleware.ts à la racine de votre projet :
Cela garantit que chaque visiteur dispose d’un cookie rlvt_tmpId avant qu’aucun contenu personnalisé ne soit demandé.

Flux de requête

Utiliser ReelevantZone (recommandé)

ReelevantZone est un React Server Component asynchrone qui récupère et affiche du contenu personnalisé :

ZoneProps

Rendu personnalisé avec du JSON

Pour la personnalisation headless où vous souhaitez construire votre propre UI :

Utilisation manuelle (sans ReelevantZone)

Si vous préférez un contrôle direct :

Plusieurs zones sur une page

Récupérez plusieurs zones en parallèle pour des performances optimales :
Chaque ReelevantZone est un composant asynchrone indépendant qui récupère son contenu en parallèle lorsqu’il est rendu au même niveau. Vous n’avez pas besoin d’utiliser explicitement runAll avec les composants — Next.js gère automatiquement la récupération en parallèle.

Tracking des clics

Le tracking des clics doit toujours être configuré après l’affichage. Chaque affichage de contenu doit avoir un mécanisme de tracking des clics correspondant — soit un lien de redirection, soit un appel à trackClick().
Chaque RunResult inclut redirectionUrl et trackClick(). Deux patterns :

Lien de redirection

Utilisez redirectionUrl directement comme <a href> :

Fire-and-forget côté serveur

Appelez result.trackClick() depuis une Server Action — elle enregistre le clic et absorbe toutes les erreurs :
Consultez SDK core — Tracking des clics pour tous les détails.

Compatibilité avec le tracker client

Le SDK ajoute data-rlvt-ssr="true" aux éléments rendus. Le tracker Reelevant côté client ignore automatiquement les zones portant cet attribut, il n’y a donc ni double chargement ni scintillement. Vous pouvez toujours utiliser le tracker client sur la même page pour :
  • Le tracking d’événements (clics, impressions, conversions)
  • Les zones uniquement côté client (contenu dépendant du consentement, overlays)
  • Les intégrations on-site (déclencheurs datalayer, règles d’URL)