Probleme mit Market Insights

Dieses Dokument behandelt Probleme mit den Funktionen Market Hub und Market Insights des ADP Car Market Hub-Plugins, einschließlich des Admin-Tabs Market Hub, der Anzeige der Preisbewertung, der Berechnung der Standtage (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, Bindestriche darstellt oder unerwartete Preisbewertungen anzeigt.
• Alle Fahrzeuge den Status no_data in der Spalte „Market Score“ der Fahrzeug-Listenansicht aufweisen.
• Die Werte für die Standtage (Days on Lot) fehlen, Null sind oder unerwartet hohe Zahlen aufweisen.
• Die Einstellung für den Market Hub-Zielmarkt nicht korrekt gespeichert wird.
• Die tägliche Preisanalyse scheinbar nicht ausgeführt wird.
• Der Tab Market Hub die Meldung „Market Insights ist in dieser Lizenz nicht enthalten“ 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 (good_price, fair_price, overpriced oder no_data), ein Markt-Medianpreis, eine prozentuale Preisabweichung und die Stichprobengröße (Anzahl vergleichbarer Angebote) angezeigt. Zudem werden aggregierte Karten für die durchschnittliche Preisabweichung sowie die Anzahl wettbewerbsfähiger, fairer und überteuerter Fahrzeuge dargestellt.

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

• Standtage (Days on Lot) — die Anzahl der Kalendertage seit der Veröffentlichung des Fahrzeugs, gespeichert im Post-Meta-Feld _as24ci_days_on_lot.
• Markt-Medianpreis — vom Hub-API abgerufen und in _as24ci_market_price_median gespeichert.
• Preisbewertung (Price Score) — eine Wettbewerbsfähigkeitsbewertung von 0–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. 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-Schlüssel“. 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 & Hilfe des Plugins.
2. Suchen Sie in der Anzeige des Cron-Zeitplans nach dem Ereignis as24ci_pricing_analysis_cron.
3. Wenn das Cron-Ereignis nicht aufgeführt ist, ist die tägliche Analyse nicht geplant.

So planen Sie sie 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, die die Preisdaten für jedes Fahrzeug sofort berechnet und speichert.

Schritt 2: Die Spalte „Market Score“ in der Fahrzeug-Listenansicht prüfen

1. Rufen Sie die Beitragsliste Fahrzeuge 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 Bindestrich (—) 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: Werte für Standtage (Days on Lot) prüfen

Die Standtage werden anhand des Beitragsdatums post_date_gmt (bevorzugt) oder post_date (Fallback für Entwürfe) des Fahrzeugs 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 Beiträge zeigen 0).
• Ungefähr 20 Jahre überschreitet (wird als fehlerhafte Datumsquelle behandelt).

Wenn die Standtage für alle Fahrzeuge 0 anzeigen:

1. Stellen Sie sicher, dass die Fahrzeuge in der WordPress-Beitragsliste ein gültiges Veröffentlichungsdatum haben.
2. Prüfen Sie, ob Fahrzeuge mit dem Status 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. Die Standtage werden automatisch neu berechnet, wenn ein Fahrzeug in den Status publish übergeht.

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 Zielmarkt 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äßig auf DE zurück.

Schritt 5: Den Marktdaten-Cache leeren

Wenn 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 Laden der Seite 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 prüfen

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

• [PricingEngine] — Einträge aus 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.
• Eventuellen Fehlern bei der Hub-API-Anfrage.

Betriebliche Hinweise

• Veralterungsschwelle: Fahrzeuge, die sich länger als 45 Tage auf dem Stellplatz befinden, erzeugen während der täglichen Analyse einen Protokolleintrag warning. Fahrzeuge, die sich länger als 30 Tage auf dem Stellplatz befinden, werden im Dashboard-Widget „Top Stale Vehicles“ hervorgehoben.
• Berechnung der Preisbewertung: Die Bewertung beträgt 100, wenn der Preis des Fahrzeugs auf oder unter dem Markt-Median 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 invalidiert, wenn ein Fahrzeug endgültig gelöscht wird. Der aggregierte Analyse-Cache wird invalidiert, 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, ein externer Cron-Trigger ist 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 eine Karte „Market Insights ist in dieser Lizenz nicht enthalten“ an und es werden keine Aktualisierungsaktionen durchgeführt.

Fehlerbehebung

Zugehörige Dokumente

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