Problemen met Market Insights

Dit document behandelt problemen met de Market Hub- en Market Insights-functies van de ADP Car Market Hub-plugin, inclusief het Market Hub-beheerderstabblad, de weergave van de prijsbeoordeling, de Days on Lot-berekening en de dagelijkse prijsanalyse.

Wanneer u dit document moet gebruiken

Lees dit document wanneer:

• Het Market Hub-beheerderstabblad geen gegevens toont, streepjes weergeeft of onverwachte prijsbeoordelingen laat zien.
• Alle voertuigen de status no_data tonen in de kolom Market Score op de voertuiglijsttabel.
• Days on Lot-waarden ontbreken, nul zijn of onverwacht grote getallen tonen.
• De instelling voor de Market Hub-doelmarkt niet correct wordt opgeslagen.
• De dagelijkse prijsanalyse niet lijkt te draaien.
• Het Market Hub-tabblad de melding "Market Insights is not included in this license" toont.

Overzicht

De Market Insights-functie bestaat uit twee componenten:

Market Hub-tabblad (beheerderspagina as24ci-market-hub): Biedt een filterbare, gepagineerde prijsvergelijkingstabel. Voor elk voertuig toont het een statusbadge (good_price, fair_price, overpriced of no_data), een mediaanprijs van de markt, een prijsafwijkingspercentage en een steekproefgrootte (aantal vergelijkbare advertenties). Het toont ook verzamelkaarten voor de gemiddelde prijsafwijking en het aantal concurrerende, redelijke en te dure voertuigen.

Pricing Engine: Een dagelijkse achtergrondanalyse die via WP-Cron draait. Voor elk gepubliceerd as24ci_car-bericht berekent deze:

• Days on Lot — het aantal kalenderdagen sinds het voertuig is gepubliceerd, opgeslagen in het _as24ci_days_on_lot post-metaveld.
• Market Median price — opgehaald uit de Hub API en opgeslagen in _as24ci_market_price_median.
• Price Score — een concurrentiescore van 0–100 opgeslagen in _as24ci_price_score.

Belangrijk: In de huidige plugin-versie worden de marktgegevens die door de Hub API worden geretourneerd, gegenereerd als een realistische simulatie. Echte marktgegevens vereisen een verbinding met de Market Hub-back-endservice, die wordt geleverd via uw plugin-licentie in plaats van een sleutel die u handmatig invoert.

Configuratiereferentie

Het Market Hub-beheerderstabblad heeft één enkele instelling — de Target Market-kiezer. Er is geen door de klant beheerde API-sleutel om in te voeren. Toegang tot Market Insights wordt volledig geregeld door uw plugin-licentie (het market_insights_allowed-functierecht); wanneer dit in uw licentie is inbegrepen, zijn marktvergelijkingsgegevens beschikbaar zonder verdere configuratie.

Opmerking: Eerdere plugin-versies toonden een veld "Hub API Key" op dit tabblad. Dat veld is verwijderd. Toegang tot Market Insights wordt nu beheerd via de plugin-licentie, dus u hoeft hier geen sleutel meer in te voeren of op te slaan.

Marktgegevens worden per voertuig gedurende 15 minuten gecached met behulp van een WordPress transient met de sleutel as24ci_hub_data_{post_id}. De cache voor geaggregeerde analyses gebruikt de transient as24ci_analytics_market_intel.

Diagnostische stappen

Stap 1: Controleer of de Pricing Engine-cron is gepland

1. Ga in de WordPress-beheeromgeving naar het tabblad System & Help van de plugin.
2. Zoek naar de gebeurtenis as24ci_pricing_analysis_cron in de weergave van het cron-schema.
3. Als de cron-gebeurtenis niet in de lijst staat, is de dagelijkse analyse niet gepland.

Om deze opnieuw in te plannen:

1. Deactiveer en reactiveer de plugin. De activeringshook roept Pricing_Engine::schedule() aan.
2. U kunt ook een handmatige importrun starten vanaf het tabblad Importer van de plugin. Dit activeert ook de actie as24ci_vehicle_imported, die onmiddellijk prijsgegevens voor elk voertuig berekent en opslaat.

Stap 2: Controleer de kolom Market Score op de voertuiglijsttabel

1. Ga naar de Vehicles-berichtenlijsttabel in de WordPress-beheeromgeving (/wp-admin/edit.php?post_type=as24ci_car).
2. Kijk naar de kolom Market Score (toegevoegd door de Pricing Engine).
3. Als alle rijen een streepje (—) tonen, hebben ofwel nog geen voertuigen prijsgegevens, ofwel heeft de Hub API no_data geretourneerd voor alle voertuigen.

Een no_data-statusbadge betekent dat het voertuig geen prijs heeft opgeslagen in _as24ci_price. Voertuigen die zonder prijswaarde zijn geïmporteerd, tonen altijd no_data.

Stap 3: Controleer de Days on Lot-waarden

