Produktdatenupload

Katalogverwaltung

Bei dem Upload der Daten unterscheiden wir zwischen Produkt- und Angebotsdaten.
Nachfolgend gehen wir näher auf die Produktdaten ein.  Diese müssen unbedingt vor der Datei mit Angeboten in das Backend fehlerfrei hochgeladen sein. Produktdaten beinhalten eher starre Informationen, welche sich in der Regel kaum ändern, wie z. B. die Produktgruppe, Herstellerteilenummer, Marke, Farbe, Gewicht,  und ähnliches.

Zulässige Datei-Formate: 

  • .csv (Standard Dateiformat in UTF-8 und für alle Importe geeignet)
  • .xlsx
  • .xml / BMEcat (BMECat erfordert eine manuelle Konvertierung der Datei)

Dateierstellung

Der Import und die Anlage von Produkten ist zum einen über eine Excel Vorlage aus mirakl, zum anderen auch über einen eigenen Datenexport aus Ihrem PIM System möglich.

Die Empfehlung ist einen eigenen Datenexport zu verwenden und diesen einmalig der Conrad Struktur zuzuordnen. Dafür wird der vom Backend zur Verfügung gestellte Konfigurationsassistent verwendet. 

Folgend finden Sie eine Aufstellung relevanter Attribute für die Produktdaten.
Sie finden hier zum einen Infos über verpflichtende Attribute sowie empfohlene Attribute, welche Ihnen hinsichtlich der Sichtbarkeit Ihrer Produkte auf der Plattform helfen.

<= Verpflichtende Produktattribute
Verpflichtende Produktattribute

Produktgruppe / Kategorie (Code: category)
Die Zuordnung Ihres Produkts in die unterste Ebene ist zwingend erforderlich und eine der wichtigsten Grundlagen für den Verkaufserfolg. Achten Sie daher unbedingt auf eine sachliche korrekte Zuweisung.

  • Die Kategorie hat maßgeblichen Einfluss darauf, wie gut Ihr Produkt später von der Shopsuche gefunden wird oder wie viele relevante Impressions sie über externe Einsprünge bekommen.
  • Die Kategorie steuert außerdem die im weiteren Verlauf möglichen und auch die erforderlichen Produktmerkmale. Dadurch kann es sein, dass sie Pflichtattribute zu Ihrem Produkt angeben müssten, obwohl diese gar nicht zutreffen.
