| Verpflichtende Produktattribute | ||
|---|---|---|
| Produktgruppe / Kategorie Bitte zu jedem Artikel die jeweilige Produktgruppe (unterste Ebene oder vollständigen Kategoriebaum) angeben. |
||
| Eindeutige Artikelnummer (Seller Produkt ID) 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. |
||
| Produkttitel Eindeutigkeit: Jedes Produkt ist unique und sollte einen eigenen Namen haben. Die Langbezeichnung eines Produkts kann bis zu 120 Zeichen in Detailseite und Suchergebnislisten 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 Bitte geben Sie die entsprechende Marke des Produktes an. |
||
| Teilenummer des Herstellers 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 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. Set: Verschiedene Produkte, die als Ganzes verkauft werden. Beispiel: Ein Schreibtisch-Set aus Unterlage, Stifteköcher und Ablagekorb in einem Umkarton oder ein Füller und ein Kugelschreiber im Etui. 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 für Lieferanten: Diese ist unabhängig davon, in welcher Einheit Sie das Produkt bepreisen, lagern oder die Bestellung von uns erhalten möchten. |
||
| Inhalt 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. |
||
| Inhaltsmengeneinheit 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) Anzuwendender Steuersatz für den Verkauf des Produkts. Im Regelfall kommt die voll Steuer (z.B. in DE 19%) zur Anwendung. Ausnahmen mit reduzierter Steuer können z. B. Bücher oder Lebensmittel sein. |
Competence Center
Produktdatenupload
Shopsystem / Backend
Bei dem Upload der Daten unterscheiden wir zwischen Produkt- und Angebotsdaten. Nachfolgend gehen wir näher auf den Produktfeed ein.
Der Produktfeed muss von den beiden Feeds zuerst in das Backend geladen werden, damit die Angebote nachher den angelegten Produkten zugeordnet werden können.
Die Produktdaten beinhalten eher starre Informationen, welche sich in der Regel kaum ändern, wie z. B. die Produktgruppe, Herstellerteilenummer oder Marke.
Zulässige Formate für den Produktfeed
- .csv (Standard Dateiformat 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 Vorlage, zum anderen auch über einen eigenen Datenexport aus Ihrem PIM System möglich. Grundsätzlich lautet die Empfehlung, 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 aller relevanten Attribute für den Produktfeed. Sie finden hier zum einen Infos über verpflichtende Attribute sowie empfohlene Attribute, welche Ihnen hinsichtlich der Sichtbarkeit Ihrer Produkte auf der Plattform helfen.
Übertragungsmöglichkeiten
Es gibt unterschiedliche Wege, die Produkte zu importieren.
Per FTP-Server
Sie können für einen automatisierten Import Ihrer Produkte eine Serververbindung in Ihrem Mirakl Konto pflegen. Gehen Sie dazu auf:
- "Mein Konto"
- "Einstellungen"
- "Importe
Folgend eine kleine Checkliste was wir von Ihnen benötigen:
- Protokoll (HTTP, HTTPS, FTP 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
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
Alle Uploads für Produkte, Angebote und auch Preise können ebenfalls manuell über die Importmaske im Mirakl Portal erfolgen. Gehen Sie dazu auf:
- "Mein Inventar"
- "Aus Datei importieren"
Über die Tabs können Sie daneben die Importe überprüfen und etwaige Fehlerberichte abrufen.
Gängige Fehlermeldungen
Beim Import Ihrer Produkte kann es durchaus vorkommen, 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. Beim Produktimport können sowohl Umwandlungsfehler als auch Integrationsfehler auftauchen.
Sie können diese Fehlerberichte in Ihrem Mirakl Konto unter folgendem Pfad in der Spalte "Aktionen" abrufen:
"Mein Inventar" → "Aus Datei importieren" → "Produktimporte überprüfen"
Folgend finden Sie eine Übersicht der gängigsten Fehlermeldungen und wie Sie diese beheben können.