Days on Lot wordt berekend op basis van de post_date_gmt (voorkeur) of post_date (terugval voor conceptberichten) van het voertuigbericht. De plugin valideert de datum en negeert elke waarde die:

• Een nuldatum is (0000-00-00 00:00:00).
• In de toekomst ligt (geplande berichten tonen 0).
• Meer dan ongeveer 20 jaar bedraagt (behandeld als een corrupte datumbron).

Als Days on Lot voor alle voertuigen 0 toont:

1. Controleer of de voertuigen een geldige publicatiedatum hebben in de WordPress-berichtenlijsttabel.
2. Controleer of voertuigen zijn geïmporteerd met default_post_status ingesteld op draft. Conceptberichten hebben mogelijk pas een UTC-publicatiedatum wanneer ze voor het eerst worden gepubliceerd. Days on Lot wordt automatisch opnieuw berekend wanneer een voertuig overgaat naar de status publish.

Stap 4: Controleer de instelling voor de doelmarkt

1. Open het beheerderstabblad Market Hub van de plugin.
2. Controleer of de Target Market is ingesteld op een van de ondersteunde waarden: CH, DE, AT, IT, FR, BE, NL, ES.
3. Sla de instellingen op als u wijzigingen aanbrengt.

Een ongeldige of lege doelmarkt valt standaard terug op DE.

Stap 5: Wis de cache met marktgegevens

Als gegevens verouderd of bevroren lijken:

1. Gebruik een WordPress transient-beheertool (bijvoorbeeld een plugin of WP-CLI) om alle transients met het voorvoegsel as24ci_hub_data_ te verwijderen.
2. Verwijder de geaggregeerde analyse-transient as24ci_analytics_market_intel.
3. Herlaad het Market Hub-tabblad. Er worden nieuwe gegevens gegenereerd bij de volgende paginalading.

U kunt ook WP-CLI gebruiken:

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

Stap 6: Controleer het plugin-logboek

Open het plugin-logboek (via het tabblad Logs of op wp-content/uploads/as24ci-logs/adp-car-market-hub.log) en zoek naar:

• [PricingEngine] — vermeldingen van de dagelijkse analyse.
• has been on the lot for … days (threshold: 45) — waarschuwingen over veroudering voor voertuigen die langer dan 45 dagen in de voorraad staan.
• Eventuele fouten van het Hub API-verzoek.

Operationele opmerkingen

• Drempelwaarde voor veroudering: Voertuigen die langer dan 45 dagen in de voorraad staan, genereren een warning-logboekvermelding tijdens de dagelijkse analyse. Voertuigen die langer dan 30 dagen in de voorraad staan, worden gemarkeerd in de dashboardwidget "Top Stale Vehicles".
• Berekening van de prijsbeoordeling: De score is 100 wanneer de prijs van het voertuig op of onder de marktmediaan ligt. Deze neemt lineair af tot 0 wanneer de prijs van het voertuig 20% boven de mediaan ligt. Een score of 0 wordt ook geretourneerd wanneer er geen marktgegevens zijn of wanneer het voertuig geen prijs heeft.
• Ongeldig maken van de cache: De Hub API-cache per voertuig wordt automatisch ongeldig gemaakt wanneer een voertuig definitief wordt verwijderd. De geaggregeerde analyse-cache wordt ongeldig gemaakt telkens wanneer een voertuig wordt geïmporteerd, bijgewerkt of verwijderd.
• Pricing Engine en importer: Telkens wanneer een voertuig wordt geïmporteerd of bijgewerkt, berekent de Pricing Engine de score onmiddellijk via de actie as24ci_vehicle_imported. U hoeft niet te wachten op de volgende dagelijkse cron-run.
• Cron-afhankelijkheid: De dagelijkse cron van de Pricing Engine (as24ci_pricing_analysis_cron) is afhankelijk van WP-Cron. Op sites waar DISABLE_WP_CRON is ingesteld op true, zal deze cron niet starten tenzij er een externe cron-trigger is geconfigureerd. Zie Cron-fouten voor meer details.
• Hub API-back-end: De basis-URL van de Market Hub API is https://api.car-market-hub.ad-promotion.ch/v1. Verbinding met deze service is geautoriseerd via uw plugin-licentie, niet via een sleutel die u invoert op het Market Hub-tabblad. Hoewel de back-end nog niet live is, retourneert de plugin realistische gesimuleerde waarden.
• Licentiecontrole: Market Insights is een gelicentieerde functie. Wanneer de plugin-licentie niet actief is, wordt het Market Hub-tabblad vervangen door een vergrendelingsscherm en wordt de dagelijkse prijsanalyse overgeslagen (er wordt geen prijs-meta geschreven), maar er worden geen bestaande gegevens verwijderd. Wanneer de licentie actief is maar geen Market Insights bevat, toont het tabblad een kaart met "Market Insights is not included in this license" en worden er geen verversingsacties uitgevoerd.

Probleemoplossing

Gerelateerde documenten

• Toestemmingsfouten
• Cron-fouten
• Importfouten
• API-verbindingsfouten