General information on Mirakl (Nextail & VidaXL)
Mirakl is a platform on which a couple of our marketplaces (Nextail & VidaXL) are built. Because the marketplaces that are built on Mirakl are all set up in the same way, we describe how to set it up in 1 support article. So if you're trying to set up a Nextail or VidaXL marketplace, this guide will tell you how you can do that.
Note: You need valid EAN codes to send your products to a Mirakl marketplace
How do I start sending to a Mirakl marketplace?
If you have an account of a Mirakl marketplace, you can head over to your Channable account and go to "Marketplaces > Add new marketplace". Now click on "Create new connection". Next, you select the right marketplace logo, choose a name for your new connection (e.g. "yourshop - VidaXL") and click "create" afterwards (see below).
API key & Shop ID
To create the connection you need to enter an API key and a shop ID. The API key created in your VidaXL or Nextail seller account by going to you "user settings" by clicking on your email address in the top right corner. After that you go to "API key" and click "generate API key" if there is no key available yet. Of there is an API key available, you can use that one, you don't have to create a new one.
You can also find the Shop ID in your seller central. First select the shop you want to send products to in the top right corner. Next, go to "My Account > Settings" to find your Shop ID:
If you have both the API key and the Shop ID you can finish creating your connection in Channable. If you did so, choose your fresh Mirakl marketplace connection in the next screen and choose a name for your marketplace (e.g. "Nextail") and click continue.
Start building the ads!
Once you have created the marketplace, you'll be sent to the categories page. The categories step enables you to convert your own categorization to that of Nextail (by using the Generate categories feature), or create new categories from scratch, as seen in the screenshot below.
After you are finished categorizing your products, it's time to create some rules in order to optimize your product data (e.g. excluding certain products). Some common rules to use can be found here. After creating the rules you want to implement, go to build to start building your ads.
On the product tab you connect the fields containing your EAN code/gtin, title, description, stock and price, similar to how it's done in the screenshot below.
Almost done! Next up is filling in the fields in the attribute builder. Click the ''attribute builder'' tab in Build and select the category you want to optimize first. An example of what should be in front of you now can be seen in the screenshot below. A more detailed explanation of the attribute builder's use can be found here.
Check & Send
Next, go to the preview step to check the products that are about to be sent to your Mirakl account. If that looks right, go to the "Settings" step and activate the marketplace API:
Finally, go to APIs and click "Run now" on your newly set Mirakl marketplace to start sending the products!
Note that the products need to be sent to a test environment first. After VidaXL/Nextail accepts your products, you can send them to the live environment. Please contact our support team to make sure you are sending to the right environment.