How to create campaign and upload products to Allegro

In this post, we will show how to create a campaign and upload products to Allegro.cz, Allegro.sk or Allegro.pl. Before we start, make sure you have created an account on Allegro and that you have everything set up. You can find a detailed procedure for registering a business account on Allegro here.

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.

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. 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.

  1. 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 you have this element included in the product feed, you can pair it in the next step.

Next, you need to select the Shipping Pricing, Returns & Terms for the campaign. You can create these sales documents directly in the Allegro administration in the sales settings section.

  1. The next step is to select the product feed and pair the elements. In this step, you will tell the application where to download your data from, i.e. select export and query from the Mergado Editor. Finally, you will tell us which elements to use.

: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.

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.

:information_source: 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.

  1. 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 5. 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.

: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.

  1. 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.