Importfehler

Dieses Dokument behandelt Fehlschläge, Teilergebnisse, Datenprobleme und Validierungsschritte für den Fahrzeugimportprozess im ADP Car Market Hub-Plugin.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, wenn:

• Ein manueller Import oder ein automatischer Importlauf abgeschlossen wird, aber weniger Fahrzeuge als erwartet in WordPress erscheinen.
• Fahrzeugdaten (Titel, Preis, Beschreibung, Felder) nach dem Import fehlerhaft sind oder fehlen.
• Das Import-Log Fehler für bestimmte Inserate anzeigt.
• Fahrzeuge nicht aktualisiert werden, obwohl sich die Inseratsdaten in AutoScout24 geändert haben.
• Fahrzeuge, die aus AutoScout24 entfernt wurden, immer noch in WordPress vorhanden sind (oder umgekehrt).

Wenn der Import überhaupt keine Ergebnisse liefert und das Log Authentifizierungs- oder HTTP-Fehler enthält, beginnen Sie zuerst mit API-Verbindungsfehler.

Übersicht

Der Importprozess ruft aktive Fahrzeuginserate von der AutoScout24-API für jede konfigurierte Seller ID ab und erstellt oder aktualisiert WordPress-Beiträge des Custom Post Type as24ci_car. Jeder Durchlauf meldet die Anzahl der eingefügten, aktualisierten, übersprungenen und fehlerhaften Ergebnisse.

Der Importer wendet die folgenden Filter automatisch an:

• Status-Filter: Nur Inserate mit status = activated werden importiert. Inaktive oder deaktivierte Inserate werden übersprungen.
• Live-Filter: Nur Inserate mit live = true (oder wenn das Feld fehlt) werden importiert. Nicht-live Inserate werden übersprungen.

Eine Änderungserkennung wird verwendet, um unnötige Updates zu vermeiden:

• Wenn die API-Antwort ein lastModifiedDate-Feld enthält und dieses mit dem beim letzten Import gespeicherten Wert übereinstimmt, wird das Fahrzeug übersprungen (gezählt als "skipped").
• Wenn lastModifiedDate fehlt, weicht das Plugin auf einen Inhalts-Hash aus. Wenn der Hash unverändert ist, wird das Fahrzeug übersprungen.

Bilder werden separat verarbeitet. Wenn der Bildwarteschlangen-Modus aktiviert ist (standardmässig für Cron- und REST-Läufe aktiv), wird nur das erste Bild pro Fahrzeug sofort heruntergeladen. Die restlichen Bilder werden in eine asynchrone Warteschlange eingereiht und von einem Hintergrundprozess heruntergeladen. Siehe Image Import Errors für bildspezifische Probleme.

Voraussetzungen

• Die API-Verbindung funktioniert. Überprüfen Sie dies auf der Systemstatus-Seite, bevor Sie Importprobleme untersuchen.
• Mindestens eine Seller ID ist in den Plugin-Einstellungen konfiguriert.
• Der Importer hat die Berechtigung, Beiträge zu schreiben und Medien hochzuladen. Siehe Permission Errors, wenn Zugriffsbeschränkungen im Log erscheinen.

Diagnoseschritte

Schritt 1: Das Ergebnis des letzten Laufs prüfen

1. Gehen Sie zum Admin-Dashboard des Plugins oder zum Tab System & Hilfe.
2. Sehen Sie sich die Zeit des letzten Importlaufs und die Ergebniszahlen an: eingefügt, aktualisiert, übersprungen, Fehler.
3. Eine hohe Anzahl an "übersprungenen" Einträgen ist normal, wenn die Änderungserkennung aktiv ist und sich die meisten Inserate seit dem letzten Lauf nicht geändert haben.
4. Eine Fehlerzahl ungleich Null weist darauf hin, dass bestimmte Inserate fehlgeschlagen sind. Fahren Sie mit Schritt 2 fort.