Produkt-ID / Ihre Artikelnummer (Code: Product.SellerProductID)
Ihre eindeutige Produkt-Nummer, über die Sie das Produkt und zugehörige Aufträge eindeutig identifizieren können. Typischerweise ist das die Artikelnummer in Ihrem Warenwirtschaftssystem. Diese ID stellt später auch die Referenz für den Upload Ihrer Offers und die Auftragsabwicklung dar.
Produktbezeichnung / Produkttitel /  (Code: SHOP.PRODUCT.TITLE)
Eindeutigkeit: Jedes Produkt ist unique und sollte einen eigenen Namen haben.
Die Bezeichnung eines Produkts muss mindestens 20 Zeichen sein und kann bis zu 120 Zeichen betragen. 
Je nach Platzierung, Kanal und Endgerät kann der Titel aber kürzer ausfallen und daher angeschnitten dargestellt werden.
An einigen Stellen (z.B. Reco-Engine) muss aus Platzgründen nach 70 Zeichen abgeschnitten werden. Achten Sie deshalb darauf, dass bereits in den ersten 70 Zeichen Eindeutigkeit gegeben ist. In Google PLAs werden ebenfalls maximal 70 Zeichen angezeigt.
Empfehlung: Beginnen Sie mit der Funktion/Benennung, Marke und Teilenummer/Typ. Danach können Sie weitere Merkmale nach Wichtigkeit hinzufügen. Führen Sie für einen optimalen Produkttitel eine Keywordrecherche durch und vermeiden Sie Verallgemeinerungen. Setzen Sie eine sprechende Benennung ein, das hat großen Einfluss auf Relevanz und hilft auch dem Kunden.
Wir empfehlen Ihnen, weitere Keywords erst am Ende anzufügen.
Marke (Code: ATT.GLOBAL.Brandname)
Bitte geben Sie die entsprechende Marke des Produktes an. 
Die detaillierten Anforderungen zur Anlage neuer Marken finden Sie hier.
Hersteller-Teilenummer (Code: ATT.GLOBAL.ManufacturerAID)
Eindeutige Hersteller-Teilenummer. Diese ist suchrelevant für das Internet und das Matching auf Preissuchmaschinen.
Bei Markenprodukten, d.h. Produkte die nicht als No Name klassifiziert sind, ist die Angabe einer Herstellerteilenummer erforderlich.
Verkaufsmengeneinheit (Code: Product.BaseUnit)
Geben Sie die Einheit des Produkts an, in der es verkauft wird. Mögliche Werte sind:
Stück: "Ein ganzes", ggfs. aber inkl. Zubehör. Beispiel: Eine Tube Klebstoff, ein Schreibblock, eine Digitalkamera mit Akku und Ladegerät. Ein Stück Klebstoff-Tube kann natürlich nicht in einzelnen Millilitern verkauft werden.
Paar: Zwei zusammengehörige Stück gleicher Art. Es ist nicht sinnvoll ein Paar Handschuhe als einzelne Stücke anzubieten.
Pack: Mehrere gleiche Stück, die als Ganzes verkauft werden. Beispiel: 10 Textmarker in einer Umverpackung.
Meter: Das Produkt kann pro Meter bestellt und geliefert werden (wird also abgelängt). Der Preis wird pro Meter angegeben. Beispiel: Kabel. NICHT: Klebeband, das ist in der Regel ein Stück oder ein Pack.
Hinweis:
Diese ist unabhängig davon, in welcher Einheit Sie das Produkt bepreisen, lagern oder die Bestellung von uns erhalten möchten.
Inhalt pro Verkaufseinheit (Code: ATT.GLOBAL.NoCUperOU)
Inhalt des verkauften Produktes (numerischer Wert).
Ein Stück beinhaltet normalerweise 1 Stück. Ein Paar enthält 2 Stück, ein Pack enthält einen Inhalt größer 1.
Einheit der Inhaltsmenge (Code: ATT.GLOBAL.NoCUperOU__UNIT)
Einheit des Inhaltes des verkauften Produkts.
Bei einer Packung, welche 10 Einheiten eines Artikels enthält wäre bspw. die Einheit ‘’Stück’’ zu wählen. Weitere Inhaltsmengen sind: g, kg, ml, l, cm, m, m²
Umsatzsteuerklasse (Verkauf) (Code: Product.TaxIndicator)
Anzuwendender Steuersatz für den Verkauf des Produkts. Im Regelfall kommt die volle Steuer (z.B. in DE 19%) zur Anwendung. Ausnahmen mit reduzierter Steuer können z. B. Bücher oder Lebensmittel sein.
<= Liste der empfohlenen Produktattribute
Empfohlene Produktattribute
EAN / GTIN zur verkauften Einheit (Code: Product.EAN.Main_MP)
Bitte geben Sie hier die EAN / GTIN der angebotenen Gebindegröße an.
Wenn es für diese Einheit keinen EAN gibt, weil Sie diese Einheit z. B. selbst nicht führen, tragen Sie hier bitte nichts ein. In einem solchen Fall müssen aber die Felder Marke & Teilenummer gefüllt sein. 
Highlights  (Code: ATT.Text.ProductFeatures)
Stichpunktartige Aufzählung der kaufentscheidenden und produktunterscheidenden Merkmale -> Beginnen Sie mit dem Wichtigsten.
  • Gleiche Inhalte, Reihenfolge und Schreibweise innerhalb ähnlicher Kategorien.
  • Nach jedem Feature ist ein Mittelpunkt ‘’·’’  zu setzen.
  • Keine Aufzählungszeichen verwenden.
  • Wiederholung der wichtigsten technischen Merkmale hilft dem Kunden bei der Orientierung
Werbetext (Code: ATT.Text.ProductTextLong) 
  • Fließtext, Verwendung von gängigen HTML-Tags möglich (Zeilenumbruch, Absatz, Fett, Kursiv, etc)
  • Keine Aufzählung der Ausstattungsmerkmale.
  • Einfache, verständliche Texte, Kundennutzen und Produktvorteile herausarbeiten.
  • Strukturierte Texte (Absätze bilden).
  • Keywords mit einbauen
