Problèmes de Market Insights

Ce document couvre les problèmes liés aux fonctionnalités Market Hub et Market Insights de l'extension ADP Car Market Hub, y compris l'onglet d'administration Market Hub, l'affichage du score de prix, le calcul du nombre de jours sur le parc et l'analyse quotidienne des prix.

Quand utiliser ce document

Lisez ce document lorsque :

• L'onglet d'administration Market Hub n'affiche aucune donnée, affiche des tirets ou présente des scores de prix inattendus.
• Tous les véhicules affichent le statut no_data dans la colonne Market Score du tableau de la liste des véhicules.
• Les valeurs de Days on Lot (jours sur le parc) sont manquantes, égales à zéro ou affichent des nombres anormalement élevés.
• Le réglage du marché cible de Market Hub ne s'enregistre pas correctement.
• L'analyse quotidienne des prix ne semble pas s'exécuter.
• L'onglet Market Hub affiche le message « Market Insights is not included in this license ».

Aperçu

La fonctionnalité Market Insights comprend deux composants :

Onglet Market Hub (page d'administration as24ci-market-hub) : Fournit un tableau de comparaison des prix paginé et filtrable. Pour chaque véhicule, il affiche un badge de statut (good_price, fair_price, overpriced ou no_data), un prix médian du marché, un pourcentage d'écart de prix et une taille d'échantillon (nombre d'annonces comparables). Il affiche également des cartes d'agrégation pour l'écart de prix moyen et le décompte des véhicules compétitifs, corrects et trop chers.

Moteur de tarification (Pricing Engine) : Une analyse quotidienne en arrière-plan qui s'exécute via WP-Cron. Pour chaque publication as24ci_car publiée, il calcule :

• Days on Lot — le nombre de jours calendaires depuis la publication du véhicule, stocké dans le champ de méta de publication _as24ci_days_on_lot.
• Prix médian du marché — récupéré depuis l'API Hub et stocké dans _as24ci_market_price_median.
• Price Score — un score de compétitivité de 0 à 100 stocké dans _as24ci_price_score.

Important : Dans la version actuelle de l'extension, les données de marché renvoyées par l'API Hub sont générées sous forme de simulation réaliste. Les données de marché réelles nécessitent une connexion au service backend Market Hub, qui est fournie via la licence de votre extension plutôt que par une clé que vous saisissez manuellement.

Référence de configuration

L'onglet d'administration Market Hub comporte un seul réglage : le sélecteur de Marché cible (Target Market). Il n'y a pas de clé API gérée par le client à saisir. L'accès à Market Insights est entièrement régi par la licence de votre extension (le droit de fonctionnalité market_insights_allowed) ; lorsqu'il est inclus dans votre licence, les données de comparaison de marché sont disponibles sans configuration supplémentaire.

Note : Les versions antérieures de l'extension affichaient un champ « Hub API Key » sur cet onglet. Ce champ a été supprimé. L'accès à Market Insights est désormais géré via la licence de l'extension, vous n'avez donc plus besoin de saisir ou de stocker de clé ici.

Les données de marché sont mises en cache par véhicule pendant 15 minutes à l'aide d'un transient WordPress avec la clé as24ci_hub_data_{post_id}. Le cache des analyses agrégées utilise le transient as24ci_analytics_market_intel.

Étapes de diagnostic

Étape 1 : Vérifier que le cron du Pricing Engine est planifié

1. Dans l'administration WordPress, accédez à l'onglet System & Help de l'extension.
2. Recherchez l'événement as24ci_pricing_analysis_cron dans l'affichage de la planification cron.
3. Si l'événement cron n'est pas répertorié, l'analyse quotidienne n'est pas planifiée.

Pour le replanifier :

1. Désactivez et réactivez l'extension. Le hook d'activation appelle Pricing_Engine::schedule().
2. Alternativement, déclenchez une exécution d'importation manuelle depuis l'onglet Importer de l'extension. Cela déclenche également l'action as24ci_vehicle_imported, qui calcule et stocke immédiatement les données de tarification pour chaque véhicule.

Étape 2 : Vérifier la colonne Market Score sur le tableau de la liste des véhicules

1. Allez sur le tableau de la liste des publications Vehicles dans l'administration WordPress (/wp-admin/edit.php?post_type=as24ci_car).
2. Regardez la colonne Market Score (ajoutée par le Pricing Engine).
3. Si toutes les lignes affichent un tiret (—), soit aucun véhicule ne dispose encore de données de tarification, soit l'API Hub a renvoyé no_data pour tous les véhicules.

Un badge de statut no_data signifie que le véhicule n'a pas de prix stocké dans _as24ci_price. Les véhicules importés sans valeur de prix afficheront toujours no_data.

Étape 3 : Vérifier les valeurs de Days on Lot