Schritt 2: Das Import-Log lesen

Öffnen Sie die Log-Datei des Plugins unter:

wp-content/uploads/as24ci-logs/adp-car-market-hub.log

Suchen Sie nach Zeilen, die error, failed oder die spezifische Listing ID enthalten, die Sie untersuchen. Nützliche Suchmuster:

• get_listing_details error – das Plugin konnte die vollständigen Details für ein bestimmtes Inserat nicht abrufen.
• wp_insert/wp_update error – WordPress gab beim Speichern des Beitrags einen Fehler zurück.
• Import runner – Zusammenfassungszeilen am Anfang und Ende jedes Laufs.
• Hard delete FAILED – eine Fahrzeuglöschung während der Vollsynchronisation konnte nicht abgeschlossen werden.
• Full sync skipped – die Sicherheitsvorkehrung der Vollsynchronisation wurde ausgelöst, da keine Remote-Inserate zurückgegeben wurden.

Wenn die detaillierte Protokollierung (Verbose Logging) aktiviert ist (Standard), sehen Sie auch fahrzeugspezifische Zeilen wie:

Import vehicle {listing_id} (seller {seller_id}) begin.
Import vehicle {listing_id} result=inserted.
Import vehicle {listing_id} result=skipped.

Schritt 3: Inseratsstatus in AutoScout24 überprüfen

Inserate, die vom Importer übersprungen werden, weil sie inaktiv oder nicht live sind, erscheinen nicht als Fehler im Import-Log; sie werden stillschweigend ausgeschlossen. Wenn ein Fahrzeug in AutoScout24 vorhanden ist, aber nicht importiert wurde:

1. Bestätigen Sie, dass der Inseratsstatus in der Verwaltungsoberfläche von AutoScout24 auf activated steht.
2. Bestätigen Sie, dass das Inserat als live markiert ist.
3. Überprüfen Sie, ob das Inserat zu einer Seller ID gehört, die in den Plugin-Einstellungen konfiguriert ist.

Schritt 4: Die Fahrzeug-Obergrenze prüfen

Wenn automatische Importe (Cron oder REST) konfiguriert sind, kann eine maximale Fahrzeuganzahl pro Durchlauf festgelegt sein. Wenn dieses Limit erreicht ist, stoppt der Durchlauf und das Log zeichnet eine Meldung "Fahrzeuglimit erreicht" auf. Die verbleibenden Fahrzeuge werden beim nächsten Durchlauf verarbeitet.

Zur Überprüfung:

1. Gehen Sie in den Plugin-Einstellungen zum Tab Import & Limits.
2. Überprüfen Sie die Einstellung Max. Fahrzeuge pro Cron-Lauf. Ein Wert von 0 bedeutet unbegrenzt.
3. Wenn das Limit niedriger ist als Ihre gesamte Kataloggrösse, erhöhen Sie es oder lassen Sie es auf 0, um eine unbegrenzte Verarbeitung zu ermöglichen.

Hinweis: Die Änderungserkennung führt dazu, dass in der Praxis die meisten Fahrzeuge bei jedem Durchlauf übersprungen werden. Ein moderates Limit ist im Allgemeinen ausreichend, es sei denn, Sie haben einen sehr grossen Katalog mit häufigen Inseratsänderungen.

Schritt 5: Die Konfiguration der Seller ID überprüfen

1. Gehen Sie zum Tab Einstellungen des Plugins.
2. Bestätigen Sie, dass das Feld Seller ID(s) die korrekten IDs enthält, eine pro Zeile oder durch Kommas getrennt.
3. Wenn mehrere Seller IDs konfiguriert sind, bestätigen Sie, dass jede aktiv und mit den konfigurierten Zugangsdaten zugänglich ist.

Schritt 6: Auf eine veraltete Importsperre prüfen

