Playbook: Feed-Import schlägt fehl

Einleitung

Wenn ein Feed-Import fehlschlägt, stellt ein oder zeigt eine ungewöhnlich hohe Anzahl von Fehlern und übersprungenen Zeilen, beeinträchtigt dies die Verfügbarkeit Ihrer Produktdaten. Dieser Leitfaden hilft Ihnen, die Ursache systematisch zu identifizieren und zu beheben.

Symptom: Wann ein Import fehlschlägt

Ein Importlauf gilt als fehlgeschlagen oder problematisch, wenn eines der folgenden Szenarien eintritt:

• Der Importlauf wird nicht abgeschlossen und bleibt in einem Status wie 'Wird verarbeitet' stecken.
• Der Lauf wird beendet, aber mit einer Fehlermeldung, die auf Verarbeitungsprobleme hinweist.
• Der Lauf wird abgeschlossen, enthält aber eine unerwartete Anzahl übersprungener Zeilen oder fehlgeschlagener Datensätze.
• Die Quelle zeigt einen Status mit beeinträchtigter Integrität an.

Diese Symptome deuten darauf hin, dass Ihre Produktdaten nicht korrekt synchronisiert werden.

Diagnose: Fehlerquellen identifizieren

Durchlaufen Sie diese Checkliste, um die Ursache einzugrenzen.

Dateiquellen (CSV, TSV, XML oder andere Dateiformate)

• Delimiter-Problem: Überprüfen Sie, ob das verwendete Trennzeichen (Komma, Tabulator, Semikolon) korrekt konfiguriert ist. Ein falsches Delimiter führt dazu, dass Spalten nicht erkannt werden.
• Spaltenanzahl inkonsistent: Prüfen Sie, ob jede Zeile die gleiche Anzahl von Spalten enthält. Fehlende oder zusätzliche Spalten in einzelnen Zeilen führen zu Parsing-Fehlern.
• Zeichenkodierung beschädigt: Überprüfen Sie die Dateienkodierung. Wenn die Quelle in UTF-8 exportiert wird, aber als ISO-8859-1 interpretiert wird, entstehen Zeichenfehler und Parsing-Fehler.
• Fehlerhafte Dateistruktur: Prüfen Sie, ob die Header-Zeile vorhanden ist und die erwarteten Feldnamen enthält. Beschädigte Header führen zu Feldmapping-Fehlern.

Plattformquellen (verbundene Konten)

• OAuth-Anmeldedaten abgelaufen: Plattformen wie Shopify oder WooCommerce erfordern regelmäßige Reauthorisierung. Überprüfen Sie, ob eine Reauthorisierungsmitteilung vorliegt.
• Datenquellen-Authentifizierung fehlgeschlagen: Die Verbindung kann widerrufen oder auf der Plattformseite blockiert worden sein. Überprüfen Sie den Status der verbundenen Konten.

Feldmapping und Konfiguration

• Feldmapping-Fehler: Wenn der Merchant das Exportformat des Shops geändert hat oder neue Felder hinzugefügt wurden, können alte Feldmappings auf nicht vorhandene Spalten verweisen.
• Feed-Quelle Integritätsprüfung fehlgeschlagen: Überprüfen Sie den Gesundheitsstatus der Quelle in der Qualitäts-Übersicht. Ein Status mit beeinträchtigter Gesundheit deutet auf wiederholte Fehler hin.

Behebung: Schritt-für-Schritt-Anleitung

Schritt 1: Überprüfen Sie den Quellenstatus und das Import-Protokoll

1. Navigieren Sie zu Ihren Datenquellen oder Feed-Einstellungen.
2. Wählen Sie die betroffene Quelle aus.
3. Öffnen Sie das Protokoll des letzten Importlaufs.
4. Notieren Sie sich die spezifische Fehlermeldung. Sie zeigt oft direkt auf die Ursache hin (z. B. 'Ungültiges Delimiter in Zeile 5' oder 'Authentifizierung abgelaufen').
5. Überprüfen Sie den Gesundheitsstatus der Quelle. Ein Status wie 'Beeinträchtigt' oder 'Fehler' zeigt an, dass mehrere Läufe nacheinander fehlgeschlagen sind.

Schritt 2: Beheben Sie Dateiquellen-Fehler

Wenn die Fehlermeldung auf ein Dateiformat-Problem hinweist:

