Productfeed

Um dein Produkfeed bei melibo hochzuladen, benötigst du zunächst den Link (CSV) zu deinem Produktfeed. Unten siehst du die Anforderungen.

Anschließend navigierst du in melibo zum Knowledge Hub und wählst dort den Bereich Sources aus. Oben rechts findest du die Schaltfläche „Erstellen“. Klicke darauf, um eine neue Quelle hinzuzufügen.

Wähle nun als Quellentyp „Productfeed“ aus und füge den Link der CSV ein. Danach drücke einmal den Button die Feed zu prüfen. Wenn die negativ ist heißt es, dass es die Anforderungen nicht passen.

Falls postiv kannst du nun Mapping anpassen, falls das noch nicht automatisch passiert ist:

Mit dem speichern wird der Feed nach wenigen Minuten in melibo hochgeladen. Diese erscheinen dann unter "Sources".

Allgemeine Anforderungen an den Produktfeed (CSV)

1. Header & Struktur

• Der Header muss eindeutig, konsistent und einmalig sein

• Jede Spalte darf nur einmal existieren

• Die Gesamtanzahl der Spalten ist auf das fachlich notwendige Minimum zu begrenzen

• Keine redundanten oder historisch gewachsenen Felder

2. Eindeutige Felder (keine Dubletten)

• Jedes inhaltliche Attribut darf nur einmal vorkommen

• Typische Beispiele für verbotene Redundanzen:

  • Preis: nur ein Feld (z. B. price)

  • Produkttitel: nur ein Feld (z. B. title)

  • Kategorie: nur ein Feld (z. B. category_path)

  • Produkt-ID (EAN/GTIN): klar definiert, keine Alternativfelder

  • Farbe: nur eine Schreibweise

➡ Regel: Wenn zwei Felder dasselbe bedeuten könnten, ist der Feed fehlerhaft.

3. Naming-Konventionen

• Eine Sprache für alle Spaltennamen (entweder komplett Englisch oder komplett Deutsch)

• Ein Naming-Stil, z. B.:

  • snake_case (empfohlen)

  • alternativ: camelCase

• Keine Mischung aus:

  • Groß-/Kleinschreibung

  • Leerzeichen in Feldnamen

  • Deutsch und Englisch

• Spaltennamen müssen:

  • eindeutig

  • selbsterklärend

  • stabil über Zeit sein

4. Semantik & Klarheit

• Jedes Feld hat eine klar definierte Bedeutung

• Die Bedeutung darf sich nicht je nach Produkt oder Quelle ändern

• Gleiche Inhalte müssen immer im selben Feld stehen

• Implizite Logik („manchmal hier, manchmal dort“) ist nicht erlaubt

5. Textfelder & Formatierung

• Textfelder dürfen Zeilenumbrüche enthalten

• Wenn Zeilenumbrüche enthalten sind:

  • der gesamte Wert muss korrekt in " eingeschlossen sein

  • Quotes innerhalb des Textes müssen korrekt escaped sein

• Keine:

  • kaputten Quotes

  • unescaped Sonderzeichen

  • inkonsistenten Trennzeichen