Block preview : fenêtre d'aperçu du bloc
Block preview est une fenêtre d'aperçu qui affiche en temps réel le résultat d'un bloc. Elle est identique sur les écrans de configuration des blocs de recommandation et des blocs dynamiques, et s'ouvre avec le bouton « Open in modal ».
Pourquoi c'est utile
Lorsque vous configurez un bloc (stratégie, filtres, audience), vous voulez savoir tout de suite quels produits il renverra avec ces paramètres. Block preview vous permet de le vérifier sans publier le bloc sur le site et sans quitter l'interface d'administration.
Onglet Basic : liste des produits
La fenêtre comporte trois onglets : Basic | Explanation | Investigate.
Le premier, Basic, affiche le tableau des produits que le bloc renverra avec les paramètres actuels :
- Les produits se chargent automatiquement quand vous faites défiler le tableau vers le bas.
- Le tableau présente un aperçu des fiches (nom, image, marqueur, métadonnées succinctes).
- Pour le bloc Similar products, l'aperçu repose sur le bloc enregistré, comme l'indique l'écran : « The preview is generated based on the saved block — form changes will be applied after saving ». Pour voir l'effet de vos modifications, enregistrez d'abord le bloc.
Onglet Explanation : pourquoi un produit apparaît
Le deuxième onglet, Explanation, répond à la question « pourquoi ce produit a-t-il été inclus dans le bloc ? ». Sous chaque fiche produit, des badges indiquent les raisons de la sélection, par exemple « Ordered together », « Matching attributes », « In the same section », « In the popular ranking », « Viewed », « Substituted as popular ».
Les badges suivent un ordre logique : d'abord la substitution des résultats (fallback sur les produits populaires), puis la sélection (pourquoi le produit figure dans les résultats), ensuite le classement (pourquoi il occupe cette position) et enfin le déclassement (par exemple « Lower — price difference » : le produit a été descendu en raison d'une différence de prix).
Explanation explique les résultats produit par produit : ce qui a joué pour une fiche donnée. Investigate donne une vue de la requête dans son ensemble : quelle règle d'audience s'est appliquée, quels avertissements le système a émis, si le fallback a été activé. S'il n'y a aucune raison de sélection, l'onglet affiche un message du type « No data for explanation ». C'est normal, par exemple pour un aperçu vide.
Onglet Investigate : diagnostic
Le troisième onglet, Investigate, sert au débogage. Il montre ce qui s'est passé en coulisses lors de la constitution des résultats :
| Section à l'écran | Signification |
|---|---|
| Audience rule applied | Règle d'audience qui s'est appliquée à la requête en cours. Voir Audience Filter (s'ouvre dans un nouvel onglet). |
| Warnings | Diagnostics, par exemple « l'ensemble d'attributs est vide » ou « le fallback a sélectionné des produits hors de la catégorie choisie ». |
| Fallback used | Indique si le chemin de fallback (affichage de secours des produits tendance) a été déclenché. |
| Request context | Contexte de la requête : ce que le système a reçu pour construire l'aperçu (ID utilisateur, panier, catégories sélectionnées, etc.). |
Si une section n'a pas de données, elle n'apparaît pas dans l'onglet Investigate. Ce n'est pas une erreur.
Simulate user (ID) : aperçu au nom d'un utilisateur
Dans la section Context for preview de l'écran de configuration du bloc, vous définissez le contexte dans lequel l'aperçu est construit. Le champ dépend du type de bloc :
| Type de bloc | Champ de contexte de l'aperçu |
|---|---|
| Trending, Recently viewed, Personal recommendations, Repeat purchase | Simulate user (ID) |
| Cart complement, Cart similar | Test cart (product IDs) |
| Wishlist similar | Test wishlist (product IDs) |
| Frequently ordered, Similar products (mode automatique) | Test product ID |
Pour les blocs personnalisés, il s'agit du champ Simulate user (ID) (dans les diagnostics de l'onglet Investigate, la même valeur apparaît sous le nom simulatedUserId). Saisissez l'ID de n'importe quel utilisateur : l'aperçu construit les résultats comme si la requête venait de lui. C'est utile pour :
- vérifier les recommandations personnelles (Personal recommendations, Repeat purchase) d'un client précis ;
- reproduire une réclamation du type « mon bloc n'affiche pas les bons produits » : saisissez l'ID de ce client et voyez ce qu'il voit.
Si Simulate user (ID) n'est pas renseigné, l'aperçu utilise votre propre contexte d'administrateur, et les résultats des blocs personnalisés peuvent être vides ou non pertinents.
Droit d'accès blocks.preview
L'accès à l'aperçu des blocs est contrôlé par un droit distinct, blocks.preview, dans l'arbre des droits (s'ouvre dans un nouvel onglet).
Ce droit permet :
- d'attribuer un rôle qui modifie les blocs sans accès à l'aperçu (par exemple pour des gestionnaires de contenu qui ne travaillent que dans le formulaire) ;
- de masquer à certains administrateurs des données sensibles susceptibles d'être exposées via Investigate (section Request context).
Accordez blocks.preview aux personnes qui configurent et vérifient les résultats des blocs. Aux gestionnaires de contenu, seulement s'ils doivent voir les résultats réels du bloc avant publication.