Block preview: ventana de vista previa del bloque
Block preview es una ventana de vista previa que muestra en tiempo real el resultado del bloque. Es la misma en las pantallas de configuración de los bloques de recomendaciones y de los bloques dinámicos, y se abre con el botón «Open in modal».
Para qué sirve
Al configurar un bloque (estrategia, filtros, audiencia), conviene saber enseguida qué productos aparecerán en sus resultados con esa configuración. Block preview te permite comprobarlo sin publicar el bloque en el sitio y sin salir del panel de administración.
Pestaña Basic: lista de productos
La ventana tiene tres pestañas: Basic | Explanation | Investigate.
La primera, Basic, muestra una tabla con los productos que aparecerán en los resultados del bloque con la configuración actual:
- Los productos se cargan automáticamente al desplazarte hacia abajo en la tabla.
- La tabla muestra una vista previa de las tarjetas (nombre, imagen, marcador y metadatos breves).
- En el bloque Similar products, la vista previa se genera a partir del bloque guardado, y la pantalla lo indica con el aviso «The preview is generated based on the saved block — form changes will be applied after saving». Para ver el efecto de tus cambios, guarda primero el bloque.
Pestaña Explanation: por qué aparece un producto
La segunda pestaña, Explanation, responde a la pregunta de por qué un producto concreto aparece en el bloque. Debajo de cada tarjeta se muestran etiquetas con los motivos de la selección, por ejemplo «Ordered together», «Matching attributes», «In the same section», «In the popular ranking», «Viewed» o «Substituted as popular».
Las etiquetas siguen un orden lógico: primero la sustitución de resultados (fallback a productos populares), después la selección (por qué el producto está ahí), luego el ranking (por qué ocupa esa posición) y al final la penalización (por ejemplo, «Lower — price difference» indica que el producto se colocó más abajo por la diferencia de precio).
Explanation explica los resultados producto por producto: qué influyó en cada tarjeta. Investigate muestra el panorama de la solicitud completa: qué regla de audiencia se aplicó, qué advertencias generó el sistema y si se usó el fallback. Si no hay motivos de selección, la pestaña muestra un mensaje como «No data for explanation». Es normal, por ejemplo, cuando la vista previa está vacía.
Pestaña Investigate: diagnóstico
La tercera pestaña, Investigate, sirve para depurar. Muestra qué ocurrió internamente al generar los resultados:
| Sección en pantalla | Significado |
|---|---|
| Audience rule applied | Regla de audiencia que se aplicó a la solicitud actual. Consulta Audience Filter (se abre en una pestaña nueva). |
| Warnings | Mensajes de diagnóstico, por ejemplo «el conjunto de atributos está vacío» o «el fallback seleccionó productos que no son de la categoría elegida». |
| Fallback used | Indica si se usó la ruta de fallback (mostrar como respaldo los productos en tendencia). |
| Request context | Contexto de la solicitud: los datos que recibió el sistema al generar la vista previa (ID de usuario, carrito, categorías seleccionadas, etc.). |
Si no hay datos para una sección, la pestaña Investigate no la muestra. No es un error.
Simulate user (ID): vista previa en nombre de un usuario
En la pantalla de configuración del bloque, la sección Context for preview define el contexto con el que se genera la vista previa. El campo depende del tipo de bloque:
| Tipo de bloque | Campo de contexto de la vista previa |
|---|---|
| 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 (modo automático) | Test product ID |
En los bloques personalizados, el campo es Simulate user (ID) (en el diagnóstico de la pestaña Investigate, el mismo valor aparece como simulatedUserId). Introduce el ID de cualquier usuario y la vista previa mostrará el resultado como si la solicitud viniera de él. Esto es útil para:
- Comprobar las recomendaciones personales (Personal recommendations, Repeat purchase) de un cliente concreto.
- Reproducir una queja del tipo «en mi bloque aparecen productos que no corresponden»: introduce el ID de ese cliente y verás lo mismo que él.
Si no indicas Simulate user (ID), la vista previa usa tu propio contexto de administrador, y en los bloques personalizados los resultados pueden aparecer vacíos o ser irrelevantes.
Permiso blocks.preview
El acceso a la vista previa del bloque se controla con un permiso propio, blocks.preview, en el árbol de permisos (se abre en una pestaña nueva).
Esto te permite:
- Asignar un rol que edite bloques sin acceso a la vista previa (por ejemplo, para gestores de contenido que solo trabajan con el formulario).
- Ocultar a algunos administradores datos sensibles que podrían quedar expuestos en Investigate (sección Request context).
Asigna blocks.preview a quienes configuran y verifican los resultados de los bloques. A los gestores de contenido, solo si necesitan ver los resultados reales del bloque antes de publicarlo.