Schlagworte zum Artikel (Code: ATT.CPCS.ArticleKeywords) 
Schlagworte auf Einzelproduktebene für eine optimale Produktsuche. Einzelne Schlagworte oder Phrasen werden durch ein Komma getrennt.
Geben Sie keine allgemeinen Begriffe wie Warengruppen oder Anwendungsfälle an, sondern nur konkrete alternative Bezeichnungen (Synonyme).

Produktbild 1 URL (Code: Product.PrimaryImageURL_MP)

  • Produktbildlink (URL) für das Hauptprodukt-Bild 
    Beispiel: https://servername/bildname1.jpg
  • Zulässige Dateitypen: PNG, JPG, TIF, GIF, WebP
  • Mindestgröße der kurzen Seite: 500 Pixel (Empfohlen: 1000 Pixel)
  • Mindestgröße der Datei: 350 kB (Empfohlen: 1,6 MB ; Maximal bis 10 MB)

Sie können pro Artikel alle weiteren Attributfelder für Produktbilder, Illustrationen, Symbole oder auch PDFs für Datenblätter,  Bedienungsanleitungen und mehr nutzen.
Beachten Sie unbedingt immer die Anforderungen vom PDF-Dokument unter  
 => Produktabbildungsbedingungen !

Hinweise:
1. Cloudspeicher (z.Bsp. Google Drive,Dropbox, Apple iDrive, YouTube, Vimeo usw.) funktionieren nicht als Dateiquelle für den Marktplatz. Das betrifft alle Medien egal ob Bilder, Videos oder PDFs.
2. Manche Systeme schränken Zugriffe auf Deeplinks ein.  Damit die Zugriffe nicht als Crawler- oder Bot-Angriffe interpretiert und geblockt werden wäre es wichtig, den Zugriff  zu erlauben (whitelisten).

CO2-Fußabdruck  (Code: Product.CO2.Footprint)
Optional kann pro Artikel Information zum CO2-Fußabdruck angegen werden.
Wir können Ihre Angaben in die Produktdaten einbinden und veröffentlichen.
Quelle: https://klimapi.com/de/use-cases/ecommerce

Achtung: Die Angabe bezieht sich auf 1 Verkaufseinheit! siehe:

 

 

CO2-Fußabdruck EINHEIT  (Code: Product.CO2.Footprint__UNIT)

nötige Werteliste für den CO2-Fußabdruck (Product.CO2.Footprint)
Typ = Liste mit Wert: 
kg CO2e  (code: unece.unit.kgCO2e) 

 

 

Bitte beachten und übermitteln Sie auch Attribute, die je nach Produktgruppe rechtlich notwendig sein können.
Siehe dazu Beispiele: 
- erweiterte Herstellerverantwortung (EPR)
    - ElektroG / WEEE

 

 

Die komplette Übersicht aller einzelnen Attribute in mirakl:

 Marketplace-Konfiguration

Mehr dazu auch in den Dokumentationen unter: Produktdaten verwalten

 

Sollte aus individuellen Gründen kein Datenexport aus Ihren Systemen möglich sein könnte auch eine Excel Vorlage manuell befüllt und hochgeladen werden. Mehr dazu hier:

manueller Upload per mirakl Excel Vorlage

1. Konfigurieren & Herunterladen

Mirakl Menü  -> "Preis und Lager" -> “Dateiimporte” 
Auf der rechten Seite unter Dateivorlagen wählen Sie die Excel-Vorlage unter  "Produkte und Angebote" aus.
Damit haben Sie Produktinfos und das dazugehörige Angebot in einem Dokument.

“Wählen Sie die Anforderungsstufe der Attribute”:  Alle
Tipp:
Für Sie als Verkäufer ist es besser, viele Produktinformationen zu pflegen, damit Ihr Produkt besser gefunden wird und für den Kunden ansprechender ist.

