> For the complete documentation index, see [llms.txt](https://docs.fact-finder.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fact-finder.com/docs/de/import/ff-search-integration-how-to-optimize-your-datafeed.md). # 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** ``` ProductID;ProductName;Description;Price 000002101;LG T-6000;HD-Ready LCD-TV with cable tuner;699.00 000002102;Samsung P-4000;HD-Ready LCD-TV with cable tuner;499.00 ``` **Mit Feldbegrenzern** ``` "ProductID";"ProductName";"Description";"Price" "000002101";"LG T-6000";"HD-Ready LCD-TV with cable tuner";"699.00" "000002102";"Samsung P-4000";"HD-Ready LCD-TV with cable tuner";"499.00" ``` ## 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` #### Deeplink *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` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.fact-finder.com/docs/de/import/ff-search-integration-how-to-optimize-your-datafeed.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.