Fehlerbehebung bei deinem Produkt-Feed
Verfügbar in Enterprise und Gold
Publitas unterstützt den Import von XML- und TSV-Produkt-Feeds, die über eine Webadresse oder einen (S)FTP-Speicherort verfügbar sind. Klicke hier, um weitere Informationen zum Einrichten eines Produkt-Feeds für Publitas zu erhalten.
Warum wird der Produkt-Feed nicht erfolgreich importiert? Es kann vorkommen, dass ein Feed nicht korrekt importiert wird. Wenn ein Feed nicht korrekt importiert wird, liegt das in der Regel entweder an der Formatierung der Daten oder am Hosting des Feeds. Mit diesem Artikel möchten wir dir dabei helfen, diese Fälle zu beheben und deine Produktdaten erfolgreich zu importieren.
Wenn du Hilfe bei der Fehlerbehebung deines Produkt-Feeds benötigst, melde dich gern bei unserem Support-Team unter support@publitas.com und teile die Feed-URL mit uns.
In diesem Artikel:
- Fehlerbehebung bei Fehlermeldungen
- Fehlerbehebung beim Hosting des Feeds
- Fehlerbehebung bei der Formatierung des Feeds
- XML-Feeds
- TSV-Feeds
- Allgemeine Anforderungen
Fehlerbehebung bei Fehlermeldungen
Im Menü „Produkt-Feed“ werden aktuelle Importe protokolliert. Im Folgenden findest du eine Erklärung der verschiedenen Protokolleinträge:
- X Produkte importiert. Dies weist auf einen erfolgreichen Import hin. Wenn die Anzahl der importierten Produkte nicht mit der tatsächlichen Gesamtzahl übereinstimmt, wird der Import unterbrochen. Häufige Gründe dafür sind:
- Einige Produkte in einem TSV-Feed haben ein zusätzliches Tabulatorzeichen, normalerweise im Beschreibungsfeld.
- Der Feed wird dynamisch generiert, sobald die Feed-URL geöffnet wird, und der Feed benötigt mehr als eine Minute, um die vollständige Produktliste zu laden.
- Der Feed enthält mehr als 300.000 Produkte. Publitas importiert bis zu 300.000 Produkte.
- WARNUNG: Nur X von Y Produkten importiert. Wenn nicht alle Produkte importiert werden, stelle sicher, dass
- alle Produkte mindestens eine ID und einen Titel enthalten;
- alle Produkte eine eindeutige ID haben;
- alle Zeichen korrekt kodiert sind (bei XML-Feeds kannst du Titel und Beschreibung auch in CDATA einschließen – mehr Infos).
- Feed nicht gefunden oder ungültig. Dies bedeutet, dass das System nicht auf die Daten zugreifen oder sie nicht korrekt verarbeiten konnte. Im nächsten Kapitel findest du Hilfe bei der Fehlerbehebung dieses Problems.
Fehlerbehebung beim Hosting des Feeds
Um einen Produkt-Feed zu importieren, benötigt unser System Zugriff auf den Server, auf dem der Feed gehostet wird. Es kann vorkommen, dass auf dem Server Sicherheitsmaßnahmen eingerichtet sind, die den Zugriff einschränken und unsere Plattform daran hindern, den gehosteten Produkt-Feed herunterzuladen. Der Import eines Feeds kann auch fehlschlagen, wenn die Feed-URL den Datenverkehr auf die Download-URL umleitet.
- Stelle sicher, dass Datenverkehr aus der EU nicht blockiert wird.
- Vermeide Umleitungen, indem du sicher stellst, dass die Feed-URL direkt auf die Feed-Datei verweist.
- Wenn du eine Web Application Firewall (WAF) verwendest, die den Datenverkehr unseres Systems herausfiltert, setze bitte die folgende User-Agent-Zeichenfolge auf die Whitelist: requests Publitas-FeedImport 078DGH579984
Fehlerbehebung bei der Formatierung des Feeds
XML-Feeds
Wenn ein XML-Feed nicht in Publitas importiert werden kann, liegt das in der Regel an einem der folgenden Gründe:
- Der Feed ist nicht in UTF-8 kodiert
- Die Feed-Syntax ist fehlerhaft
UTF-8-Kodierung
Der Inhalt des Feeds muss UTF-8-kodiert sein. Wenn der Feed Zeichen enthält, die nicht in UTF-8 kodiert sind, kann der Import fehlschlagen. Stelle sicher, dass die erste Zeile in einem XML-Feed wie folgt lautet:
<?xml version="1.0" encoding="UTF-8"?>
Erforderliche Syntax
Die erforderliche Syntax findest du unter Einrichten deines Produkt-Feeds. Häufig treten Syntaxfehler auf, wenn die folgenden Elemente nicht korrekt eingerichtet sind:
- Die zweite Zeile des Feeds lautet:
<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0"> - Das Attribut <rss> enthält oft ein Attribut <channel>, unter dem die Produktliste mit einem <item>-Attribut pro Produkt gespeichert wird.
- Einige produktspezifische Attribute benötigen das Google-Shopping-Präfix (g:), damit sie funktionieren: Unterstützte Feed-Attribute
- Verwende in den Attributnamen nur Kleinbuchstaben
- Produkt-IDs und Titel dürfen nicht leer sein
<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0">
TSV-Feeds
Wenn ein TSV-Feed nicht in Publitas importiert werden kann, liegt das in der Regel an einem der folgenden Gründe:
- Falsche Header
- Beschreibungen enthalten zusätzliche Tabulatorzeichen
- Fehlender Titel und/oder fehlende IDs
- Preise verwenden ein Tausendertrennzeichen
Falsche Header
Stelle sicher, dass in der TSV-Datei die korrekten Header verwendet werden. Die erforderlichen Header findest du hier.
Stelle außerdem sicher, dass zusätzliche Leerzeichen vor oder nach den Headern entfernt werden.
Beschreibungen enthalten zusätzliche Tabulatorzeichen
Das TSV-Format verwendet tabulatorgetrennte Werte. Stelle es dir wie ein Excel-Blatt vor, bei dem jede Zeile im Feed eine Zeile ist und jedes Tabulatorzeichen die Spalten trennt. Manchmal werden in Produktbeschreibungen Tabulatorzeichen verwendet, um den Inhalt einzurücken. Wenn dieses Tabulatorzeichen ebenfalls im Feed gespeichert ist, stört es die erforderliche Tabulatorreihenfolge für einen vollständigen Import. Deshalb solltest du vermeiden, zusätzliche Tabulatorzeichen in Beschreibungen oder anderen Attributen zu verwenden.
TIPP: Wenn du die TSV-Datei in Excel oder Google Sheets importierst, kannst du sehen, ob zusätzliche Tabulatorzeichen den Feed tatsächlich beeinträchtigen. Wenn du in der importierten Liste nach unten scrollst, wirst du Zeilen bemerken, bei denen ein Teil des Inhalts nach rechts verschoben ist. In diesen Zeilen ist ein zusätzliches Tabulatorzeichen vorhanden.
Allgemeine Anforderungen
Fehlender Titel und/oder fehlende IDs
Normalerweise führt das nicht dazu, dass der Import fehlschlägt; stattdessen werden diese speziellen Produkte nicht importiert.
Preise verwenden ein Tausendertrennzeichen
Wenn im Feed für Preise das Tausendertrennzeichen verwendet wird (z. B. wird 1,000.00 in Publitas zu 1.00), kann es helfen, das Tausendertrennzeichen zu entfernen und es erneut zu versuchen (z. B. 1000.00)
Verwendet einen Punkt als Dezimaltrennzeichen
Wenn im Feed ein Komma zur Trennung der Dezimalstellen verwendet wird, werden Preise möglicherweise nicht korrekt importiert. Stelle stattdessen sicher, dass du einen Punkt als Dezimaltrennzeichen verwendest.
____________________________________________________________
Wenn du Hilfe bei der Fehlerbehebung deines Produkt-Feeds benötigst, kannst du dich gern an unser Support-Team unter support@publitas.com wenden
und die Feed-URL mit uns teilen.