Days on Lot est calculé à partir de la date post_date_gmt (préférée) ou post_date (valeur de secours pour les brouillons) de la publication du véhicule. L'extension valide la date et rejette toute valeur qui :

• Est une date nulle (0000-00-00 00:00:00).
• Est dans le futur (les publications planifiées affichent 0).
• Dépasse environ 20 ans (traité comme une source de date corrompue).

Si Days on Lot affiche 0 pour tous les véhicules :

1. Vérifiez que les véhicules ont une date de publication valide dans le tableau de la liste des publications WordPress.
2. Vérifiez si les véhicules ont été importés avec default_post_status défini sur draft. Les brouillons de publications peuvent ne pas avoir de date de publication UTC tant qu'ils ne sont pas publiés pour la première fois. Days on Lot est recalculé automatiquement lorsqu'un véhicule passe au statut publish.

Étape 4 : Vérifier le réglage du marché cible

1. Ouvrez l'onglet d'administration Market Hub de l'extension.
2. Confirmez que le Target Market est défini sur l'une des valeurs prises en charge : CH, DE, AT, IT, FR, BE, NL, ES.
3. Enregistrez les réglages si vous apportez des modifications.

Un marché cible invalide ou vide est défini par défaut sur DE.

Étape 5 : Effacer le cache des données de marché

Si les données semblent obsolètes ou figées :

1. Utilisez un outil de gestion des transients WordPress (par exemple une extension ou WP-CLI) pour supprimer tous les transients ayant le préfixe as24ci_hub_data_.
2. Supprimez le transient d'analyse agrégée as24ci_analytics_market_intel.
3. Rechargez l'onglet Market Hub. De nouvelles données seront générées lors du prochain chargement de la page.

Vous pouvez également utiliser WP-CLI :

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

Étape 6 : Consulter le journal de l'extension

Ouvrez le journal de l'extension (depuis l'onglet Logs ou à l'adresse wp-content/uploads/as24ci-logs/adp-car-market-hub.log) et recherchez :

• [PricingEngine] — entrées de l'analyse quotidienne.
• has been on the lot for … days (threshold: 45) — avertissements d'obsolescence pour les véhicules répertoriés depuis plus de 45 jours.
• Toutes les erreurs provenant de la requête API Hub.

Notes opérationnelles

• Seuil d'obsolescence : Les véhicules présents sur le parc depuis plus de 45 jours génèrent une entrée de journal warning lors de l'analyse quotidienne. Les véhicules présents sur le parc depuis plus de 30 jours sont mis en évidence dans le widget du tableau de bord « Top Stale Vehicles ».
• Calcul du score de prix : Le score est de 100 lorsque le prix du véhicule est égal ou inférieur à la médiane du marché. Il diminue de manière linéaire jusqu'à 0 lorsque le prix du véhicule est supérieur de 20 % à la médiane. Un score de 0 est également renvoyé lorsqu'il n'y a pas de données de marché ou lorsque le véhicule n'a pas de prix.
• Invalidation du cache : Le cache de l'API Hub par véhicule est invalidé automatiquement lorsqu'un véhicule est définitivement supprimé. Le cache agrégé des analyses est invalidé chaque fois qu'un véhicule est importé, mis à jour ou supprimé.
• Pricing Engine et importateur : Chaque fois qu'un véhicule est importé ou mis à jour, le Pricing Engine calcule immédiatement son score via l'action as24ci_vehicle_imported. Vous n'avez pas besoin d'attendre la prochaine exécution quotidienne du cron.
• Dépendance au cron : Le cron quotidien du Pricing Engine (as24ci_pricing_analysis_cron) s'appuie sur WP-Cron. Sur les sites où DISABLE_WP_CRON est défini sur true, ce cron ne se déclenchera pas à moins qu'un déclencheur de cron externe ne soit configuré. Voir Erreurs de cron pour plus de détails.
• Backend de l'API Hub : L'URL de base de l'API Market Hub est https://api.car-market-hub.ad-promotion.ch/v1. La connexion à ce service est autorisée via la licence de votre extension, et non par une clé que vous saisissez dans l'onglet Market Hub. Bien que le backend ne soit pas encore actif, l'extension renvoie des valeurs simulées réalistes.
• Restriction de licence : Market Insights est une fonctionnalité soumise à licence. Lorsque la licence de l'extension n'est pas opérationnelle, l'onglet Market Hub est remplacé par un écran de verrouillage et l'analyse quotidienne des prix est ignorée (aucune méta de tarification n'est écrite), mais aucune donnée existante n'est supprimée. Lorsque la licence est opérationnelle mais n'inclut pas Market Insights, l'onglet affiche un encadré « Market Insights is not included in this license » et les actions de rafraîchissement ne sont pas exécutées.

Dépannage

Documents connexes

• Erreurs de permissions
• Erreurs de cron
• Erreurs d'importation
• Erreurs de connexion API