Skip to main content

Pourquoi utiliser une sortie JSON ?

Le Client-Side Script et le Server-Side SDK diffusent tous deux du HTML rendu (ou des images) que vous injectez dans votre page. C’est idéal lorsque Reelevant contrôle à la fois la logique et le rendu visuel. Mais parfois, vous souhaitez que Reelevant prenne en charge les décisions de personnalisation tandis que votre propre frontend gère le rendu. C’est ce que vous offre l’approche par API JSON.

Contrôle total du rendu

Vous recevez des données structurées — noms de produits, prix, scores, URL — et vous les affichez avec vos propres composants, votre design system ou une UI native.

Agnostique au framework

Fonctionne avec React, Vue, Svelte, Flutter, iOS, Android ou tout client capable d’effectuer une requête HTTP et d’analyser du JSON.

Typé et prévisible

Les JSON Templates définissent un schéma en amont. Votre frontend sait exactement quels champs attendre — pas de suppositions, pas d’analyse de HTML.

Même moteur de personnalisation

Toute la puissance des Workflows Reelevant — Datasources, conditions, splits, Real-Time Testing — mais avec une sortie JSON au lieu de contenu visuel.

Quand choisir cette approche

Comment ça marche

1

Créer un JSON Template

Dans la plateforme Reelevant, créez un JSON Template qui définit le schéma (champs et types) et déclare des variables nommées. Chaque variable correspond à une valeur de Datasource qui sera résolue au moment de l’exécution.
2

Construire un Workflow avec un Output Node JSON Template

Ajoutez un Output Node JSON Template à votre Workflow. Sélectionnez le template que vous avez créé, puis liez chaque variable à un champ de Datasource — comme valeur scalaire, comme tableau (pour les listes de produits, les recommandations, etc.), ou comme élément fixe de la Datasource (une position précise).
3

Publier le Workflow

La publication vérifie que tous les Nodes JSON Template référencent le même template et que le template existe. Une fois publié, le Workflow est en ligne.
4

Appeler l'endpoint du Runner

Votre application effectue une simple requête HTTP GET vers le Runner Reelevant. La réponse est un objet JSON correspondant au schéma de votre template — avec toutes les variables résolues en données personnalisées en temps réel.

Exemple

Supposons que vous vouliez personnaliser une carte de recommandation produit. La définition de votre JSON Template pourrait ressembler à ceci :
Chaque champ est soit une valeur static (fixée au moment de la conception), soit une dependency (une variable nommée résolue à partir de vos Datasources au moment de l’exécution). À l’exécution, le moteur Reelevant résout chaque dependency — de sorte que chaque visiteur voit le produit le plus pertinent pour lui. La réponse est un objet JSON plat :
Votre frontend affiche simplement les champs JSON à l’aide de ses propres composants.

Étapes suivantes

Intégration technique

Endpoints de l’API, format de requête, structure de réponse et exemples de code.

JSON Template (Output Node)

Découvrez la configuration de l’Output Node JSON Template dans l’éditeur de Workflow.