Quickstart-Guide zur Artikellistung

Katalogverwaltung

Schritt 1: Meine Produkte

1.1. Welche Grunddaten muss ich für die Anlage meiner Produkte liefern?

Pflichtmerkmale

  • Produktgruppe / Kategorie
  • Produkttitel (Kurzbezeichnung)
  • Marke / Hersteller
  • EAN
  • Verkaufsmengeneinheit
  • Inhalt pro Verkaufseinheit
  • Einheit der Inhaltsmenge
  • Umsatzsteuerklasse
  • ElektroG Geräteart
  • ElektroG EAR Markenbezeichnung

Empfohlene Merkmale

  • Produktbilder (mind. 1)
  • Datenblätter / Bedienungsanleitungen
  • Werbetext (Langbeschreibung)
  • Highlights / USPs
  • Hinweistexte
  • Schlagworte
1.2. Wie erstelle ich meinen Produktkatalog?

Es gibt folgende Möglichkeiten einen Feed zur erfolgreichen Produktlistung aufzubauen:

  • Nutzung des Original Mirakl Templates
  • Erstellung eines CSV / XLSX Exports aus dem eigenen PIM oder ERP System
  • XML Export (wird in der Regel im Zuge der Nutzung einer Schnittstelle genutzt bzw. automatisch generiert)
    In solchen Fällen wird quasi die Zuordnung Ihrer Datenstruktur auf die Conrad Struktur in einem externen System vorgenommen.

Für welche Use Cases nutze ich das Mirakl Template?

  1. Wird in der Regel bei sehr schmalen Sortimenten benutzt (Umfang ~ 1 - 500)
  2. Bei weniger  aktualisierungsaufwändigen Sortimenten
  3. Produktanlagen und Updates die keine regelmäßige / automatisierten Importe erfordern

Das Template ist eher als Quick & Dirty Lösung gedacht. Prinzipiell besteht dennoch die Möglichkeit die Betreiber Struktur aus dem Template im eigenen System nachzubauen und so einen eigenen bereits dem Betreiber Format entsprechenden Export zu generieren.

 

Für welche Use Cases nutze ich einen eigenen Export aus meinem System?

  1. Wird in der Regel bei umfangreicheren Sortimenten genutzt (ab 1000 und aufwärts)
  2. Bei eher aktualisierungsaufwändigen Sortimenten

Vorteile der Nutzung eines Systemexports sind -

  • Mehr Flexibilität im Hinblick auf Erweiterung von Sortimenten und Anreicherung von Content
  • Gewährleistung sauberer und regelmäßiger (automatisierter) Importe über Ihren SFTP / HTTPS Server

 

1.3. Wie steuere ich meine Importe?

Es gibt grundsätzlich zwei Wege die Importe zu steuern:

  • Manuell → die entsprechende Datei wird direkt im Mirakl Portal hochgeladen

  • Automatisiert
    • Per SFTP / HTTPS → die Verbindungseinstellungen für Ihren Server können in Ihrem Mirakl Konto hinterlegt werden.
    • Per API → hierfür ist die Einrichtung einer API Anbindung notwendig. Mittels Endpunkt P41 aus der Products Schnittstelle von Mirakl können Dateien in allen zulässigen Formaten in definierten Zeitintervallen übertragen werden.
    • Per Schnittstelle / Aggregator → eine Übersicht des angebundenen Schnittstellenportfolios finden Sie hier.

Die gängigste Methode ist die Nutzung eines SFTP / HTTPS Servers, da diese i.d.R. schnell eingerichtet werden können. Zu beachten ist, dass die genannten Punkte nicht die Nutzung eines unserer angebundenen Aggregatoren betreffen, wobei in solchen Fällen grundsätzlich eine Übertragung aus dem jeweiligen System Richtung Mirakl (via API) erfolgt. Sprich, die Datenübertragung für unsere Aggregatoren ist im Endeffekt eine bereits eingerichtete API Anbindung.      

1.4. Wie lade ich meine Produkte hoch?

Im Endeffekt beschreibt der Weg, wie die Importe gesteuert werden, auch die Möglichkeiten des Imports. 

Für kurzfristige /dringliche Update, welche nicht im Turnus Ihres Automatismus erfolgen, kann ein Import manuell in Ihrem Mirakl Konto erfolgen. Hier gibt es prinzipiell zwei Wege:

1.5. Wie kann ich meine Datenstruktur mit Conrad mappen?

Grundsätzlich ist davon auszugehen, dass Ihre Datenstrukturen sich aufgrund potenziell verschiedener Systemlandschaften zu denen von Conrad / Mirakl unterscheiden, weshalb es notwendig ist ein Mapping der Artikelgruppen, Merkmale und Wertelisten durchzuführen. Wie der Mapping Assistent in Ihrem Mirakl Konto funktioniert und wo Sie diesen finden erfahren Sie in diesem Artikel.

1.6. Wie verwalte und optimiere ich meine Produktdaten?

Produktdaten können lediglich durch Import der jeweiligen Datei in Ihrem Mirakl Konto angereichert oder aktualisiert werden. Eine direkte Bearbeitung in Ihrem Mirakl Konto ist leider nicht möglich.

Zur Verbesserung der Darstellung Ihres Produktcontents haben Sie relativ viel Spielraum. Produktinhalte können sowohl auf globaler Ebene als auch auf Ebene der jeweiligen Artikelgruppe angepasst werden.

  • globale Ebene → Merkmale, welche für jedes Produkt (unabhängig von der Artikelgruppe) gepflegt werden können
  • Artikelgruppenebene → Merkmale, welche nur bei bestimmten Artikelgruppen gepflegt werden können (bspw. der Bohrfutter-Soannbereich bei Bohrmaschinen oder die Display-Diagonale bei Fernsehern)

 

