How to create campaign and upload products to Allegro

First of all, you need to activate the Mergado Marketplaces app in the Mergado Store. Before you start, make sure you have:
:white_check_mark: Verified business account on Allegro
:white_check_mark: Product feed in Mergado Editor with EAN codes
:white_check_mark: Heureka/Mall availability feed

In this post we will show you how to create a campaign and upload products to Allegro. Before we start, make sure you have created and verified a business account on Allegro and that you have filled in the shipping price list, returns terms and complaints terms. You can find a detailed procedure for registering a business account on Allegro here.

:warning: Please note that the market where you create your account will be your default storefront. The default storefront cannot be changed and you must always have your listings displayed on this market. Our app currently only supports selling on the default storefront, so if you want to sell on allegro.cz, create an account on Czech Allegro, if you want to sell on allegro.pl, create an account on Polish Allegro and if you want to sell on allegro.sk, create an account on Slovak Allegro. Within Allegro, you can then post these offers on other markets, for more information see here.

Connection creation

The first thing to do is to create a new connection to Allegro in the app. Go to the connection menu and then click on the + icon in the blue circle.

Click on the “Connect” button.

When you click on the “Connect” button, a new page will open in your browser, click on the “Next” button.

If you are not logged in, enter your login details and log in.

Confirm the application is connected for the account by clicking “Continue”.

Allegro will notify you on the last page that you have successfully connected.

Then return to the app where you will see a message about the successful connection. Instead of the + button, you now see a green button with a white pipe.

You are now connected :white_check_mark:

Creating a campaign

Once you have created your connection, go to the “Campaigns” tab in the menu and you will see a “Create Campaign” button in the middle of the page. You will be greeted by our 5 step guide to creating a campaign.

1. General
The first step is to determine the name of the campaign. The name can be anything you want, but we recommend a name that lets you know what the campaign is about at a glance.

2. Marketplace
The next step is to choose and set up the right marketplace, in our case it is Allegro. An information window will notify you what your Allegro default storefront is that you will be selling on. The listings will be displayed on this marketplace, so you need to pair the price in the currency of the default storefront.

In this step you can also select the CONDITION and HANDLING_TIME for the entire campaign. However, if all your products do not have the same condition or handling time, you can pair this data to your product feed later.

You then need to select shipping price list, returns terms and complaints terms. You can create these sales documents directly in the Allegro administration in the sales settings section.

3. Mergado
In the next step, you need to select from which Mergado project and selection you want to upload products to the marketplace.

:question: You don’t have any export to choose yet? See how to upload a product feed to Mergado Editor here.

:information_source: If you don’t want to send all products from a given project to the marketplace, create a selection of products you want to list on the marketplace in Mergado Editor. Please note that you cannot change the selection later in the campaign settings. At the same time, it is not possible to edit the product composition in the application using the hide rule, as this rule is not transferred to Mergado Marketplaces.

Then the section for mapping elements from the selected project in Mergado Editor to elements in Marketplaces opens. You must map 3 elements:

  • EAN / ISBN / MPN / UPC = product identification element. You can map one or more.
  • PRICE = element that contains the price (price must be in the currency of the default storefront).
  • PRODUCT_ID = an element that contains the product ID. The product ID in the availability and product feed must match in order to correctly pair availability.

:exclamation: If you have already filled in the values of the CONDITION and HANDLING_TIME elements in the previous step, do not map the elements here.

The PRODUCT_NAME, DESCRIPTION and IMAGE elements are optional, but if you pair them, we will try to send your offer data to Allegro. Please note that Allegro only accepts specific HTML formatting for product descriptions. More information can be found here. If you do not pair these elements, or if there is something wrong with the data provided, we will use the data provided by Allegro to publish the offer.

:warning: We try to give you hints about element pairing, but we may not always get it right. So before you continue, read carefully what is mapped how and make sure you have mapped the elements correctly.

4. Availability feed
The second to last step is to set up the availability feed. Here you just need to enter the address of your availability feed. We support Mall and Heureka availability feed. If your access to the availability feed is somehow restricted, you need to remove this restriction. It is also important that the product ID in the availability feed and product feed match.

:bulb: If you do not have an availability feed in Mall or Heureka format, you can create one using Mergado Editor.

:information_source: If you encounter the error message “An error occurred while downloading the availability feed, please make sure the file is available”, it is likely that you have the availability feed secured and the application cannot access it. If you have your e-shop on Shoptet, here is how to adjust the security of your availability feed in Shoptet administration so that the application can access it.

5. Completion
The last step is a summary of the campaign setup. Here, just check that you have set everything up correctly, and correct the information if necessary. Finally, click on “Save”.

:white_check_mark: The campaign has been created and your offers are now being uploaded to Allegro. This process may take some time, so please be patient. However, this is not the end of the process of uploading offers to Allegro. It is a good idea to check the number of uploaded and not uploaded products and correct any errors.

:exclamation: After the synchronization of the product feed is complete, click on the campaign detail and check the validation section for any error messages. An explanation of the most common validation messages can be found here.

:question: Did you find the error message “Allegro couldn’t find a product with the specified ID” in the validation section? This message means that there is no product card for the product in the Allegro catalogue yet. Detailed instructions on how to create a product card via our application can be found here.