For the complete documentation index, see llms.txt. This page is also available as Markdown.

So optimieren Sie Ihren Datafeed

Zusammenfassung

Um FactFinder mit Ihren Produktinformationen einzurichten, müssen Produktdaten in einer einheitlichen Struktur bereitgestellt werden. Ein CSV-Textdatei ist das Standardformat. Andere Formate wie XML und JSON werden ebenfalls unterstützt. Kontaktieren Sie uns für Details.

Grundlegende Konzepte


Dateiformat und Kodierung

  • Produktdaten exportieren in CSV-Textformat mit durch ein bestimmtes Zeichen getrennten Feldern (zum Beispiel Semikolon ;).

  • UTF-8-Kodierung wird empfohlen. Wenn Sie eine andere Kodierung verwenden, informieren Sie uns bitte im Voraus.


Dateikomprimierung

  • Um die Übertragungsbandbreite zu reduzieren, können Dateien komprimiert werden in ZIP Format.

  • Weitere unterstützte Komprimierungsformate: GZip, BZip, GZip+TAR.

  • RAR und andere Archivformate sind nicht unterstützt für automatische Datenaktualisierungen.


Dateibenennung und Multi-Shop-Unterstützung

  • Wenn FactFinder gleichzeitig in mehreren Shops oder in verschiedenen Sprachen verwendet wird, erstellen Sie für jeden Kanal (Shop und/oder Sprache) eine separate Datei.

  • Fügen Sie den Kanalnamen im Dateinamen ein (zum Beispiel FFF_export_en.csv).

  • Mehrere Dateien können in demselben dasselbe Archiv oder separate Archive.


Richtlinien zur Datenstruktur

  • Jedes Produkt (Datensatz) muss in einer separaten Zeile.

  • Keine Zeilenumbrüche innerhalb eines Feldes (zum Beispiel Produktbeschreibungen).

  • Jede Zeile muss die gleiche Anzahl von Feldern.

  • Feldtrennzeichen: Verwenden Tabulatoren oder Semikolons (;), nicht | (Pipe) oder # (Hash).

  • Feldbegrenzer: Wenn Trennzeichen in den Daten vorkommen, schließen Sie Werte in Anführungszeichen "".


Umgang mit Feldern

  • Für leere Felder (zum Beispiel, content1;content2;;content4; enthält fünf Felder, wobei die Felder drei und fünf leer sind.)

  • Die erste Zeile muss Feldnamen, identisch zu den Datenzeilen strukturiert, enthalten.

  • Maximale Anzahl von Feldern pro Zeile: 128 (erwägen Sie die Verwendung von Multi-Attribut-Feldern wenn dieses Limit überschritten wird).


Zeichen- und Größenbeschränkungen

  • Einzelner Feldinhalt ist nicht begrenzt in der Länge.

  • Maximale Größe des vollständigen Datensatzes: 100.000 Zeichen (in Sonderfällen über ein benutzerdefiniertes FactFinder-Paket entfernbar).


Beispiele für die Datenstruktur

Ohne Feldbegrenzer

Mit Feldbegrenzern

Feldanforderungen


Pflichtfeld

ProductID oder Artikelnummer

Beschreibung/Regeln: Muss das erste Feld in der Exportdatei sein.

Entwicklerinfo: Das Feld sollte wie folgt benannt werden: Artikelnummer, ArtikelNr, Artikelnummer, ProduktNummer, ProductNumber.


Empfohlene Felder

Hauptartikelnummer

Beschreibung/Regeln: Wird für Variantenprodukte (zum Beispiel Farbe oder Größe) benötigt, um doppelte Anzeigen bei der Suche zu vermeiden

Entwicklerinfo:

  • Wenn keine Varianten vorhanden sind, füllen Sie dieses Feld mit der ProductID.

  • Benennen Sie das Feld genauso wie „Article Number“, jedoch mit dem Präfix Master (zum Beispiel, Hauptartikelnummer).

Produktname

Beschreibung/Regeln: Kurzer, prägnanter Produkttitel

Entwicklerinfo: Das Feld sollte wie folgt benannt werden: Name, Titel, Titel

