Aperçu du bloc — fenêtre d'aperçu du bloc
Aperçu du bloc — fenêtre d'aperçu qui montre le résultat du bloc en temps réel. Elle est identique sur les écrans de configuration des blocs recommandés et dynamiques et s'ouvre avec le bouton « Ouvrir dans un modal ».
Pourquoi c'est nécessaire
Lorsque vous configurez un bloc (stratégie, filtres, audience) — vous souhaitez immédiatement comprendre quels produits seront affichés avec ces paramètres. L'aperçu du bloc permet de vérifier cela sans publier le bloc sur le site, sans quitter l'interface d'administration.
Onglet Basic — liste des produits
La fenêtre se compose de trois onglets : Basic | Explanation | Investigate.
Le premier onglet — Basic. Il montre un tableau des produits qui apparaîtront dans le bloc avec les paramètres actuels :
- Les produits se chargent automatiquement lors du défilement vers le bas du tableau.
- Dans le tableau — aperçu des fiches (nom, image, étiquette, métadonnées succinctes).
- Pour le bloc Produits similaires, l'aperçu est construit à partir du bloc sauvegardé — un message s'affiche à l'écran : « L'aperçu est généré sur la base du bloc sauvegardé — les modifications du formulaire seront appliquées après la sauvegarde ». Pour voir le résultat des modifications, sauvegardez d'abord le bloc.
Onglet Explanation — pourquoi le produit est dans l'affichage
Le deuxième onglet — Explanation. Il répond à la question « pourquoi ce produit a-t-il été inclus dans le bloc » : sous chaque fiche produit, des badges sont affichés avec les raisons de la sélection — par exemple, « Commandé ensemble », « Attributs correspondants », « Même catégorie », « Dans le classement tendance », « Consulté », « Substitué comme populaire ».
Les badges sont ordonnés par sens : d'abord la substitution de l'affichage (fallback sur les produits populaires), ensuite la sélection (pourquoi le produit est ici), puis le classement (pourquoi il est à cette position) et enfin la dévaluation (par exemple, « Lower — price difference » — le produit a été retiré en raison d'une différence de prix).
Explanation explique l'affichage pour chaque produit — ce qui a fonctionné pour une fiche spécifique. Investigate montre le tableau pour la requête dans son ensemble — quelle règle d'audience a été appliquée, quels avertissements le système a émis, si un fallback a été activé. S'il n'y a pas de raisons de sélection, l'onglet affichera 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 — est nécessaire pour le débogage. Il montre ce qui s'est passé « sous le capot » lors de la génération de l'affichage :
| Section à l'écran | Que signifie |
|---|---|
| Règle d'audience appliquée | Quelle règle d'audience a fonctionné pour la requête actuelle. Voir Filtre d'audience. |
| Avertissements | Diagnostic — par exemple, « ensemble d'attributs vide », « le fallback a sélectionné des produits en dehors de la catégorie choisie ». |
| Fallback utilisé | Indicateur : le chemin de fallback a-t-il été activé (affichage de produits tendance de secours). |
| Contexte de la requête | Contexte de la requête — ce que le système a reçu lors de la construction de l'aperçu (ID utilisateur, panier, catégories choisies, etc.). |
Si des données pour une section donnée sont absentes, cette section ne s'affiche pas dans l'onglet Investigate — ce n'est pas une erreur.
Simuler utilisateur (ID) — aperçu « au nom » de l'utilisateur
Sur l'écran de configuration du bloc dans la section Contexte pour l'aperçu, le contexte est défini pour lequel l'aperçu est construit. Le champ dépend du type de bloc :
| Type de bloc | Champ de contexte d'aperçu |
|---|---|
| Tendance, Récemment consulté, Recommandations personnelles, Achat répété | Simuler utilisateur (ID) |
| Complément de panier, Similaire au panier | Test panier (ID produits) |
| Similaire à la liste de souhaits | Test liste de souhaits (ID produits) |
| Commandés fréquemment, Produits similaires (mode automatique) | Test ID produit |
Pour les blocs personnalisés, ce champ est Simuler utilisateur (ID) (dans le diagnostic de l'onglet Investigate, cette même valeur est mentionnée comme simulatedUserId). Entrez l'ID de n'importe quel utilisateur — l'aperçu construira le résultat comme si la requête venait de lui. Pratique pour :
- Vérifier les recommandations personnelles (Recommandations personnelles, Achat répété) pour un client spécifique ;
- Reproduire une plainte du type « je n'ai pas les bons produits dans le bloc » — entrez son ID et voyez ce qu'il verra.
Sans spécification de Simuler utilisateur (ID), l'aperçu utilise votre propre contexte d'administration, et pour les blocs personnalisés, l'affichage peut être vide ou non pertinent.
Droit d'accès blocks.preview
L'accès à l'aperçu du bloc est contrôlé par un droit distinct blocks.preview dans l'arbre des droits.
Cela permet :
- D'attribuer un rôle qui édite des blocs, sans accès à l'aperçu (par exemple, pour les gestionnaires de contenu « uniquement formulaire »).
- De cacher aux administrateurs certaines données sensibles qui pourraient être révélées via Investigate (section Contexte de la requête).
Donnez blocks.preview à ceux qui configurent et vérifient l'affichage des blocs. Aux gestionnaires de contenu — seulement s'ils doivent voir l'affichage réel du bloc avant publication.