Problemas de Market Insights

Este documento cubre los problemas con las funciones Market Hub y Market Insights del plugin ADP Car Market Hub, incluyendo la pestaña de administración de Market Hub, la visualización de la puntuación de precio, el cálculo de los días en stock (Days on Lot) y el análisis diario de precios.

Cuándo usar este documento

Lea este documento cuando:

• La pestaña de administración de Market Hub no muestre datos, muestre guiones o muestre puntuaciones de precios inesperadas.
• Todos los vehículos muestren el estado no_data en la columna Market Score de la tabla de listado de vehículos.
• Los valores de Days on Lot falten, sean cero o muestren números inesperadamente grandes.
• El ajuste del mercado objetivo de Market Hub no se guarde correctamente.
• El análisis diario de precios no parezca estar ejecutándose.
• La pestaña de Market Hub muestre el mensaje "Market Insights is not included in this license".

Descripción general

La función Market Insights consta de dos componentes:

Pestaña Market Hub (página de administración as24ci-market-hub): Proporciona una tabla de comparación de precios paginada y filtrable. Para cada vehículo muestra una etiqueta de estado (good_price, fair_price, overpriced o no_data), un precio medio de mercado, un porcentaje de desviación de precio y un tamaño de muestra (número de listados comparables). También muestra tarjetas de agregados para la desviación media de precios y recuentos de vehículos competitivos, con precio justo y sobrevalorados.

Motor de Precios (Pricing Engine): Un análisis diario en segundo plano que se ejecuta a través de WP-Cron. Para cada entrada de as24ci_car publicada, calcula:

• Days on Lot (Días en stock): el número de días naturales transcurridos desde que se publicó el vehículo, almacenado en el campo de metadatos de la entrada _as24ci_days_on_lot.
• Market Median price (Precio medio de mercado): obtenido de la API de Hub y almacenado en _as24ci_market_price_median.
• Price Score (Puntuación de precio): una puntuación de competitividad de 0 a 100 almacenada en _as24ci_price_score.

Importante: En la versión actual del plugin, los datos de mercado devueltos por la API de Hub se generan como una simulación realista. Los datos de mercado reales requieren una conexión al servicio backend de Market Hub, que se aprovisiona a través de la licencia de su plugin en lugar de una clave que introduzca manualmente.

Referencia de configuración

La pestaña de administración de Market Hub tiene un único ajuste: el selector de Target Market (Mercado objetivo). No hay ninguna clave de API gestionada por el cliente que deba introducirse. El acceso a Market Insights se rige en su totalidad por la licencia de su plugin (el derecho de función market_insights_allowed); cuando está incluido en su licencia, los datos de comparación de mercado están disponibles sin necesidad de realizar ninguna otra configuración.

Nota: Las versiones anteriores del plugin mostraban un campo "Hub API Key" en esta pestaña. Ese campo ha sido eliminado. El acceso a Market Insights ahora se gestiona a través de la licencia del plugin, por lo que ya no es necesario introducir ni almacenar ninguna clave aquí.

Los datos de mercado se almacenan en caché por vehículo durante 15 minutos utilizando un transitorio de WordPress con la clave as24ci_hub_data_{post_id}. La caché de analíticas agregadas utiliza el transitorio as24ci_analytics_market_intel.

Pasos de diagnóstico

Paso 1: Comprobar que el cron del Motor de Precios está programado

1. En la administración de WordPress, vaya a la pestaña System & Help del plugin.
2. Busque el evento as24ci_pricing_analysis_cron en la pantalla de programación de cron.
3. Si el evento de cron no aparece en la lista, el análisis diario no está programado.

Para volver a programarlo:

1. Desactive y vuelva a activar el plugin. El gancho de activación llama a Pricing_Engine::schedule().
2. Alternativamente, ejecute una importación manual desde la pestaña Importer del plugin. Esto también activa la acción as24ci_vehicle_imported, que calcula y almacena los datos de precios para cada vehículo de forma inmediata.

Paso 2: Comprobar la columna Market Score en la tabla de listado de vehículos

1. Vaya a la tabla de listado de entradas de Vehicles en la administración de WordPress (/wp-admin/edit.php?post_type=as24ci_car).
2. Observe la columna Market Score (añadida por el Motor de Precios).
3. Si todas las filas muestran un guion (—), significa que ningún vehículo tiene aún datos de precios o que la API de Hub devolvió no_data para todos los vehículos.

Una etiqueta de estado no_data significa que el vehículo no tiene ningún precio almacenado en _as24ci_price. Los vehículos importados sin un valor de precio siempre mostrarán no_data.

