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éezmiddleware.ts à la racine de votre projet :
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
ChaqueRunResult inclut redirectionUrl et trackClick(). Deux patterns :
Lien de redirection
UtilisezredirectionUrl directement comme <a href> :
Fire-and-forget côté serveur
Appelezresult.trackClick() depuis une Server Action — elle enregistre le clic et absorbe toutes les erreurs :
Compatibilité avec le tracker client
Le SDK ajoutedata-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)