“Wählen Sie die Kategorie” :
Mithilfe der Suchleiste können Sie schnell und einfach die richtige Kategorie finden, ohne die Struktur manuell durchklicken zu müssen. Setzen Sie einen Haken bei den Produktkategorien, in denen Sie Produkte anbieten möchten. (Maximal 100 Kategorien pro Dokument wählbar)
Dann den Button “Vorlage erstellen” unten verwenden und wenn fertig generiert über den Button “Download” lokal herunterladen. Gern können Sie die heruntergeladene Datei auch umbenennen, zB mit der enthaltenen Kategorie.

2.  Bearbeiten

Öffnen Sie die heruntergeladene Datei in Excel. Die Tabelle ist in zwei wesentliche Bereiche unterteilt. Spalten mit grünen Überschriften beziehen sich auf technische Daten zum Produkt, während Spalten mit blauen Überschriften sich auf die Angebotsinformationen zu diesem Produkt beziehen.

Rot hinterlegte Felder sind Pflichtfelder und müssen zwingend ausgefüllt werden, um die Produkte einspielen zu können. Gelbe Felder sind empfohlen zu verwenden, weiße Felder sind optional.
Wir empfehlen unbedingt, so viele Felder wie möglich zu füllen, um dem Kunden so genaue Informationen wie möglich zu geben. Auch wird die Suche nach einem Produkt über die Filterfunktion damit möglich.

Tipp:
In der 2. Registerkarte (ReferenceData) finden Sie mögliche Wertelisten; also alle verwendbaren Werte zum jeweiligen Attribut (Begriffe die mirakl so schon kennt) 

3. Upload

Sobald Sie mit dem Bearbeiten der Daten fertig sind, laden Sie die Datei wie hier im Dokument unten beschrieben in mirakl hoch.

Tipp:
Auch wenn die Datei Produkt- als auch Angebotsdaten beinhaltet, möchten wir Sie aus technischen Gründen bitten, diese zuerst als "Produkte"-Datei und danach die selbe Datei nochmal als "Angebots"-Datei hochzuladen.
Archivieren Sie Ihre Datei, denn diese wird für jedes Update wieder benötigt!

 

Übertragungsmöglichkeiten

Es gibt unterschiedliche Wege, die Produkte zu importieren.

FTP Server

Sie können für einen automatisierten Import Ihrer Produkte eine Serververbindung in Ihrem Mirakl Konto pflegen. Gehen Sie dazu auf:  "Einstellungen" => " Shop" und dort Registerkarte "Importe"

Folgend eine kleine Checkliste was wir von Ihnen benötigen:

  • Protokoll (nur noch HTTPS oder SFTP)
  • Host / Serveradresse
  • Port
  • Dateipfad (ohne Host)
  • Logindaten (User und Passwort)

Die Produkte können lediglich im Modus "Normal" hochgeladen werden. Bspw. Updates am Produkttitel werden beim Import einer aktualisierten Datei automatisch übernommen. 

 

Per API-Schnittstelle

Hier Mehr Details zur API-Schnittstelle

Es gibt jeweils einen Endpunkt zur Übermittlung der Produkte, der Angebote sowie für einen separaten Preisimport.

  • Produktupload -> Endpunkt P41
  • Angebotsupload -> Endpunkt OF01 (Modus ‘’Normal’’ und ‘’Löschen & Ersetzen’’)
  • Preisupload -> Endpunkt PRI01 (nur im Modus ‘’Löschen & Ersetzen’’)

Manueller Import

Uploads für Produkte können manuell über eine Importmaske im Mirakl Portal erfolgen.
Gehen Sie dazu auf: "Catalog"

Hier können Sie  Produktimporte überprüfen  und etwaige Fehlerberichte abrufen. Diese können Sie wiederum zur Korrektur vorhandener Fehler heranziehen.

Neue Produktimporte erfolgen hier über den Button "Import products" oben rechts auf der Seite.


Gängige Fehlermeldungen

Beim Import Ihrer Produkte kann es passieren, dass erste Versuche zur Anlage Ihrer Artikel fehlschlagen. Das kann unterschiedliche Gründe haben. Bitte prüfen Sie daher stets die Produktimporthistorie und entsprechende Einträge auf etwaige Fehlerberichte. 

Sie können diese Fehlerberichte in Ihrem Mirakl Menü direkt unter "Katalog" > "See details" herunterladen. 

Infos und Lösungen zu den unterschiedlichen Fehlermeldungen finden Sie in diesem Artikel:

Weitere Themen