Herramientas de Depuración de Generación
Dos ajustes de la pestaña Generation Options te permiten limitar o enfocar la generación del feed durante la resolución de problemas — sin modificar tu programación cron ni la configuración de producción.
Disponible desde v2.4.6
Descripción general
Cuando un producto muestra datos inesperados en el catálogo de Facebook, o cuando quieres probar un cambio de configuración sin esperar a que se procese todo el catálogo, estas herramientas te permiten acotar la generación exactamente a los productos que te interesan o limitar la cantidad total a un número pequeño. Ambos ajustes son temporales por diseño: el módulo te avisa de forma prominente cuando alguno está activo para que recuerdes limpiarlo antes de la próxima ejecución programada.
Ambos campos se encuentran en la pestaña Generation Options de la página de configuración del módulo.
Ajustes
| Campo | Clave de configuración | Valor predeterminado | Descripción |
|---|---|---|---|
| Max Products Generation | FPF_GENERATE_MAX_PRODUCTS | 0 (desactivado) | Limita el total de productos incluidos en el feed a este número. 0 significa sin límite. |
| Debug Product Feed Generation | FPF_FEED_DEBUG_IDS | vacío (desactivado) | Lista de IDs de producto separados por comas. Cuando está definida, el feed contiene únicamente estos productos y se omiten todos los demás. |
Max Products Generation
Introduce cualquier número entero positivo para detener el feed una vez procesados ese número de productos. Las consultas SQL que recuperan el listado de productos se reescriben para aplicar un LIMIT a nivel de base de datos, de modo que la generación se detiene antes y es proporcionalmente más rápida.
Este ajuste se aplica globalmente a todas las tiendas, idiomas y feeds de países en la misma ejecución.
Advertencia: Cuando este campo contiene un valor distinto de cero, el módulo muestra un banner de aviso en la parte superior de cada página de configuración recordándote que hay un límite de generación activo. Borra el campo (ponlo a
0) una vez finalizado el proceso de prueba para que tu feed en producción incluya el catálogo completo.
Debug Product Feed Generation
Escribe el nombre o ID de un producto en el campo de búsqueda y selecciónalo en la lista de autocompletado. Puedes añadir varios productos. El módulo almacena la selección como una lista de IDs de producto separados por comas.
Durante la generación, cualquier producto cuyo ID no esté en la lista se omite inmediatamente con el motivo de omisión debug — no se escribe XML para él y no cuenta en los totales de error. Los productos de la lista pasan por el pipeline de generación completo exactamente igual que en una ejecución normal: se aplican precios, combinaciones, imágenes, gastos de envío, etiquetas personalizadas y la asignación de categorías de Google.
Esto hace que el ajuste sea útil para dos flujos de trabajo distintos:
- Diagnóstico de un producto concreto — ves la salida exacta (o el error) de ese producto de forma aislada, sin ruido procedente de otros artículos del catálogo.
- Verificación puntual de cambios de configuración — aplica un cambio, lanza una generación manual con una lista pequeña de IDs e inspecciona el resultado antes de lanzar una ejecución completa.
Advertencia: Cuando este campo no está vacío, el módulo muestra un banner de aviso en cada página de configuración. El mensaje incluye el número de productos seleccionados y un enlace directo al campo. Borra la selección cuando hayas terminado las pruebas.
Casos de uso
Verificar un producto mal configurado Un producto muestra el precio incorrecto o una imagen faltante en el catálogo de Facebook. Introduce su ID en Debug Product Feed Generation, haz clic en Generate Feed Now desde la pestaña de generación manual y abre la URL del feed. Verás únicamente la entrada de ese producto y podrás compararla con lo que esperas.
Probar una nueva configuración con un catálogo grande
Tienes 15.000 productos y quieres verificar que activar una nueva etiqueta personalizada funciona correctamente antes de lanzar una generación completa. Establece Max Products Generation en 50, guarda y lanza una generación manual. El feed se genera en segundos. Revisa la salida y vuelve a poner el límite a 0.
Aislar un problema con combinaciones Un producto con múltiples combinaciones de talla/color está generando entradas duplicadas. Añade el ID del producto a Debug Product Feed Generation y genera. El feed muestra únicamente las combinaciones de ese producto, lo que facilita identificar qué atributos de combinación están causando la duplicación.
Notas importantes
- Ambos ajustes afectan a todos los feeds de tiendas e idiomas en la misma ejecución de generación — no son por tienda ni por idioma.
- Cuando Debug Product Feed Generation está activo, no se aplica el límite normal de verbosidad del registro. Los registros de generación muestran cada producto a medida que se procesa, ofreciéndote una salida detallada incluso con configuraciones de registro más bajas.
- Establecer Max Products Generation en
1produce un feed válido de un solo producto, lo que es una forma rápida de verificar que la URL del feed es accesible y el formato XML es correcto antes de investigar problemas de contenido. - Ambos ajustes persisten hasta que los borres manualmente. Una ejecución lanzada por cron también respetará estos límites, por lo que una ejecución cron en producción generaría un feed incompleto o filtrado si olvidas limpiar los ajustes tras las pruebas.
- Ningún ajuste cambia la ubicación del archivo del feed ni la URL que Facebook usa para obtener el catálogo. La misma URL del feed se actualiza tanto si generaste una ejecución de prueba filtrada como una ejecución de producción completa.