Paso 3: Comprobar los valores de Days on Lot

Days on Lot se calcula a partir de post_date_gmt (preferido) o post_date (alternativa para entradas en borrador) de la entrada del vehículo. El plugin valida la fecha y descarta cualquier valor que:

• Sea una fecha cero (0000-00-00 00:00:00).
• Esté en el futuro (las entradas programadas muestran 0).
• Supere aproximadamente los 20 años (se trata como una fuente de fecha corrupta).

Si Days on Lot muestra 0 para todos los vehículos:

1. Verifique que los vehículos tengan una fecha de publicación válida en la tabla de listado de entradas de WordPress.
2. Compruebe si los vehículos se importaron con default_post_status establecido en draft. Es posible que las entradas en borrador no tengan una fecha de publicación UTC hasta que se publiquen por primera vez. Days on Lot se vuelve a calcular automáticamente cuando un vehículo pasa al estado publish.

Paso 4: Verificar el ajuste del mercado objetivo

1. Abra la pestaña de administración Market Hub del plugin.
2. Confirme que el Target Market esté configurado en uno de los valores admitidos: CH, DE, AT, IT, FR, BE, NL, ES.
3. Guarde los ajustes si realiza algún cambio.

Un mercado objetivo no válido o vacío se establece por defecto en DE.

Paso 5: Borrar la caché de datos de mercado

Si los datos parecen desactualizados o congelados:

1. Utilice una herramienta de gestión de transitorios de WordPress (por ejemplo, un plugin o WP-CLI) para eliminar todos los transitorios con el prefijo as24ci_hub_data_.
2. Elimine el transitorio de analíticas agregadas as24ci_analytics_market_intel.
3. Recargue la pestaña Market Hub. Se generarán datos nuevos en la siguiente carga de página.

También puede usar WP-CLI:

wp transient delete --search=as24ci_hub_data_
wp transient delete as24ci_analytics_market_intel

Paso 6: Comprobar el registro del plugin

Abra el registro del plugin (desde la pestaña Logs o en wp-content/uploads/as24ci-logs/adp-car-market-hub.log) y busque:

• [PricingEngine]: entradas del análisis diario.
• has been on the lot for … days (threshold: 45): advertencias de antigüedad para vehículos que han estado listados más de 45 días.
• Cualquier error de la solicitud de la API de Hub.

Notas operativas

• Umbral de antigüedad: Los vehículos que llevan más de 45 días en stock generan una entrada de registro warning durante el análisis diario. Los vehículos que llevan más de 30 días en stock se destacan en el widget del panel de control "Top Stale Vehicles".
• Cálculo de la puntuación de precio: La puntuación es 100 cuando el precio del vehículo es igual o inferior a la mediana del mercado. Disminuye linealmente hasta 0 cuando el precio del vehículo supera en un 20% la mediana. También se devuelve una puntuación de 0 cuando no hay datos de mercado o cuando el vehículo no tiene precio.
• Invalidación de caché: La caché de la API de Hub por vehículo se invalida automáticamente cuando un vehículo se elimina de forma permanente. La caché agregada de analíticas se invalida cada vez que se importa, actualiza o elimina cualquier vehículo.
• Motor de Precios e importador: Cada vez que se importa o actualiza un vehículo, el Motor de Precios calcula su puntuación inmediatamente a través de la acción as24ci_vehicle_imported. No es necesario esperar a la siguiente ejecución diaria del cron.
• Dependencia de cron: El cron diario del Motor de Precios (as24ci_pricing_analysis_cron) depende de WP-Cron. En sitios donde DISABLE_WP_CRON está establecido en true, este cron no se activará a menos que se configure un activador de cron externo. Consulte Errores de cron para obtener más detalles.
• Backend de la API de Hub: La URL base de la API de Market Hub es https://api.car-market-hub.ad-promotion.ch/v1. La conexión a este servicio se autoriza a través de la licencia de su plugin, no mediante una clave que introduzca en la pestaña Market Hub. Aunque el backend aún no está activo, el plugin devuelve valores simulados realistas.
• Control de licencia: Market Insights es una función sujeta a licencia. Cuando la licencia del plugin no está operativa, la pestaña Market Hub se sustituye por una pantalla de bloqueo y se omite el análisis diario de precios (no se escriben metadatos de precios), pero no se elimina ningún dato existente. Cuando la licencia está operativa pero no incluye Market Insights, la pestaña muestra una tarjeta con el mensaje "Market Insights is not included in this license" y no se realizan acciones de actualización.

Resolución de problemas

Documentos relacionados

• Errores de permisos
• Errores de cron
• Errores de importación
• Errores de conexión de la API