In this article, you will learn how to properly pair categories, parameters, and values of your products within the Heureka feed connection.
IMPORTANT: Any pairing of parameters and values that you perform according to the following instructions has a direct effect on the appearance and product classification on the MALL website. Therefore, please be extremely careful when choosing categories and parameters. Improper product classification may result in the product being withdrawn from our website.
You can find the status of the pairing of categories in the MALL Partner Portal in the tab Heureka feed -> Feed status, in the right part "Categories".
Here you will see the complete number of categories in the Heureka feed. You will see the number of categories that have been paired automatically, as well as the number of categories that are unpaired and need editing. For more detailed information about unpaired categories, click the button "View".
There are two ways how to pair categories within the Heureka feed connection.
Pairing using CATEGORYTEXT
To categorize a product, fill in the CATEGORYTEXT element in your feed. You need to specify the complete path to the final subcategory.
In this case, all correctly listed categories are automatically paired to their equivalent in the Mall.cz/Mall.sk tree, if such a category is present in the tree.
You need to be careful when Heureka changes its category tree. In such a situation it may happen that the CATEGORYTEXT becomes invalid and the element will need to be updated according to the new version of the Heureka tree.
In this case, your category will be unpaired and the products will be withdrawn from the site. You can find the category in unpaired categories see described in "Pairing categories".
Manual pairing of categories
The second option is to pair the categories manually, which you can perform directly in the partner portal in the tab Heureka feed -> Category pairing.
Here you will find your Heureka category tree as you post them in your feed. You can expand to view the complete tree or just the unpaired categories.
The final categories can then be paired using the category picker, which always tries to select the most appropriate category from the available tree based on the category you specify.
You can confirm the automatic selection with the flash button or switch to another suitable category by selecting it from the whisperer. In case you then want to change the value, just use the Basket button.
IMPORTANT: You always match the categories to the Heureka.cz/Heureka.sk category tree and the values in the suggested list also correspond to it. Look for the most suitable product classification on Heureka, not on the Mall.cz/Mall.sk website.
If Heureka changes the given category in the category tree even in this type of pairing, the given category becomes invalid and re-pairing is necessary.
If you find that the product is not positioned correctly according to the automatic product classification, you can use the manual product transfer, instructions can be found here. You may also be asked for this type of reassignment by the Mall Partner team.
You can also watch our instructional video (only in Czech)
For correct functioning and display of products it is necessary to match the values to the parameters see section Value pairing.
You can find a section for pairing parameters and values in the section Heureka feed -> Pairing parameters and values.
Here in the list you will find all the categories contained in your feed. By clicking on a specific category, you will be offered MALL parameters in the list in the right column, to which you can pair your parameters.
By clicking on the parameter, the whisperer will automatically offer you your most convenient parameter from the feed. In case you do not agree with the automatic selection, you can select another parameter that is included in the feed for that category. You can approve the selection using buttons with the tick symbol. The paired parameter is confirmed by a green tick in the upper right, see the figure below. When pairing, please make sure that the parameters match.
If you have variant products in the feed marked with ITEMGROUP_ID element and you send variant parameters for individual items in the feed, you can also create these variants in our interface. ITEMGROUP_ID must not be the same as ITEM_ID.
Subsequently, these products will be displayed as a variant, that is one product with the option to select, for example, size or color.
To create a variant product, you need to check the "Variant product" icon when pairing the parameter. This will confirm to the system that you want to create variant products based on the selected parameter.
If you add new variants during your MALL operation, you need to pair the additional values afterwards.
ATTENTION: A maximum of 2 variant parameters can be set for one category.
The same procedure as for parameter pairing must be performed for value pairing.
After selecting a suitable parameter, you will see your values that you send for the parameter in the feed. The system will automatically offer you the most suitable value. You can either confirm the offered values or manually pair them to a different desired value.
IMPORTANT: Values of purely numerical parameters (eg volume, power) do not need to be paired, they are overwritten automatically.
For example, the parameter Dimension = 120 × 200 cm and / or Size = 2XL is not accepted by the system as a numerical value and therefore manual pairing is required.
More information can be found in the attached video below.
Missing category, parameter or value
In case you do not find a suitable category, parameter or value in our system, please contact us through FAQ, or directly to the Onboarding Specialist, who solves your connection with you.
The connection using the Heureka XML feed is similar to a package solution. Many processes work automatically, so this type of connection may not be suitable for you. In this case, you can use another form of implementation. You can find more information here.