Probleme mit Market Insights

Dieses Dokument behandelt Probleme mit den Funktionen Market Hub und Market Insights des ADP Car Market Hub-Plugins, einschliesslich des Admin-Tabs Market Hub, der Anzeige der Preisbewertung, der Berechnung der Standzeit (Days on Lot) und der täglichen Preisanalyse.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, wenn:

• Der Admin-Tab Market Hub keine Daten anzeigt, Striche darstellt oder unerwartete Preisbewertungen anzeigt.
• Alle Fahrzeuge den Status no_data in der Spalte "Market Score" der Fahrzeugliste aufweisen.
• Die Werte für die Standzeit (Days on Lot) fehlen, Null sind oder unerwartet grosse Zahlen anzeigen.
• Die Einstellung für den Zielmarkt im Market Hub nicht korrekt gespeichert wird.
• Die tägliche Preisanalyse scheinbar nicht ausgeführt wird.
• Der Tab Market Hub die Meldung "Market Insights is not included in this license" anzeigt.

Übersicht

Die Funktion Market Insights besteht aus zwei Komponenten:

Market Hub-Tab (Admin-Seite as24ci-market-hub): Bietet eine filterbare, paginierte Preisvergleichstabelle. Für jedes Fahrzeug wird ein Status-Badge angezeigt (good_price, fair_price, overpriced oder no_data), ein Markt-Medianpreis, eine prozentuale Preisabweichung und die Stichprobengrösse (Anzahl vergleichbarer Angebote). Zudem werden aggregierte Karten für die durchschnittliche Preisabweichung sowie die Anzahl wettbewerbsfähiger, fairer und überteuerter Fahrzeuge angezeigt.

Pricing Engine: Eine tägliche Hintergrundanalyse, die über WP-Cron ausgeführt wird. Für jeden veröffentlichten as24ci_car-Post berechnet sie:

• Days on Lot (Standzeit) — die Anzahl der Kalendertage seit der Veröffentlichung des Fahrzeugs, gespeichert im Post-Meta-Feld _as24ci_days_on_lot.
• Market Median price (Markt-Medianpreis) — wird von der Hub-API abgerufen und in _as24ci_market_price_median gespeichert.
• Price Score (Preisbewertung) — ein Wettbewerbsfähigkeitswert von 0 bis 100, gespeichert in _as24ci_price_score.

Wichtig: In der aktuellen Plugin-Version werden die von der Hub-API zurückgegebenen Marktdaten als realistische Simulation generiert. Echte Marktdaten erfordern eine Verbindung zum Market Hub-Backend-Dienst, der über Ihre Plugin-Lizenz bereitgestellt wird und nicht über einen Schlüssel, den Sie manuell eingeben.

Konfigurationsreferenz

Der Admin-Tab Market Hub verfügt über eine einzige Einstellung — die Auswahl des Zielmarkts (Target Market). Es gibt keinen vom Kunden verwalteten API-Schlüssel einzugeben. Der Zugriff auf Market Insights wird vollständig über Ihre Plugin-Lizenz (das Feature-Recht market_insights_allowed) gesteuert; wenn dieses in Ihrer Lizenz enthalten ist, stehen die Marktvergleichsdaten ohne weitere Konfiguration zur Verfügung.

Hinweis: Frühere Plugin-Versionen enthielten auf diesem Tab ein Feld "Hub API Key". Dieses Feld wurde entfernt. Der Zugriff auf Market Insights wird nun über die Plugin-Lizenz verwaltet, sodass Sie hier keinen Schlüssel mehr eingeben oder speichern müssen.

Marktdaten werden pro Fahrzeug für 15 Minuten über einen WordPress-Transient mit dem Schlüssel as24ci_hub_data_{post_id} zwischengespeichert. Der Cache für die aggregierten Analysen verwendet den Transient as24ci_analytics_market_intel.

Diagnoseschritte

Schritt 1: Überprüfen, ob der Cron-Job der Pricing Engine geplant ist

1. Gehen Sie im WordPress-Admin-Bereich zum Tab System & Help des Plugins.
2. Suchen Sie in der Cron-Zeitplananzeige nach dem Ereignis as24ci_pricing_analysis_cron.
3. Wenn das Cron-Ereignis nicht aufgelistet ist, ist die tägliche Analyse nicht geplant.

So planen Sie es neu:

1. Deaktivieren Sie das Plugin und aktivieren Sie es erneut. Der Aktivierungs-Hook ruft Pricing_Engine::schedule() auf.
2. Alternativ können Sie einen manuellen Importlauf über den Importer-Tab des Plugins auslösen. Dies löst ebenfalls die Aktion as24ci_vehicle_imported aus, wodurch die Preisdaten für jedes Fahrzeug sofort berechnet und gespeichert werden.

Schritt 2: Die Spalte "Market Score" in der Fahrzeugliste überprüfen

1. Rufen Sie die Post-Verzeichnisliste Vehicles im WordPress-Admin-Bereich auf (/wp-admin/edit.php?post_type=as24ci_car).
2. Betrachten Sie die Spalte Market Score (hinzugefügt von der Pricing Engine).
3. Wenn alle Zeilen einen Strich (—) aufweisen, liegen entweder für keine Fahrzeuge bisher Preisdaten vor oder die Hub-API hat für alle Fahrzeuge no_data zurückgegeben.

Ein Status-Badge no_data bedeutet, dass für das Fahrzeug kein Preis in _as24ci_price gespeichert ist. Fahrzeuge, die ohne Preiswert importiert wurden, zeigen immer no_data an.

Schritt 3: Die Werte für "Days on Lot" überprüfen