Entwicklerinfo: Das Feld sollte wie folgt benannt werden: Name, Titel, Titel

Beispiel: Markenname; Pullover aus Bio-Baumwolle

Preis

Beschreibung/Regeln:

  • Numerischer Wert;

  • Verwenden Sie einen Punkt . als Dezimaltrennzeichen;

  • Verwenden Sie keine Währungssymbole

Entwicklerinfo:

  • Das Feld sollte wie folgt benannt werden: Preis, Preis.

  • Verwenden Sie einzelne Felder für separate Preise (Price_EUR; Price_US oder Price_Dealer; Price_Final_Customer)

Beispiel: |EUR=32.34|USD=40.32|GBP=23.54|


Optionale Felder

Kurzbeschreibung

Beschreibung/Regeln: Prägnanter, schlagwortreicher Text zur Verbesserung der Suchergebnisse.

Entwicklerinfo: Das Feld sollte wie folgt benannt werden: ShortDescription, KurzBeschreibung.

Langbeschreibung

Beschreibung/Regeln: Ausführlicher Marketingtext (für die direkte Suchindizierung nicht empfohlen).

Entwicklerinfo: Das Feld sollte wie folgt benannt werden: Beschreibung, Beschreibung.

Hersteller

Beschreibung/Regeln: Nützlich für das Filtern und die Sortierung nach Marke.

Entwicklerinfo: Das Feld sollte wie folgt benannt werden: Hersteller, Marke, Hersteller, Marke

Filterattribute

