Importfehler

Dieses Dokument behandelt Fehler, 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-Protokoll 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 Protokoll 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 geschaltete 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 (als „übersprungen“ gezählt).
• Wenn lastModifiedDate fehlt, weicht das Plugin auf einen Inhalts-Hash aus. Wenn der Hash unverändert ist, wird das Fahrzeug übersprungen.

Bilder werden separat behandelt. Wenn der Bildwarteschlangen-Modus aktiviert ist (standardmäßig für Cron- und REST-Läufe aktiv), wird nur das erste Bild pro Fahrzeug sofort heruntergeladen. Die verbleibenden Bilder werden in eine asynchrone Warteschlange eingereiht und von einem Hintergrund-Worker heruntergeladen. Siehe Bild-Importfehler 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 Berechtigungsfehler, wenn Zugriffsbeschränkungen im Protokoll erscheinen.

Diagnoseschritte

Schritt 1: Überprüfen Sie das Ergebnis des letzten Durchlaufs

1. Gehen Sie zum Admin-Dashboard des Plugins oder zum Reiter 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 Durchlauf nicht geändert haben.
4. Eine Fehleranzahl ungleich Null weist darauf hin, dass bestimmte Inserate fehlgeschlagen sind. Fahren Sie mit Schritt 2 fort.

Schritt 2: Lesen Sie das Import-Protokoll

Öffnen Sie die Protokolldatei 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 hat beim Speichern des Beitrags einen Fehler zurückgegeben.
• Import runner – Zusammenfassungszeilen am Anfang und Ende jedes Durchlaufs.
• Hard delete FAILED – eine Fahrzeuglöschung während der vollständigen Synchronisierung konnte nicht abgeschlossen werden.
• Full sync skipped – die Sicherheitsvorkehrung für die vollständige Synchronisierung wurde ausgelöst, da keine Remote-Inserate zurückgegeben wurden.

Wenn die detaillierte Protokollierung 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: Überprüfen Sie den Inseratsstatus in AutoScout24

Inserate, die vom Importer übersprungen werden, weil sie inaktiv oder nicht live sind, erscheinen nicht als Fehler im Import-Protokoll; 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: Überprüfen Sie die Begrenzung der Fahrzeuganzahl

Wenn automatische Importe (über Cron oder REST) konfiguriert sind, kann eine maximale Fahrzeuganzahl pro Durchlauf festgelegt sein. Wenn dieses Limit erreicht ist, stoppt der Durchlauf und das Protokoll 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 Reiter 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öße, 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 großen Katalog mit häufigen Inseratsänderungen.

Schritt 5: Überprüfen Sie die Konfiguration der Seller ID

1. Gehen Sie zum Reiter 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 aufgehoben und der nächste Durchlauf fortgesetzt.

Wenn Sie die Sperre sofort aufheben müssen:

• Verwenden Sie ein Plugin zur Verwaltung von Transients in WordPress 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 Protokoll 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-Post-Meta. Benutzerdefinierte oder nicht standardmäßige 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 vorgesehen, um manuell gepflegte Beschreibungen zu schützen.

Konfigurationsreferenz

Betriebliche Hinweise

• Der Importer verfolgt die Post-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 eine vollständige Aktualisierung durch.
• Der Post-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 vorhandenen Beitrag zu aktualisieren.
• Die vollständige Synchronisierung (Löschen veralteter Fahrzeuge) wird nur ausgeführt, wenn während des Durchlaufs kein Fahrzeuglimit erreicht wurde. Wenn ein Limit den Durchlauf vorzeitig stoppt, wird die vollständige Synchronisierung übersprungen, um zu verhindern, dass fahrzeuge fälschlicherweise gelöscht werden, die in diesem Durchlauf einfach nicht erreicht wurden.
• Die vollständige Synchronisierung enthält eine Sicherheitsvorkehrung: Wenn die von der API zurückgegebene Menge an Remote-Inseraten leer ist, wird das Löschen 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, wird dies möglicherweise nicht wirksam. Sehr große Kataloge erfordern möglicherweise eine Ausführung über den Server-Cron.

Fehlerbehebung

Verwandte Dokumente

• Übersicht zur Fehlerbehebung
• API-Verbindungsfehler
• Cron-Fehler
• Bild-Importfehler