Ein Import-Sperr-Transient (as24ci_cron_import_running) verhindert überschneidende Durchläufe. Wenn ein vorheriger Durchlauf unterbrochen wurde, ohne die Sperre aufzuheben, werden nachfolgende Durchläufe für bis zu 40 Minuten blockiert. Nach diesem Zeitraum wird die Sperre automatisch gelöscht und der nächste Durchlauf fortgesetzt.

Wenn Sie die Sperre sofort aufheben müssen:

• Verwenden Sie ein WordPress-Transient-Verwaltungs-Plugin oder WP-CLI, um den Transient as24ci_cron_import_running zu löschen.
• Oder warten Sie, bis die 40-minütige Gültigkeitsdauer (TTL) der Sperre abläuft.

Schritt 7: Datenqualitätsprobleme untersuchen

Wenn ein Fahrzeug importiert wird, seine Daten jedoch fehlerhaft oder unvollständig sind:

1. Suchen Sie im Log nach Einträgen mit wp_insert/wp_update error für diese Listing ID.
2. Überprüfen Sie die rohe API-Antwort für das Inserat mithilfe der AutoScout24-API-Dokumentation oder den Entwickler-Tools des API-Anbieters.
3. Überprüfen Sie, ob das betreffende Feld vom Plugin gemappt wird. Das Plugin mappt Standard-Inseratsfelder von AutoScout24 auf WordPress-Beitrags-Meta-Daten. Benutzerdefinierte oder nicht standardmässige Felder werden möglicherweise nicht gemappt. Überprüfen Sie dieses Verhalten in der aktuellen Plugin-Version vor der Veröffentlichung.
4. Wenn KI-generierte Inhalte aktiviert sind und eine KI-Sperre (_as24ci_ai_locked = yes) für einen Beitrag gesetzt wurde, überschreibt der Import post_content oder post_excerpt für dieses Fahrzeug nicht. Dies ist so gewollt, um manuell gepflegte Beschreibungen zu schützen.

Konfigurationsreferenz

Betriebliche Hinweise

• Der Importer verfolgt die Beitrags-Meta-Werte _as24ci_last_modified und _as24ci_content_hash für jedes Fahrzeug, um Änderungen zu erkennen. Wenn diese Meta-Werte fehlen oder beschädigt sind, behandelt der nächste Durchlauf das Fahrzeug als geändert und führt ein vollständiges Update durch.
• Der Beitrags-Meta-Wert _as24ci_listing_id wird verwendet, um Remote-Inserate mit lokalen Beiträgen abzugleichen. Wenn diese Meta-Angabe in einem Beitrag fehlt, erstellt der Importer ein Duplikat, anstatt den bestehenden Beitrag zu aktualisieren.
• Die Vollsynchronisation (Löschen veralteter Fahrzeuge) wird nur ausgeführt, wenn während des Laufs kein Fahrzeuglimit erreicht wurde. Wenn ein Limit den Lauf vorzeitig stoppt, wird die Vollsynchronisation übersprungen, um zu verhindern, dass fahrzeuge fälschlicherweise gelöscht werden, die in diesem Lauf einfach noch nicht erreicht wurden.
• Die Vollsynchronisation enthält eine Sicherheitsvorkehrung: Wenn die von der API zurückgegebene Remote-Inseratsmenge leer ist, wird die Löschung vollständig übersprungen, um ein versehentliches Entfernen aller lokalen Fahrzeuge zu verhindern.
• Der Import läuft mit einem Ausführungszeitlimit von 300 Sekunden (5 Minuten), wenn er durch WP-Cron oder den REST-Endpunkt ausgelöst wird. Auf Hosting-Umgebungen, die set_time_limit einschränken, zeigt dies möglicherweise keine Wirkung. Sehr grosse Kataloge erfordern möglicherweise eine Ausführung über den Server-Cron.

Fehlerbehebung

Zugehörige Dokumente

• Fehlerbehebung — Übersicht
• API-Verbindungsfehler
• Cron-Fehler
• Bildimport-Fehler