Breite und umfangreiche Sortimente

Bei Sortimenten mit vielen Artikelgruppen aus unterschiedlichen Segmenten kann die Pflege des Contents sowie das Einspeisen in Ihren Katalg inkl. des Mappings in Ihrem Mirakl Konto relativ zeitaufwändig sein. Hier empfiehlt es sich bspw. zu prüfen,

  1. ob die relevanten globalen Textmerkmale gepflegt sind (bspw. Werbetexte, Highlights & Details, weitere unsortierte technische Daten, Hinweistexte, Lieferumfang, Ausstattungsmerkmale, etc.)
  2. inwieweit Content auf Artikelgruppenebene vorliegt. Hier kann es Sinn machen Kategorie für Kategorie vorzugehen und sich dabei an der Ansicht aus dem Performance Dashboard in Ihrem Seller Portal zu beziehen. Dort bekommen Sie den aktuellen Content Score angezeigt und können somit gezielt Ihre Daten anreichern. (bspw. die Display-Diagonale oder die Anzahl an HDMI Anschlüssen bei Fernsehern)

 

Schmale und tiefe Sortimente

Bei Sortimenten mit nur wenigen Artikelgruppen aus einem bestimmten Segment / Kategorie ist es durchaus ratsam soweit es geht Content im Produktfeed zu übermitteln, sowohl auf globaler, als auch auf Artikelgruppenebene. 

Infos zu den verfügbaren Merkmalen auf Conrad Seite erhalten Sie entweder durch Download einer entsprechenden Vorlage mit den gewünschten Artikelgruppen aus Ihrem Mirakl Konto oder durch Abruf über die Mirakl API Schnittstelle (PM11)

Schritt 2: Meine Angebote

2.1. Welche Daten muss ich zur Anlage meiner Angebote liefern?

Pflichtmerkmale

  • sku (Angebots-SKU)
  • product-id (Produkt-ID)
  • product-id-type (Produkt-ID-Typ)
  • price (Angebotspreis)
  • state (Status des Angebots)
  • reversecharge (Reverse Charge)
  • warehouse (Lagerort (1-5))

Die Bezeichnungen in Klammern beschreiben das jeweilige Wertelabel, dieses findet in der Regel nur bei Nutzung des Original Mirakl Templates Anwendung. 

Empfohlene Merkmale

  • quantity (Angebotsmenge)
  • logistic-class (Logistikklasse)
  • leadtime-to-ship (Versandvorlaufzeit)
  • producer-id[DE-WEEE] (WEEE Nummer)
  • description (Beschreibung des Angebots)

Eine Übersicht mit einer Beschreibung der Felder finden Sie in der Dokumentation von Mirakl.

2.2. Wie erstelle ich meine Angebotsdatei?

Es gibt folgende Möglichkeiten einen Feed zur erfolgreichen Angebotslistung aufzubauen:

Die Angebotsdatei muss stets entsprechend der Vorgaben von Mirakl aufgebaut werden, eine Zuordnung in Ihrem Mirakl Konto ist leider nicht möglich.

Bei den Merkmalen wird in zwei Kategorien unterschieden:

  1. Native Felder, welche von Mirakl bereitgestellt werden und auf allen Mirakl Marktplätzen gleich sind
  2. Plattformspezifische Felder des jeweiligen Marktplatzbetreibers
    → Diese sind prinzipiell per API über AF01 abrufbar (Filter ''entities'', Wert ''OFFER'')

 

2.3. Wie steuere ich meine Angebotsimporte?

Es gibt grundsätzlich zwei Wege die Importe zu steuern:

  • Manuell → die entsprechende Datei wird direkt im Mirakl Portal hochgeladen

  • Automatisiert
    • Per SFTP / HTTPS → die Verbindungseinstellungen für Ihren Server können in Ihrem Mirakl Konto hinterlegt werden.
    • Per API → hierfür ist die Einrichtung einer API Anbindung notwendig. Mittels Endpunkt OF01 aus der Offers Schnittstelle von Mirakl können Dateien in allen zulässigen Formaten in definierten Zeitintervallen übertragen werden.
    • Per Schnittstelle / Aggregator → eine Übersicht des angebundenen Schnittstellenportfolios finden Sie hier.

Die gängigste Methode ist die Nutzung eines SFTP / HTTPS Servers, da diese i.d.R. schnell eingerichtet werden können. Zu beachten ist, dass die genannten Punkte nicht die Nutzung eines unserer angebundenen Aggregatoren betreffen, wobei in solchen Fällen grundsätzlich eine Übertragung aus dem jeweiligen System Richtung Mirakl (via API) erfolgt. Sprich, die Datenübertragung für unsere Aggregatoren ist im Endeffekt eine bereits eingerichtete API Anbindung.   

2.4. Wie lade ich meine Angebote hoch?

Im Endeffekt beschreibt der Weg, wie die Importe gesteuert werden, auch die Möglichkeiten des Imports. 

Für kurzfristige /dringliche Update, welche nicht im Turnus Ihres Automatismus erfolgen, kann ein Import manuell in Ihrem Mirakl Konto erfolgen. Hier gibt es prinzipiell zwei Wege:

  • Über die Importmaske im Reiter ''Preis & Lager'' → ''Dateiimporte''