1. Exportieren Sie die Datei erneut aus Ihrem Ursprungssystem (z. B. Lagerverwaltung, E-Commerce-Plattform).
2. Öffnen Sie die exportierte Datei in einem Texteditor (nicht in Excel, da Excel Formatierungen ändern kann).
3. Überprüfen Sie die erste Zeile auf die erwarteten Feldnamen (title, description, price, availability, image_link usw.).
4. Überprüfen Sie, ob das Delimiter konsistent ist (alle Zeilen sollten die gleiche Anzahl von Spalten trennen).
5. Speichern Sie die Datei mit der korrekten Zeichenkodierung (UTF-8 wird empfohlen).
6. Laden Sie die bereinigte Datei in Ihre Datenquelle hoch oder aktualisieren Sie den Dateipfad.

Schritt 3: Beheben Sie Authentifizierungsfehler bei Plattformquellen

Wenn die Fehlermeldung auf Authentifizierung hinweist:

1. Navigieren Sie zu Verbundene Konten oder Integrationen.
2. Suchen Sie das betroffene Konto (z. B. Shopify, WooCommerce).
3. Überprüfen Sie, ob ein Status wie 'Reauthorisierung erforderlich' angezeigt wird.
4. Klicken Sie auf 'Erneut verbinden' oder 'Reauthorisieren'.
5. Folgen Sie dem OAuth-Authentifizierungsfluss und bestätigen Sie die Berechtigung auf der Plattformseite.
6. Bestätigen Sie, dass der Status nach Abschluss 'Verbunden' lautet.

Schritt 4: Korrigieren Sie Feldmapping-Fehler

Wenn die Fehlermeldung auf fehlende oder falsch zugeordnete Felder hinweist:

1. Öffnen Sie die Feldmapping-Konfiguration für die Quelle.
2. Vergleichen Sie die konfigurierten Feldnamen mit den tatsächlichen Feldnamen in der aktuellen Quelle.
3. Wenn Felder umbenannt wurden oder nicht mehr vorhanden sind, aktualisieren Sie das Mapping.
4. Stellen Sie sicher, dass erforderliche Felder wie title, price und link korrekt zugeordnet sind.
5. Speichern Sie die Änderungen.

Schritt 5: Führen Sie einen manuellen Importlauf durch

1. Navigieren Sie zur betroffenen Datenquelle.
2. Suchen Sie die Option 'Jetzt importieren' oder 'Importlauf starten'.
3. Klicken Sie, um einen manuellen Importlauf auszulösen.
4. Überwachen Sie den Lauf in Echtzeit oder überprüfen Sie das Protokoll nach Abschluss.
5. Bestätigen Sie, dass der Lauf erfolgreich abgeschlossen wurde und keine unerwarteten Fehler angezeigt werden.

Prävention: Wiederholte Fehler vermeiden

Plattformverbindungen gesund halten

• Reauthorisierungsmitteilungen beachten: Überprüfen Sie regelmäßig Ihre Benachrichtigungen auf Meldungen wie 'Reauthorisierung erforderlich'. Reagieren Sie unverzüglich, um zu verhindern, dass Importe fehlschlagen.
• Verbindungsstatus überwachen: Überprüfen Sie monatlich den Status Ihrer verbundenen Konten in den Integrations- oder Konten-Einstellungen.

Qualität der Datenquellen überwachen

• Qualitäts-Dashboard regelmäßig prüfen: Überprüfen Sie die Qualitäts-Übersicht oder das Gesundheits-Dashboard mindestens wöchentlich. Achten Sie auf Quellen mit Status 'Beeinträchtigt' oder steigenden Fehlerraten.
• Trend-Analyse: Wenn eine Quelle mehrere aufeinanderfolgende Fehler zeigt, bevor sie vollständig fehlschlägt, ist dies ein frühes Warnsignal. Beheben Sie das Problem sofort, anstatt zu warten, bis der Import komplett ausfällt.
• Dateiquellen-Validierung: Wenn Sie Dateien manuell exportieren, überprüfen Sie die Struktur vor dem Upload. Validieren Sie das Delimiter, die Spaltenzahl und die Zeichenkodierung.

Zusammenfassung

Ein fehlgeschlagener Feed-Import wird durch eine der wenigen häufigen Ursachen verursacht: Dateiformatfehler, abgelaufene Authentifizierung, Feldmapping-Fehler oder eine Quelle mit beeinträchtigter Gesundheit. Durch systematische Diagnose anhand der Checkliste, Behebung nach den Schritten oben und proaktive Überwachung können Sie Importfehler schnell beheben und wiederholte Ausfälle verhindern. Behalten Sie die Gesundheit Ihrer Datenquellen im Auge, und reagieren Sie auf Reauthorisierungsmitteilungen, um Ihre Produktdaten synchron zu halten.