Die Standzeit (Days on Lot) wird anhand des Fahrzeug-Posts post_date_gmt (bevorzugt) oder post_date (Fallback für Entwürfe) berechnet. Das Plugin validiert das Datum und verwirft jeden Wert, der:

• Ein Null-Datum ist (0000-00-00 00:00:00).
• In der Zukunft liegt (geplante Posts zeigen 0).
• Ungefähr 20 Jahre überschreitet (wird als fehlerhafte Datumsquelle behandelt).

Wenn Days on Lot für alle Fahrzeuge 0 anzeigt:

1. Überprüfen Sie in der WordPress-Post-Liste, ob die Fahrzeuge ein gültiges Veröffentlichungsdatum haben.
2. Prüfen Sie, ob Fahrzeuge mit default_post_status auf draft importiert wurden. Entwürfe haben unter Umständen kein UTC-Veröffentlichungsdatum, bis sie zum ersten Mal veröffentlicht werden. Days on Lot wird automatisch neu berechnet, wenn ein Fahrzeug in den Status publish wechselt.

Schritt 4: Die Einstellung für den Zielmarkt überprüfen

1. Öffnen Sie den Admin-Tab Market Hub des Plugins.
2. Vergewissern Sie sich, dass der Target Market auf einen der unterstützten Werte eingestellt ist: CH, DE, AT, IT, FR, BE, NL, ES.
3. Speichern Sie die Einstellungen, falls Sie Änderungen vornehmen.

Ein ungültiger oder leerer Zielmarkt fällt standardmässig auf DE zurück.

Schritt 5: Den Marktdaten-Cache leeren

Wenn die Daten veraltet oder eingefroren erscheinen:

1. Verwenden Sie ein Tool zur Verwaltung von WordPress-Transients (z. B. ein Plugin oder WP-CLI), um alle Transients mit dem Präfix as24ci_hub_data_ zu löschen.
2. Löschen Sie den Transient für die aggregierten Analysen as24ci_analytics_market_intel.
3. Laden Sie den Tab Market Hub neu. Beim nächsten Seitenaufruf werden frische Daten generiert.

Sie können auch WP-CLI verwenden:

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

Schritt 6: Das Plugin-Protokoll überprüfen

Öffnen Sie das Plugin-Protokoll (über den Tab Logs oder unter wp-content/uploads/as24ci-logs/adp-car-market-hub.log) und suchen Sie nach:

• [PricingEngine] — Einträge der täglichen Analyse.
• has been on the lot for … days (threshold: 45) — Warnungen wegen Veralterung für Fahrzeuge, die länger als 45 Tage gelistet sind.
• Allfälligen Fehlern bei der Hub-API-Anfrage.

Betriebliche Hinweise

• Schwellenwert für Veralterung: Fahrzeuge, die sich seit mehr als 45 Tagen auf dem Platz befinden, erzeugen während der täglichen Analyse einen Log-Eintrag warning. Fahrzeuge, die sich seit mehr als 30 Tagen auf dem Platz befinden, werden im Dashboard-Widget "Top Stale Vehicles" hervorgehoben.
• Berechnung der Preisbewertung: Die Bewertung liegt bei 100, wenn der Preis des Fahrzeugs dem Markt-Median entspricht oder darunter liegt. Sie sinkt linear auf 0, wenn der Preis des Fahrzeugs 20 % über dem Median liegt. Eine Bewertung von 0 wird auch zurückgegeben, wenn keine Marktdaten vorliegen oder das Fahrzeug keinen Preis hat.
• Cache-Invalidierung: Der fahrzeugspezifische Hub-API-Cache wird automatisch ungültig gemacht, wenn ein Fahrzeug endgültig gelöscht wird. Der aggregierte Analyse-Cache wird ungültig gemacht, sobald ein Fahrzeug importiert, aktualisiert oder gelöscht wird.
• Pricing Engine und Importer: Jedes Mal, wenn ein Fahrzeug importiert oder aktualisiert wird, berechnet die Pricing Engine dessen Bewertung sofort über die Aktion as24ci_vehicle_imported. Sie müssen nicht auf den nächsten täglichen Cron-Lauf warten.
• Cron-Abhängigkeit: Der tägliche Cron-Job der Pricing Engine (as24ci_pricing_analysis_cron) basiert auf WP-Cron. Auf Websites, auf denen DISABLE_WP_CRON auf true gesetzt ist, wird dieser Cron-Job nicht ausgeführt, es sei denn, es ist ein externer Cron-Trigger konfiguriert. Weitere Einzelheiten finden Sie unter Cron-Fehler.
• Hub-API-Backend: Die Basis-URL der Market Hub-API lautet https://api.car-market-hub.ad-promotion.ch/v1. Die Verbindung zu diesem Dienst wird über Ihre Plugin-Lizenz autorisiert, nicht über einen Schlüssel, den Sie im Tab Market Hub eingeben. Solange das Backend noch nicht live ist, gibt das Plugin realistische simulierte Werte zurück.
• Lizenzschranke: Market Insights ist eine lizenzierte Funktion. Wenn die Plugin-Lizenz nicht aktiv ist, wird der Tab Market Hub durch einen Sperrbildschirm ersetzt und die tägliche Preisanalyse wird übersprungen (es werden keine Preis-Metadaten geschrieben), bestehende Daten werden jedoch nicht gelöscht. Wenn die Lizenz aktiv ist, aber Market Insights nicht enthält, zeigt der Tab die Meldung "Market Insights is not included in this license" an und es werden keine Aktualisierungen durchgeführt.

Fehlerbehebung

Verwandte Dokumente

• Berechtigungsfehler
• Cron-Fehler
• Importfehler
• API-Verbindungsfehler