# Wie Sie Ihren Datenfeed optimieren ## Zusammenfassung Um FactFinder mit Ihren Produktinformationen einzurichten, müssen Produktdaten in einer einheitlichen Struktur bereitgestellt werden. Eine **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 * Exportieren Sie Produktdaten im **CSV-Textformat** mit Feldern, die durch ein festgelegtes Zeichen getrennt sind (zum Beispiel Semikolon `;`). * **UTF-8-Kodierung** wird empfohlen. Wenn Sie eine andere Kodierung verwenden, informieren Sie uns im Voraus. *** ### Dateikomprimierung * Um die Übertragungsbandbreite zu reduzieren, können Dateien in **ZIP** Format. * Andere 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 Channel (Shop und/oder Sprache) eine separate Datei. * Fügen Sie den **Channel-Namen** in den Dateinamen ein (zum Beispiel, `FFF_export_en.csv`). * Mehrere Dateien können im **gleichen Archiv** oder **separaten Archiven**. *** ### Richtlinien zur Datenstruktur * Jedes Produkt (Datensatz) muss in einer **separaten Zeile**. * **keine Zeilenumbrüche** innerhalb eines Feldes enthalten (zum Beispiel Produktbeschreibungen). * Jede Zeile muss **die gleiche Anzahl an Feldern**. * **Feldtrenner:** Verwenden Sie **Tabs** oder **Semikolons** (`;`), **nicht** `|` (Pipe) oder `#` (Hash). * **Feldbegrenzungen:** Wenn Trennzeichen in den Daten vorkommen, setzen Sie Werte in **Anführungszeichen** `""`. *** ### Umgang mit Feldern * Für **leere Felder** muss ein Trenner enthalten sein `(zum Beispiel,` content1;content2;;content4; * hat fünf Felder, wobei die Felder drei und fünf leer sind.) **Die erste Zeile muss**Feldnamen * enthalten, strukturiert identisch zu den Datenzeilen. **128** Maximale Felder pro Zeile: **(erwägen Sie die Verwendung von** Multi-Attribut-Feldern *** ### wenn dieses Limit überschritten wird). * Zeichen- und Größenbeschränkungen **Einzelner** Feldinhalt ist in der Länge nicht begrenzt. * Maximale Größe des vollständigen Datensatzes: **100.000 Zeichen** (bei besonderen Fällen per kundenspezifischem FactFinder-Paket aufhebbar). *** ### Beispiele für Datenstrukturen **Ohne Feldbegrenzungen** ``` ProductID;ProductName;Description;Price 000002101;LG T-6000;HD-Ready LCD-TV mit Kabelfernsehempfänger;699.00 000002102;Samsung P-4000;HD-Ready LCD-TV mit Kabelfernsehempfänger;499.00 ``` **Mit Feldbegrenzungen** ``` "ProductID";"ProductName";"Description";"Price" "000002101";"LG T-6000";"HD-Ready LCD-TV mit Kabelfernsehempfänger";"699.00" "000002102";"Samsung P-4000";"HD-Ready LCD-TV mit Kabelfernsehempfänger";"499.00" ``` ## Felderanforderungen *** ### Pflichtfeld > **ProductID oder Artikelnummer** *Beschreibung/Regeln:* Muss das **erste Feld** in der Exportdatei sein. > *Entwicklerinfo:* Das Feld sollte eines der folgenden Namen haben: `Artikelnummer`, `ArtikelNr`, `ArticleNumber`, `ProduktNummer`, `ProductNumber`. *** ### Empfohlene Felder #### Hauptartikelnummer *Beschreibung/Regeln:* Benötigt für Variantenprodukte (z. B. Farbe oder Größe), um doppelte Anzeige bei der Suche zu verhindern > *Entwicklerinfo:* > > * Wenn keine Varianten existieren, füllen Sie dieses Feld mit der `ProductID`. > * Nennen Sie das Feld genauso wie „Artikelnummer“, jedoch mit dem Präfix `Master` muss ein Trenner enthalten sein `MasterArticleNumber`). #### Produktname *Beschreibung/Regeln:* Kurzer, prägnanter Produkttitel *Entwicklerinfo:* Das Feld sollte eines der folgenden Namen haben: `Name`, `Bezeichnung`, `Titel` > *Entwicklerinfo:* Das Feld sollte eines der folgenden Namen haben: `Name`, `Bezeichnung`, `Titel` *Beispiel:* `Markenname; Organic Cotton Sweater` #### Preis *Beschreibung/Regeln:* * Numerischer Wert; * Verwenden Sie einen Punkt `.` als Dezimaltrennzeichen; * Verwenden Sie keine Währungssymbole > *Entwicklerinfo:* > > * Das Feld sollte eines der folgenden Namen haben: `Preis`, `Preis`. > * Verwenden Sie einzelne Felder für getrennte 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:* Knapper, keywordreicher Text zur Verbesserung der Suchergebnisse. > *Entwicklerinfo:* Das Feld sollte eines der folgenden Namen haben: `ShortDescription`, `KurzBeschreibung`. #### Langbeschreibung *Beschreibung/Regeln:* Detaillierter Marketingtext (nicht empfohlen für direkte Suchindexierung). > *Entwicklerinfo:* Das Feld sollte eines der folgenden Namen haben: `Beschreibung`, `Beschreibung`. #### Hersteller *Beschreibung/Regeln:* Nützlich zum Filtern und für Rankings nach Marke. > *Entwicklerinfo:* Das Feld sollte eines der folgenden Namen haben: `Hersteller`, `Marke`, `Hersteller`, `Marke` #### Filterattribute *Beschreibung/Regeln:* * Definiert Eigenschaften wie Farbe, Größe oder Genre. * Verwenden Sie Multi-Attribut-Felder im folgenden Format: `|Attribute1=Value|Attribute2=Value|` * `|` muss sowohl zwischen Attributen als auch am Anfang und Ende des Feldinhalts erscheinen * Attribute haben mehrere Werte (z. B. Farben oder Größen) und müssen mehrfach im Feld gespeichert werden (sie können mit dem `#` Zeichen verknüpft oder vollständig nacheinander geschrieben werden) * Um eine Einheit anzugeben, trennen Sie den Attributnamen und die Einheit mit doppelter Tilde `~~`. Es kann nur eine Einheit pro Attributname geben. > *Entwicklerinfo:* > > * Das Feld sollte eines der folgenden Namen haben: `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. Je nach 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 einzelnes, einheitliches Zeichen getrennt werden #### Kategorie *Beschreibung/Regeln:* * Wird für Filterung und Navigation verwendet * Verwenden Sie einen Schrägstrich `/` für Kategorienstufen. * Verwenden Sie eine Pipe `|` um mehrere Pfade zu trennen. > *Entwicklerinfo:* Das Feld sollte eines der folgenden Namen haben: `Kategorie`, `Kategorie`. *Beispiel:* `Bicycle/Lighting|Accessories/Bicycle Lamps` Ein Produkt ist den Pfaden zugeordnet **"bicycle/lighting"** und **"accessories/bicycle lamps"** #### Verkaufsrang *Beschreibung/Regeln:* Ein numerisches Ranking zur Priorisierung von Produkten in Suchergebnissen. #### Verfügbarkeit *Beschreibung/Regeln:* Gibt an, ob das Produkt auf Lager ist, was sein Ranking in Suchergebnissen beeinflusst #### Marge *Beschreibung/Regeln:* Stellt die Produktmarge dar > *Entwicklerinfo:* Kann als reale numerische Werte übermittelt oder in gruppierter Form angegeben werden *Beispiele:* `42%` oder `0-5%=a` #### ISBN, EAN, GTIN *Beschreibung/Regeln:* Standardisierte Produktkennzeichnungen > *Entwicklerinfo:* > > * Das Feld sollte eines der folgenden Namen haben: `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 eines der folgenden Namen haben: `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 momentan kein Bild verfügbar ist, sollte hier eine Dummy-URL mit demselben Namen oder der Link zu einem Bild verwendet werden, das „für diesen Artikel noch kein Bild vorhanden“ zeigt > *Entwicklerinfo:* > > Lassen Sie dieses Feld nicht leer > > Das Feld sollte eines der folgenden Namen haben: `ImageURL`, `ImgURL`, `BildURL` , `BildLink`, `PictureURL`, `PicURL` *Beispiele:* `www.exampleshop.de/picture/brand/bild.jpg` #### Zubehör *Beschreibung/Regeln:* Ein Indikator für Zubehörprodukte (typischerweise ein True/False- oder 0/1-Wert) > *Entwicklerinfo:* Das Feld sollte eines der folgenden Namen haben: `Zubehör`, `Zubehor` #### Promotion/Angebot *Beschreibung/Regeln:* Gibt an, ob das Produkt Teil einer Promotion oder eines Angebots ist > *Entwicklerinfo:* Das Feld sollte eines der folgenden Namen haben: `Sale`, `Aktion` #### Marken-URL *Beschreibung/Regeln:* Leitet Benutzer zu einer Marken-Shop-Seite weiter > *Entwicklerinfo:* Das Feld sollte wie folgt benannt werden `BrandURL` #### Markenbild *Beschreibung/Regeln:* Wird in Markenfiltern und Suchvorschlägen angezeigt > *Entwicklerinfo:* Das Feld sollte eines der folgenden Namen haben: `BrandImage` *Beispiele:* `www.exampleshop.de/picture/brand/bild.jpg` #### Lagermenge *Beschreibung/Regeln:* Wird verwendet, um Produkte bei begrenztem Lagerbestand niedriger zu bewerten > *Entwicklerinfo:* Das Feld sollte eines der folgenden Namen haben: `Menge`, `StockQuantity`, `Lagermenge`, `StockStatus` #### Bewertung *Beschreibung/Regeln:* * Anzeige von Benutzerbewertungen (z. B. 1–5 Sterne) * Verwenden Sie dieses Datenfeld nur in Verbindung mit RatingCount > *Entwicklerinfo:* Das Feld sollte eines der folgenden Namen haben: `RatingScore`, `Bewertung` #### Anzahl der Bewertungen *Beschreibung/Regeln:* Ganzzahliger Wert, der die Anzahl der Bewertungen angibt (siehe Bewertung). > *Entwicklerinfo:* Das Feld sollte wie folgt benannt werden `RatingCount` #### Saison/ Ereignis *Beschreibung/Regeln:* Abwerten von Artikeln, die derzeit nicht in Saison sind oder nicht zu einem bestimmten Ereignis gehören, damit sie in der Suche weiter unten angezeigt werden > *Entwicklerinfo:* Das Feld sollte eines der folgenden Namen haben: `Saison`, `Ereignis` #### Rücklaufquote *Beschreibung/Regeln:* Wird verwendet, um Artikel mit hoher Rücklaufquote abzuwerten > *Entwicklerinfo:* Das Feld sollte eines der folgenden Namen haben: `ReturnData`, `RetourCount`, `Retour`