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 mussFeldnamen

  • 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

Mit Feldbegrenzungen

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

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

Zuletzt aktualisiert

War das hilfreich?