Problemi di Market Insights

Questo documento copre i problemi con le funzionalità Market Hub e Market Insights del plugin ADP Car Market Hub, inclusi la scheda amministrativa Market Hub, la visualizzazione del punteggio di prezzo, il calcolo dei giorni nel parco veicoli (Days on Lot) e l'analisi giornaliera dei prezzi.

Quando utilizzare questo documento

Leggi questo documento quando:

• La scheda amministrativa Market Hub non mostra dati, visualizza trattini o mostra punteggi di prezzo imprevisti.
• Tutti i veicoli mostrano lo stato no_data nella colonna Market Score della tabella dell'elenco dei veicoli.
• I valori di Days on Lot sono mancanti, pari a zero o mostrano numeri insolitamente grandi.
• L'impostazione del mercato di riferimento di Market Hub non viene salvata correttamente.
• L'analisi giornaliera dei prezzi non sembra essere in esecuzione.
• La scheda Market Hub mostra il messaggio "Market Insights is not included in this license".

Panoramica

La funzionalità Market Insights ha due componenti:

Scheda Market Hub (pagina di amministrazione as24ci-market-hub): fornisce una tabella di confronto dei prezzi filtrabile e impaginata. Per ogni veicolo mostra un badge di stato (good_price, fair_price, overpriced o no_data), un prezzo medio di mercato, una percentuale di deviazione del prezzo e una dimensione del campione (numero di annunci comparabili). Mostra anche schede aggregate per la deviazione media del prezzo e i conteggi dei veicoli competitivi, equi e sovrapprezzati.

Pricing Engine: un'analisi in background giornaliera eseguita tramite WP-Cron. Per ogni articolo as24ci_car pubblicato calcola:

• Days on Lot — il numero di giorni di calendario trascorsi dalla pubblicazione del veicolo, memorizzato nel campo meta dell'articolo _as24ci_days_on_lot.
• Prezzo medio di mercato — recuperato dall'API Hub e memorizzato in _as24ci_market_price_median.
• Price Score — un punteggio di competitività da 0 a 100 memorizzato in _as24ci_price_score.

Importante: Nella versione attuale del plugin, i dati di mercato restituiti dall'API Hub sono generati come una simulazione realistica. I dati di mercato reali richiedono una connessione al servizio backend Market Hub, che viene fornito tramite la licenza del plugin anziché tramite una chiave inserita manualmente.

Riferimento di configurazione

La scheda amministrativa Market Hub ha una singola impostazione: il selettore Target Market. Non c'è nessuna chiave API gestita dal cliente da inserire. L'accesso a Market Insights è regolato interamente dalla licenza del plugin (il diritto di funzionalità market_insights_allowed); quando è incluso nella licenza, i dati di confronto del mercato sono disponibili senza ulteriori configurazioni.

Nota: Le versioni precedenti del plugin mostravano un campo "Hub API Key" in questa scheda. Tale campo è stato rimosso. L'accesso a Market Insights è ora gestito tramite la licenza del plugin, quindi non è più necessario inserire o memorizzare alcuna chiave qui.

I dati di mercato vengono memorizzati nella cache per veicolo per 15 minuti utilizzando un transient di WordPress con la chiave as24ci_hub_data_{post_id}. La cache delle analisi aggregate utilizza il transient as24ci_analytics_market_intel.

Passaggi diagnostici

Passaggio 1: Verificare che il cron del Pricing Engine sia pianificato

1. Nell'amministrazione di WordPress, vai alla scheda System & Help del plugin.
2. Cerca l'evento as24ci_pricing_analysis_cron nella visualizzazione della pianificazione cron.
3. Se l'evento cron non è elencato, l'analisi giornaliera non è pianificata.

Per pianificarla nuovamente:

1. Disattiva e riattiva il plugin. L'hook di attivazione chiama Pricing_Engine::schedule().
2. In alternativa, avvia un'esecuzione manuale dell'importazione dalla scheda Importer del plugin. Questo attiva anche l'azione as24ci_vehicle_imported, che calcola e memorizza immediatamente i dati sui prezzi per ciascun veicolo.

Passaggio 2: Controllare la colonna Market Score nella tabella dell'elenco dei veicoli

1. Vai alla tabella dell'elenco degli articoli Vehicles nell'amministrazione di WordPress (/wp-admin/edit.php?post_type=as24ci_car).
2. Guarda la colonna Market Score (aggiunta dal Pricing Engine).
3. Se tutte le righe mostrano un trattino (—), significa che nessun veicolo ha ancora dati sui prezzi o che l'API Hub ha restituito no_data per tutti i veicoli.

Un badge di stato no_data indica che il veicolo non ha alcun prezzo memorizzato in _as24ci_price. I veicoli importati senza un valore di prezzo mostreranno sempre no_data.

Passaggio 3: Controllare i valori di Days on Lot