Beschreibung/Regeln:

  • Definiert Merkmale wie Farbe, Größe oder Genre.

  • Verwenden Sie Multi-Attribut-Felder im folgenden Format: |Attribute1=Value|Attribute2=Value|

  • | muss zwischen den Attributen sowie am Anfang und Ende des Feldinhalts stehen

  • Attribute haben mehrere Werte (z. B. Farben oder Größen) und müssen im Feld mehrfach gespeichert werden (sie können miteinander verknüpft werden, indem das # Zeichen verwendet wird oder vollständig direkt nacheinander geschrieben werden)

  • Um eine Einheit anzugeben, trennen Sie den Attributnamen und die Einheit mit doppelter Tilde ~~. Pro Attributnamen kann es nur eine Einheit geben.

Entwicklerinfo:

  • Das Feld sollte wie folgt benannt werden: Attribut, MultiAttribute

  • Ein Multi-Attribut-Feld wird als „Textfeld“ behandelt. Für die spätere Verwendung in Ihrer Filteranzeige im Shop können Sie jedem einzelnen Attribut einen individuellen Datentyp wie Text, Ganzzahl oder Dezimalzahl zuweisen. Abhängig vom Datentyp können unterschiedliche Anzeigeformate für den Filter ausgewählt werden.

Beispiele: |Capacity=50|Speed=7200|, |Color=Red#Yellow#Blue| oder |Color=Red|Color=Yellow|Color=Blue|

Suchattribute

Beschreibung/Regeln: Zusätzliche Schlüsselwörter oder Fachbegriffe zur Verfeinerung der Suchergebnisse*.*

Entwicklerinfo: Die Suchattribute sollten durch ein einziges, konsistentes Zeichen getrennt werden

Kategorie

Beschreibung/Regeln:

  • Verwendet zum Filtern und zur Navigation

  • Verwenden Sie einen Schrägstrich / für Kategorieebenen.

  • Verwenden Sie ein Pipe-Zeichen | um mehrere Pfade zu trennen.

Entwicklerinfo: Das Feld sollte wie folgt benannt werden: Kategorie, Kategorie.

Beispiel: Bicycle/Lighting|Accessories/Bicycle Lamps Ein Produkt wird den Pfaden zugeordnet "bicycle/lighting" und "accessories/bicycle lamps"

Verkaufsrang

Beschreibung/Regeln: Eine numerische Rangfolge, die verwendet wird, um Produkte in den Suchergebnissen zu priorisieren.

Verfügbarkeit

Beschreibung/Regeln: Gibt an, ob das Produkt auf Lager ist, und beeinflusst so seine Platzierung in den Suchergebnissen

Marge

Beschreibung/Regeln: Repräsentiert die Produktmarge

Entwicklerinfo: Kann als reale numerische Werte übergeben oder in gebündelter Form angegeben werden

Beispiele: 42% oder 0-5%=a

ISBN, EAN, GTIN

Beschreibung/Regeln: Standardisierte Produktkennungen

Entwicklerinfo:

  • Das Feld sollte wie folgt benannt werden: GTIN, EAN, ISBN

  • Unterstützte Formate: ISSN-8, ISBN-10, ISMN-10, ISSN-13, ISMN-13 und ISBN-13

Beschreibung/Regeln: Eine URL, die den Benutzer zur Produktdetailseite führt

Entwicklerinfo: Das Feld sollte wie folgt benannt werden: Deeplink, ProductURL, ProduktURL

Beispiele: www.exampleshop.de/picture/article/123

ImageURL

Beschreibung/Regeln:

  • Der Link zum Produktbild

  • Vorschaubild für das Suchergebnis, nicht das hochauflösende Bild, das auf der Produktdetailseite angezeigt wird

  • Falls derzeit kein Bild verfügbar ist, sollte hier eine Dummy-URL mit demselben Namen oder der Link zu einem Bild verwendet werden, das „noch kein Bild für diesen Artikel“ anzeigt

Entwicklerinfo:

Lassen Sie dieses Feld nicht leer

Das Feld sollte wie folgt benannt werden: ImageURL, ImgURL, BildURL , BildLink, PictureURL, PicURL

Beispiele: www.exampleshop.de/picture/brand/bild.jpg

Zubehör

Beschreibung/Regeln: Ein Kennzeichen für Zubehörprodukte (typischerweise ein Wahr/Falsch- oder 0/1-Wert)

Entwicklerinfo: Das Feld sollte wie folgt benannt werden: Zubehör, Zubehör

Aktion/Verkauf

Beschreibung/Regeln: Gibt an, ob das Produkt Teil einer Aktion oder eines Verkaufs ist

Entwicklerinfo: Das Feld sollte wie folgt benannt werden: Sale, Aktion

Marken-URL

Beschreibung/Regeln: Leitet Benutzer zu einer Marken-Shop-Seite weiter

Entwicklerinfo: Das Feld sollte benannt werden als BrandURL

Markenbild

Beschreibung/Regeln: Wird in Markenfiltern und Suchvorschlägen angezeigt

Entwicklerinfo: Das Feld sollte wie folgt benannt werden: BrandImage

Beispiele: www.exampleshop.de/picture/brand/bild.jpg

Bestand

Beschreibung/Regeln: Wird verwendet, um Produkte niedriger zu ranken, wenn der Bestand begrenzt ist

Entwicklerinfo: Das Feld sollte wie folgt benannt werden: Menge, StockQuantity, Bestand, StockStatus

Bewertung

Beschreibung/Regeln:

  • Benutzerbewertungen anzeigen (z. B. 1–5 Sterne)

  • Verwenden Sie dieses Datenfeld nur in Verbindung mit RatingCount

Entwicklerinfo: Das Feld sollte wie folgt benannt werden: RatingScore, Bewertung

Bewertungsanzahl

Beschreibung/Regeln: Ganzzahliger Wert, der die Anzahl der Bewertungen angibt (siehe Rating).

Entwicklerinfo: Das Feld sollte benannt werden als RatingCount

Saison/Veranstaltung

Beschreibung/Regeln: Werten Sie Artikel ab, die derzeit nicht in der Saison sind oder nicht zu einer bestimmten Veranstaltung gehören, damit sie in der Suche weit unten angezeigt werden

Entwicklerinfo: Das Feld sollte wie folgt benannt werden: Saison, Event

Retourenquote

Beschreibung/Regeln: Wird verwendet, um Artikel mit einer hohen Retourenquote abzuwerten

Entwicklerinfo: Das Feld sollte wie folgt benannt werden: ReturnData, RetourCount, Retour

Zuletzt aktualisiert

War das hilfreich?