Mirakl ist die Plattform hinter vielen Händler-Marktplätzen, und 3Dsellers verbindet sich mit jedem davon auf dieselbe Weise: Öffnen Sie Integrations, klicken Sie auf die Mirakl-Kachel, dann auf Add Mirakl Store, und fügen Sie die Adresse Ihres Marktplatzes sowie den Shop-API-Key aus dem Seller-Backoffice dieses Marktplatzes ein. Es gibt keine Weiterleitung zum Anmelden - Mirakl vergibt für jeden Shop einen festen API-Key, daher dauert die Verbindung etwa eine Minute. Danach importiert 3Dsellers Ihre Mirakl-Angebote und zeigt sie als Listings neben Ihren anderen Kanälen an.
⚠️ Beta. Die Mirakl-Integration ist neu und auf der Integrations-Seite mit BETA gekennzeichnet. Wenn sich etwas anders verhält als hier beschrieben, sagen Sie uns im Chat Bescheid, damit wir es schnell beheben können.
💡 Öffnen Sie Integrations und suchen Sie unter Marketplaces die M-Kachel neben Temu.
Was ist ein Mirakl-Marktplatz?
Mirakl ist kein einzelner Marktplatz. Es ist die Software, mit der Händler wie Carrefour, Best Buy Canada, Kroger, Macy's, Fnac und Catch ihre eigenen Marktplätze betreiben. Jeder Händler (bei Mirakl Operator genannt) betreibt eine eigene Instanz mit eigenem Katalog, eigenen Kategorien und eigenem Seller-Backoffice. Daraus folgen zwei Dinge:
Jeder Marktplatz ist in 3Dsellers ein eigener Shop. Wer auf Carrefour und auf Fnac verkauft, verbindet zwei Mirakl-Shops, jeder mit seinem eigenen API-Key.
Sie verkaufen Angebote, keine Produkte. Auf einem Mirakl-Marktplatz gehören die Produktinhalte (Titel, Beschreibung, Bilder, Marke) dem Operator. Als Verkäufer gehört Ihnen das Angebot auf dieses Produkt: Ihr Preis, Bestand, Zustand und Ihre Shop-SKU. 3Dsellers importiert Ihre Angebote - was Sie in 3Dsellers als Listing sehen, ist Ihr Angebot zusammen mit den Produktinhalten des Operators.
Wo finde ich meinen Mirakl-API-Key?
Der Key kommt vom Marktplatz, nicht von 3Dsellers:
Melden Sie sich im Seller-Backoffice des Marktplatzes an (die Seite, auf der Sie sich als Verkäufer anmelden, zum Beispiel
https://your-instance.mirakl.net).Klicken Sie oben rechts auf Ihren Benutzernamen.
Öffnen Sie My user settings.
Erzeugen Sie unter API key einen Key und kopieren Sie ihn.
Jeder Marktplatz vergibt seinen eigenen Key - wiederholen Sie das auf jedem Marktplatz, den Sie verbinden möchten. Halten Sie den Key geheim: Wer ihn hat, kann Ihre Angebote auf diesem Marktplatz lesen und ändern.
Wie verbinde ich einen Mirakl-Shop mit 3Dsellers?
Öffnen Sie in 3Dsellers Integrations (Settings, dann Integrations).
Klicken Sie unter Marketplaces auf die Mirakl-Kachel (das M-Logo mit dem BETA-Badge). Die Seite Mirakl Stores öffnet sich.
Klicken Sie auf Add Mirakl Store.
Fügen Sie unter Marketplace URL die Adresse ein, unter der Sie sich als Verkäufer anmelden.
Fügen Sie unter API key den Shop-API-Key ein, den Sie im Backoffice erzeugt haben.
Klicken Sie auf Add Store. 3Dsellers prüft den Key beim Marktplatz und bestätigt, sobald er akzeptiert wurde, dass der Shop hinzugefügt wurde. Der Shop erscheint als Zeile auf der Seite Mirakl Stores.
Sie werden nirgendwohin weitergeleitet und es öffnet sich kein Anmeldefenster: Die gesamte Verbindung findet im Dialog statt.
Was der Dialog „Add a Mirakl Store“ abfragt
Marketplace URL
Die URL Ihrer Mirakl-Instanz, also die Adresse, unter der Sie sich als Verkäufer anmelden. Der Dialog zeigt https://your-instance.mirakl.net als Beispiel; eigene Marktplatz-Domains funktionieren ebenfalls (eine händlereigene Domain, die nicht auf mirakl.net endet). Sie können die reine Adresse, die Adresse mit Schrägstrich am Ende oder einen aus dem Backoffice kopierten Deep-Link einfügen - 3Dsellers behält nur den Teil bis zur Domain. Die Adresse muss mit https:// beginnen. Eine Adresse ohne https://, mit eingebettetem Benutzernamen oder Passwort oder ohne echte Domain wird mit einem Beispiel für eine gültige Adresse abgelehnt.
API key
Der Shop-API-Key aus My user settings im Backoffice des jeweiligen Marktplatzes. Bleibt das Feld leer, erscheint Mirakl API key is required. 3Dsellers sendet den Key an den Marktplatz, um zu prüfen, dass er zu einem Shop gehört, bevor der Shop gespeichert wird.
Die Tabelle Mirakl Stores
Jeder verbundene Shop ist eine Zeile mit diesen Spalten: Store, Shop ID (die ID des Shops auf diesem Marktplatz), Display Name (der Name, den Sie dem Shop in 3Dsellers geben können), Marketplace, Host (die Marktplatz-Domain, zu der der Shop gehört), Currency und Date Added. Ein Shop wird über seine Shop ID zusammen mit seinem Host identifiziert - dieselbe Shop-ID auf zwei verschiedenen Marktplätzen sind also zwei getrennte Shops.
Was passiert nach der Verbindung?
Ihre Angebote werden als Listings importiert. 3Dsellers liest Ihre Angebote vom Marktplatz, 100 auf einmal, und legt für jedes ein Listing an; Ihre Shop-SKU wird dabei als SKU des Listings verwendet. Ein Angebot, das auf dem Marktplatz keine Shop-SKU hat, wird übersprungen.
Inaktive und ausverkaufte Angebote kommen als Ended an. Jedes Angebot wird importiert, ob aktiv oder nicht. Ein Angebot, das auf dem Marktplatz deaktiviert ist oder dessen Menge 0 ist, erscheint in 3Dsellers als Ended-Listing. Angebote, die Sie auf dem Marktplatz gelöscht haben, werden gar nicht importiert.
Mirakl erscheint als Kanal in ganz 3Dsellers. Nach der Verbindung können Sie Mirakl in der Kanalauswahl von Listings, Catalog, den Kundenfiltern, Automations und Reports wählen und Ihre Katalog-Kategorien den Kategorien des Marktplatzes zuordnen.
Große Shops brauchen länger. Der erste Import hängt von der Zahl Ihrer Angebote ab; Sie können in Listings zusehen, wie die Listings eintreffen.
Was die Mirakl-Integration nicht tut
Sie erstellt oder bearbeitet keine Produktinhalte des Operators. Titel, Beschreibungen und Bilder auf einem Mirakl-Marktplatz gehören zum Katalog des Operators; 3Dsellers arbeitet mit Ihren Angeboten auf diesen Produkten.
Sie verbindet nicht mehrere Marktplätze mit einem Key. Jeder Mirakl-Marktplatz ist ein eigener Shop mit eigenem API-Key.
Sie funktioniert nicht weiter mit einem Key, den Sie widerrufen haben. Wenn Sie den Key im Backoffice des Marktplatzes neu erzeugen, funktioniert der alte nicht mehr und der Shop muss mit dem neuen Key erneut verbunden werden.
Sie akzeptiert keine Adresse ohne
https://.
Fehlerbehebung
Der Dialog meldet „Mirakl API key is required“
Das Feld API key war leer oder enthielt nur Leerzeichen. Fügen Sie den Key erneut ein; Leerzeichen am Anfang und Ende entfernt 3Dsellers automatisch.
Meine Marktplatz-URL wird nicht akzeptiert
Stellen Sie sicher, dass sie mit https:// beginnt und die Adresse ist, unter der Sie sich als Verkäufer anmelden. Entfernen Sie Benutzernamen oder Passwort aus der Adresse. Eine händlereigene Domain ist in Ordnung, solange es die Adresse des Seller-Backoffice ist.
3Dsellers meldet, der Shop gehöre zu einem anderen Konto
Dieser Shop ist auf diesem Marktplatz bereits mit einem anderen 3Dsellers-Konto verbunden. Entfernen Sie ihn zuerst dort, oder kontaktieren Sie uns im Chat mit Shop-ID und Marktplatz.
Einige meiner Angebote fehlen in 3Dsellers
Prüfen Sie, ob das Angebot auf dem Marktplatz eine Shop-SKU hat - Angebote ohne SKU werden übersprungen. Prüfen Sie auch das Segment Ended: Angebote, die deaktiviert sind oder Menge 0 haben, werden dort importiert, nicht unter Active.
FAQ
Melde ich mich beim Verbinden bei Mirakl an?
Nein - beim Verbinden eines Mirakl-Shops mit 3Dsellers werden Sie nicht auf eine Anmeldeseite weitergeleitet. Sie fügen die Marktplatz-Adresse und den Shop-API-Key in den Dialog Add a Mirakl Store ein und klicken auf Add Store.
Ich verkaufe auf mehreren Mirakl-Marktplätzen. Verbinde ich jeden einzeln?
Ja - jeder Mirakl-Marktplatz vergibt seinen eigenen API-Key und ist in 3Dsellers ein eigener Shop. Klicken Sie pro Marktplatz einmal auf Add Mirakl Store.
Welche SKU verwendet 3Dsellers für meine Mirakl-Listings?
3Dsellers verwendet Ihre Shop-SKU vom Marktplatz als SKU des Listings - darüber wird das Angebot den Produkten in Ihrem Katalog zugeordnet.
Was bedeutet das BETA-Badge?
Die Mirakl-Integration in 3Dsellers ist neu veröffentlicht und wird noch verfeinert. Verbinden, Angebote importieren und die täglichen Werkzeuge funktionieren wie hier beschrieben, und wir freuen uns während der Beta über Feedback im Chat.