Days on Lot viene calcolato a partire da post_date_gmt (preferito) o post_date (fallback per gli articoli in bozza) dell'articolo del veicolo. Il plugin convalida la data e scarta qualsiasi valore che:

• È una data zero (0000-00-00 00:00:00).
• È nel futuro (gli articoli pianificati mostrano 0).
• Supera i 20 anni circa (trattato come una sorgente di data corrotta).

Se Days on Lot mostra 0 per tutti os veicoli:

1. Verifica che i veicoli abbiano una data di pubblicazione valida nella tabella dell'elenco degli articoli di WordPress.
2. Controlla se i veicoli sono stati importati con default_post_status impostato su draft. Gli articoli in bozza potrebbero non avere una data di pubblicazione UTC finché non vengono pubblicati per la prima volta. Days on Lot viene ricalcolato automaticamente quando un veicolo passa allo stato publish.

Passaggio 4: Verificare l'impostazione del mercato di riferimento

1. Apri la scheda amministrativa Market Hub del plugin.
2. Conferma che Target Market sia impostato su uno dei valori supportati: CH, DE, AT, IT, FR, BE, NL, ES.
3. Salva le impostazioni se apporti modifiche.

Un mercato di riferimento non valido o vuoto assume come valore predefinito DE.

Passaggio 5: Cancellare la cache dei dati di mercato

Se i dati appaiono obsoleti o bloccati:

1. Utilizza uno strumento di gestione dei transient di WordPress (ad esempio un plugin o WP-CLI) per eliminare tutti i transient con il prefisso as24ci_hub_data_.
2. Elimina il transient delle analisi aggregate as24ci_analytics_market_intel.
3. Ricarica la scheda Market Hub. Nuovi dati verranno generati al successivo caricamento della pagina.

Puoi anche utilizzare WP-CLI:

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

Passaggio 6: Controllare il registro del plugin

Apri il registro del plugin (dalla scheda Logs o su wp-content/uploads/as24ci-logs/adp-car-market-hub.log) e cerca:

• [PricingEngine] — voci dell'analisi giornaliera.
• has been on the lot for … days (threshold: 45) — avvisi di obsolescenza per i veicoli che sono in elenco da più di 45 giorni.
• Eventuali errori dalla richiesta dell'API Hub.

Note operative

• Soglia di obsolescenza: i veicoli presenti nel parco veicoli da più di 45 giorni generano una voce di registro warning durante l'analisi giornaliera. I veicoli presenti nel parco veicoli da più di 30 giorni vengono evidenziati nel widget della bacheca "Top Stale Vehicles".
• Calcolo del punteggio di prezzo: il punteggio è 100 quando il prezzo del veicolo è pari o inferiore alla mediana di mercato. Diminuisce linearmente fino a 0 quando il prezzo del veicolo è superiore del 20% rispetto alla mediana. Viene restituito un punteggio pari a 0 anche quando non ci sono dati di mercato o quando il veicolo non ha prezzo.
• Invalidazione della cache: la cache dell'API Hub per veicolo viene invalidata automaticamente quando un veicolo viene eliminato definitivamente. La cache aggregata delle analisi viene invalidata ogni volta che un veicolo viene importato, aggiornato o eliminato.
• Pricing Engine e importatore: ogni volta che un veicolo viene importato o aggiornato, il Pricing Engine calcola immediatamente il suo punteggio tramite l'azione as24ci_vehicle_imported. Non è necessario attendere l'esecuzione successiva del cron giornaliero.
• Dipendenza da cron: il cron giornaliero del Pricing Engine (as24ci_pricing_analysis_cron) si affida a WP-Cron. Sui siti in cui DISABLE_WP_CRON è impostato su true, questo cron non si attiverà a meno che non sia configurato un trigger cron esterno. Vedi Errori di Cron per maggiori dettagli.
• Backend dell'API Hub: l'URL di base dell'API Market Hub è https://api.car-market-hub.ad-promotion.ch/v1. La connessione a questo servizio è autorizzata tramite la licenza del plugin, non tramite una chiave inserita nella scheda Market Hub. Sebbene il backend non sia ancora attivo, il plugin restituisce valori simulati realistici.
• Controllo della licenza: Market Insights è una funzionalità soggetta a licenza. Quando la licenza del plugin non è operativa, la scheda Market Hub viene sostituita da una schermata di blocco e l'analisi giornaliera dei prezzi viene saltata (non viene scritta alcuna meta informazione sui prezzi), ma nessun dato esistente viene eliminato. Quando la licenza è operativa ma non include Market Insights, la scheda mostra una scheda "Market Insights is not included in this license" e le azioni di aggiornamento non vengono eseguite.

Risoluzione dei problemi

Documenti correlati

• Errori di autorizzazione
• Errori di Cron
• Errori di importazione
• Errori di connessione API