How to Fix Feed Errors and Prevent Heureka from Rejecting Products#

For successful advertising on Heureka, your product XML feed must meet all of Heureka’s requirements. This means it must contain specific elements that are the fundamental building blocks of the data file (XML feed). Mergado takes care of transforming the element structure from your input feed into the structure Heureka requires. However, you are the one who must tell Mergado what information to fill into each element – and you must provide this information in your input feed.

Why You Need to Understand and Work with Heureka Elements#

You may have already experienced Heureka repeatedly rejecting some of your products and refusing to display them. This is caused by incorrectly filled elements, which prevent Heureka from pairing your products with product cards and therefore not displaying them. But do not worry – you will not have to manually rewrite all incorrectly filled elements for thousands of products according to Heureka’s requirements. That is what Mergado is for.

The complete list of elements Heureka works with is available on their website. Some are mandatory and have a precisely defined structure; others are not mandatory. However, the more thoroughly and completely your feed is filled in, the better Heureka will display your products.

Mandatory Elements and Elements Essential for Correct Pairing#

The most important elements for displaying and correctly pairing your products into Heureka’s product cards are:

• PRODUCTNAME – mandatory, contains the exact product name
• CATEGORYTEXT – contains the path to the correct product category according to Heureka’s catalog
• ITEM_ID – mandatory, contains a unique and permanent product identifier within the online store
• PRICE_VAT – mandatory, contains the product price
• URL – mandatory, contains a unique address linking to the product page in your online store
• DELIVERY – includes further elements containing the type of shipping offered for individual products and the shipping price
• DELIVERY_DATE – contains the number of days until the product is dispatched
• IMGURL – contains a link to the main product image
• ITEMGROUP_ID – element used to mark (group) a set of products that are variants of one product
• HEUREKA_CPC – contains the maximum cost per click (i.e., maximum CPC)
• EAN – contains the barcode of the product

Additional elements in the Heureka feed include SHOP, SHOPITEM, PRODUCT, DESCRIPTION, IMGURL_ALTERNATIVE, VAT, ITEM_TYPE, PARAM, MANUFACTURER, MANUFACTURER_POSTAL_ADDRESS, MANUFACTURER_ELECTRONIC_ADDRESS, ISBN, ACCESSORY, GIFT, EXTENDED_WARRANTY, SPECIAL_SERVICE, and SALES_VOUCHER.

PRODUCTNAME#

PRODUCTNAME contains the exact product name, is a mandatory element of the Heureka feed, and is required for products to display correctly.

This element is key for product pairing – assigning your products to the corresponding product cards on Heureka. For correct pairing, the PRODUCTNAME element must contain all mandatory information for the selected category (e.g., for clothing, the size must be included directly in the name).

Mandatory data for individual categories and examples of correct names can be found on Heureka’s website. For example, for the Men’s socks category, the mandatory data are Brand | Line | Color | Size. A correctly filled PRODUCTNAME would look like: VoXX ponozky Setra dark gray 35-38

This element should not contain superfluous information such as a gift with the product, warranty details, and similar items. The maximum text length is 200 characters, which you can automatically enforce by setting up the Truncate value rule.

How to Add the Manufacturer Name to the PRODUCTNAME Element?#

The easiest way to add the manufacturer name to PRODUCTNAME is to use the automation Mergado offers.

1. In the selected project, click the Automation tab.
2. Click the automation called Add producer to product title.
3. Fill in the Manufacturer element name – enter the element from your input feed that contains the manufacturer name (e.g., MANUFACTURER).
4. Fill in the Product name element name – enter the element from your input feed that contains the product name (e.g., PRODUCTNAME).
5. As the Output product name element, enter PRODUCTNAME.
6. Click Run automation.

How to Add Size or Another Parameter to the PRODUCTNAME Element?#

If you want to add another mandatory parameter for a given category (e.g., size, material, or whether it is men’s/women’s/children’s) to PRODUCTNAME, you need to create a rule in Mergado.

1. In the selected project, first create a product query on the Products page for the products where you want to add the selected parameter to PRODUCTNAME (e.g., you want to add the Size parameter for the Clothing category, so you create a query containing all Clothing products). See our guide on how to work with product queries.
2. Go to the Rules page and click New rule.
3. Select Rewrite as the rule type.
4. Choose the product query to apply this rule to.
5. In the Element field, enter PRODUCTNAME (the element that will be modified by the rule).
6. In the New value field, enter all elements that should be included in PRODUCTNAME. Since each product has different values (different name/size/color), you need to mark these elements as variables by enclosing them with the "%" character.

Example:

Currently, PRODUCTNAME for a selected product contains “Nike t-shirt green.” You want it to read “Nike t-shirt green XL.” The size information is in the PARAM element, which contains PARAM_NAME (parameter name, e.g., size) and VAL (parameter value, e.g., XL).

In the New value field, enter:

%PRODUCTNAME% %PARAM{PARAM_NAME=“VELIKOST”} | VAL%

Mergado will understand that the new PRODUCTNAME value should contain the original value (%PRODUCTNAME%, e.g., Nike t-shirt green) plus the information from PARAM -> PARAM_NAME=“VELIKOST” -> VAL (e.g., XL).

7. Enter a rule name and click Create.

You can add other parameters similarly, such as material. It is important to verify that your feed actually contains the relevant values for the selected parameters; otherwise, Mergado will have nothing to draw from. Also make sure the path to the parameter value is written correctly so Mergado knows how to reach it.

More information and guides related to the PRODUCTNAME element.

CATEGORYTEXT#

CATEGORYTEXT is an element containing the full path to the correct product category according to Heureka’s catalog. It is another important element for correct product pairing. If Heureka cannot pair categories due to an incorrectly filled CATEGORYTEXT, it will not proceed to pair products into product cards, and your product will not be displayed on Heureka.

You need to provide the complete full path, ideally following Heureka’s category tree. In that case, Heureka will automatically pair the categories and proceed to pair products.

You can also use your own category names, but this will extend the pairing process and there is a risk that categories – and therefore products – will not be paired.

Example of a correctly filled CATEGORYTEXT (e.g., for a washing machine):

Heureka.cz | Large Appliances | Washers and Dryers | Washing Machines

Example of an incorrectly filled CATEGORYTEXT (e.g., for a washing machine):

Heureka.cz | Large Appliances | Washers and Dryers

How to Set Correct Categories According to Heureka’s Category Tree?#

Mergado loads and updates Heureka’s category tree data daily and makes assigning the correct categories much easier. You can easily set the correct categories using the Rename categories in bulk rule.

1. In the selected project, go to the Rules page and click New rule.
2. Select Rename categories in bulk as the rule type.
3. If you want to name categories according to Heureka’s tree for all products, choose All products. Alternatively, select or create a new product query.
4. To save time, click the Suggest categories button. Mergado will fill in your input feed categories on the left and assign corresponding Heureka tree categories on the right. Review and adjust Mergado’s suggestions as needed.

• Another option is to click the arrow next to Suggest categories and click Pre-fill left side, where Mergado fills in only your input feed categories and you manually assign the Heureka categories.
• Alternatively, you can fill in and assign categories on both sides manually. This is ideal if you only want to rename specific categories.
• Regardless of which option you choose, Mergado will suggest categories on both sides, so you do not need to look them up elsewhere.

5. If you do not want to review all categories, use the Show only filter to display only problematic rows (Conflicting rows, Invalid output categories, or Values missing on input).
6. Enter a rule name and click Create.

More details about the Rename categories in bulk rule.

More information and guides related to the CATEGORYTEXT element.

ITEM_ID#

ITEM_ID contains a unique product identifier and is a mandatory element of the Heureka feed. Without it, your products will not be displayed on Heureka. It allows Heureka to identify individual products for the Verified by Customers service or when you also connect an availability feed. If you change this code, products will be unpaired and a new pairing process will begin.

It can contain a maximum of 36 characters, using lowercase and uppercase letters without diacritics, numbers, hyphens, and underscores. Each product must have its own unique ITEM_ID. This element is not used for product pairing.

How to Add ITEM_ID If Your Feed Does Not Have It?#

If your feed does not contain the ITEM_ID element, or it exists but does not contain unique identifiers, you can easily create and fill it in Mergado.

A. The easiest way is to use the ITEM_ID from MERGADO_ID automation. This automation creates the ITEM_ID element and fills it with unique numeric codes. It can also be used if ITEM_ID already exists but needs to be filled with appropriate values.

1. In the selected project, go to the Automation page.
2. Click the ITEM_ID from MERGADO_ID automation.
3. No input is needed – Mergado automatically detects whether it needs to create the element or just fill it with values. Simply click Run automation.

B. Another option is to set up a Rewrite rule using the @MERGADO_ID variable. Mergado automatically creates this variable when the project is created, and it contains a unique number for each product.

1. In the selected project, go to the Rules page and click New rule.
2. Select Rewrite as the rule type.
3. Choose All products as the query.
4. On the left side, enter ITEM_ID (the element to fill).
5. On the right side, enter %@MERGADO_ID%. Remember that this is a variable (it contains a different value for each product), so it must be enclosed with the % character.
6. Enter a rule name and click Create.

Keep in mind that if you use @MERGADO_ID to fill ITEM_ID, the product IDs in the Heureka feed will not match the IDs sent to Heureka in the conversion measurement code. This means conversion measurement statistics will not pair correctly.

More information and guides related to the ITEM_ID element.

PRICE_VAT#

PRICE_VAT contains the final product price including VAT (and any copyright or recycling fees) and is a mandatory element of the Heureka feed. Without it, your products will not be displayed on Heureka.

Prices must be in CZK (or EUR for Slovak Heureka). The decimal separator can be a comma (,) or period (.), and thousands may or may not be separated by a space (both 25000 and 25 000 are valid). A maximum of two decimal places is allowed.

Enter only the numeric value in the element, without the currency symbol CZK or EUR.

How to Automatically Adjust Prices Based on Competition?#

For automatic pricing on your online store and Heureka, the Pricing Fox extension is ideal. Pricing Fox monitors competitors and ensures your product prices are attractive to customers while still profitable. It continuously evaluates the market and regularly reprices products according to your rules to protect margins and boost sales. You also get a complete overview of who your competitors are, how their prices and stock availability change over time, their bidding positions, gifts they offer, their manufacturers, and the categories they sell in.

More information and guides related to the PRICE_VAT element.

URL#

URL contains the link to the product in your online store where customers can add it to their cart and purchase it. This element is mandatory, and without it, your products will not be displayed on Heureka. Each product must have a unique URL, with a maximum length of 300 characters (enforceable with the Truncate value rule). Changing the URL will unpair the product and start a new category assignment process.

How to Differentiate URLs for Variants on the Same Online store Page?#

If a product has multiple variants, each variant must have its own unique URL. If your online store has product variants on a single page, you need to create a unique URL for each variant.

In Mergado, this can be solved by adding a # character to the end of the URL followed by a unique numeric code from the @MERGADO_ID system variable for each variant. You do not need to create this variable – Mergado creates it automatically when the project is set up, assigning each product a unique numeric code. This creates a unique link for each variant without affecting the link to the product page on your online store.

To create the rule:

1. First, create a product query on the Products page for products whose URL you want to modify – in this case, products with variants. See the guide on how to work with product queries.
2. Go to the Rules page and click New rule.
3. Select Rewrite as the rule type.
4. Choose the product query to apply this rule to.
5. In the Element field, enter URL.
6. In the New value field, enter:

%URL%#%@MERGADO_ID%

7. Enter a rule name and click Create.

This rule ensures each variant has a different numeric code after the # character and URLs will not be the same. The original URL functionality should not be affected (though it is good to verify), and Heureka’s requirement for unique addresses for each product will be met.

How to Add UTM Parameters to Product URLs?#

If you want to track how many customers come from Heureka, you will probably want to add UTM parameters to individual product URLs.

In Mergado, this is easily solved with the Set UTM parameters rule.

1. In the selected project, go to the Rules page and click New rule.
2. Select Set UTM parameters as the rule type.
3. Choose All products (or create a query for specific products).
4. Select URL as the Element.
5. Fill in the desired parameters.
6. Enter a rule name and click Create.

More information and guides related to the URL element.

DELIVERY#

DELIVERY is a “wrapper” that contains these elements:

• DELIVERY_ID (carrier identifier)
• DELIVERY_PRICE (shipping price for the carrier including VAT with prepayment)
• DELIVERY_PRICE_COD (shipping price for the carrier including VAT with cash on delivery)

The DELIVERY element repeats in the feed as many times as there are shipping methods available for your product. If you offer three shipping methods (e.g., PPL, Zasilkovna, Balikovna), DELIVERY will appear three times.

DELIVERY_ID and DELIVERY_PRICE are mandatory. DELIVERY_PRICE_COD is not required if the selected carrier does not support cash on delivery.

Heureka only allows specific carriers in the feed, listed in the specification on their website.

How to Add Carriers and Set Shipping Prices?#

Use the Set shipping rates rule to add carriers and set shipping prices.

1. In the selected project, first create [product queries](https://www.youtube.com/watch?v=pDjUNyKac88&list=PLz0Y8KFsHfJViZQOGuST7dWsgGnTtPtBY&index=6) on the Products page for products where you want to set carriers and shipping prices. For example, you may want different shipping prices based on product price or weight.

• You can easily create queries based on price tiers using the Segmentation into 5 price tiers automation. Similarly, the Segmentation by product weight automation creates queries based on product weight.
• If you want to set the same shipping price for all products, you do not need to create these queries.

2. Go to the Rules page and click New rule.
3. Select Set shipping rates as the rule type.
4. Choose the product query (e.g., a specific price tier or All products).
5. On the left side, fill in the selected carriers. Mergado will suggest carriers allowed by Heureka. You can also click Pre-fill left side and Mergado will fill in all carriers allowed by Heureka.
6. On the right side, enter the price for the selected carrier with prepayment (and optionally with cash on delivery if the carrier supports it).
7. Enter a rule name and click Create.

If you are setting different prices for different price tiers or weight groups, repeat this process and create a separate rule for each query.

How to Set Free Shipping for Some Products?#

1. In the selected project, first create a product query for products with free shipping (e.g., products priced above 2000 CZK).

2. Go to the Rules page and click New rule.

3. Select Set shipping rates as the rule type.

4. Choose the product query for free shipping.

5. On the left side, fill in the selected carriers. Mergado will suggest carriers allowed by Heureka. You can also click Pre-fill left side.

6. On the right side, enter zero: “0” in the price fields.

7. Enter a rule name and click Create.

How to Remove Some Carriers from the Feed?#

If you decide to remove a carrier, use the Set shipping rates rule.

1. In the selected project, go to the Rules page and click New rule.
2. Select Set shipping rates as the rule type.
3. Choose the product query from which you want to remove the carrier.
4. On the left side, enter the carrier you want to remove.
5. On the right side, leave the fields empty. (Do not enter zero, a hyphen, x, or any other characters. Leave the fields blank.)
6. Enter a rule name and click Create.

This removes the selected carrier from the feed, because Mergado does not include elements without values in the output feed.

More information and guides related to the DELIVERY element.

DELIVERY_DATE#

DELIVERY_DATE contains information about the product’s delivery time – the period from payment receipt (or order placement for cash on delivery) to product dispatch.

Enter a numeric value as a single number, not a range. For example, if the product will be dispatched in four days (or within four days), enter the number 4.

Heureka then displays these numeric values as text descriptions:

If the product will be in stock from a specific date and pre-orders are accepted, enter the date in DELIVERY_DATE in the format yyyy-mm-dd (e.g., 2025-03-25).

The easiest way to fill DELIVERY_DATE is with the Rewrite rule. For in-stock products, enter a value of zero: 0.

If the product is not in stock, you can easily hide it using the Hide product rule. You can also hide products with long delivery times, since customers will likely buy them where they are in stock. Advertising such products would be a waste of your budget.

How to Hide Products with Long Delivery Times or Unknown Availability?#

1. In the selected project, first create a product query on the Products page (e.g., products with DELIVERY_DATE greater than 10, or products with no value in DELIVERY_DATE because you do not know when they will be available).
2. Go to the Rules page and click New rule.
3. Select Hide product as the rule type.
4. Choose the product query to apply this rule to.
5. Enter a rule name and click Create.

However, the DELIVERY_DATE value in the product feed may not always be up to date. You can send an additional XML feed to Heureka – the availability feed (your online store system should generate it automatically). Heureka downloads this feed every ten minutes, and information from it takes priority over the main product feed (i.e., over DELIVERY_DATE). This ensures Heureka always has current availability information. You can find what Heureka’s availability feed should look like on their website. Read more about the availability feed.

More information and guides related to the DELIVERY_DATE element.

IMGURL#

IMGURL contains the URL of the main product image. The URL must not contain spaces or diacritics, and the same URL can be used for multiple products.

Basic product image requirements:

• Minimum image size is 20 x 50 pixels (or 50 x 20) and 30 kB. However, Heureka’s recommended size is at least 175 x 175 pixels, approximately 30,000 pixels.
• Maximum size is 4096 x 4096 pixels and 2000 kB.
• Image URL can be a maximum of 255 characters.
• Supported formats are webp, jpeg, png, bmp.
• Images must not contain watermarks, discount or bonus indicators, or award or product advantage badges.

You can easily check whether your product images meet Heureka’s requirements by running the [Image Audit](https://audit-obrazku.cz/).

How to Bulk-Adjust Image Dimensions According to Heureka’s Requirements?#

You can quickly, easily, and in bulk adjust image sizes, remove watermarks, and improve quality using the Feed Image Editor extension. More information and specific guides are available on this extension’s website.

More information and guides related to the IMGURL element.

ITEMGROUP_ID#

ITEMGROUP_ID is an element used to mark a group of products that are variants of one product. The group code can be up to 36 characters long, using underscores, hyphens, digits 0-9, and lowercase and uppercase letters without diacritics.

This variant marking is necessary because Heureka requires each product variant to be listed as a separate product in the feed.

All variants of one product are marked with a single shared code in the ITEMGROUP_ID element. Products are considered variants when they differ in size, color, pattern, or type.

Example: Your feed contains Adidas Superstar sneakers in sizes 36, 37, and 38. All three variants are marked with one shared code (e.g., ZD563) in the ITEMGROUP_ID element.

How to Add ITEMGROUP_ID Values If They Are Missing?#

There are several approaches depending on your feed type. One option is the Data file import rule, where you import the values in a separate file. If you need help, contact our technical support at mergado@mergado.com and we will work together to find a solution for your specific feed.

More information and guides related to the ITEMGROUP_ID element.

HEUREKA_CPC#

HEUREKA_CPC contains the maximum price you are willing to pay per click – bringing a customer from Heureka to your online store. Decimal places use a comma separator. The maximum possible click price is 1000 CZK.

If you do not want to bid (set a cost per click), leave the element empty (do not enter zero or any other character).

You can set an appropriate click price based on price tiers, dividing your assortment into queries by price. Then set a lower CPC for low-price, low-margin products to avoid losses, and a higher CPC for more expensive, higher-margin products.

How to Set Bidding for Heureka Based on Price Tiers?#

One way to set bidding in Mergado (and fill the HEUREKA_CPC element) is the Cost per click pricing rule.

1. First, create suitable product queries by price tiers.
2. On the Rules page, click New rule.
3. Select Cost per click pricing as the Rule type.
4. In the Queries field, choose the price tier for which you want to set the click price.
5. Choose whether to calculate the click price based on:

a. Minimum click price – The rule considers minimum click prices for products in each category (set by Heureka), and you can increase them by any amount in the Add to minimum CPC field.

b. Percentage of product price – Set the Percentage of product price you want to offer per click. For example, 1% of a 500 CZK product equals a 5 CZK click price.

6. Enter a Rule name.
7. Click Create.
8. Repeat for other price tiers and remember to apply the created rules.

You can also set CPC using the Bulk rewriting by queries rule, which lets you set CPC for multiple price tiers in one rule.

1. First, create suitable product queries by price tiers.
2. On the Rules page, click New rule.
3. Select Bulk rewriting by queries as the Rule type.
4. As the element to be rewritten, enter HEUREKA_CPC.
5. On the left side, fill in the queries – your created price tiers.
6. On the right side, enter the corresponding click price for each price tier.

• This rule does not calculate CPC using a formula like the Cost per click pricing rule. Here you need to enter the final CPC value you are willing to pay.

7. Enter a Rule name.

8. Click Create.

9. Remember to apply the rule.

How to Set Bidding Based on Margin, Category, Manufacturer, or Various Parameters?#

By margin#

You do not have to set click prices only based on price tiers. You can set CPC by margin, dividing the assortment into queries based on margin level. This requires having a margin element in your feed. Then use the Cost per click pricing or Bulk rewriting by queries rule.

By categories, manufacturer, or various parameters#

Another option is setting CPC by categories, manufacturer, or parameters like material. The easiest approach is the Bulk rewriting by values rule.

1. On the Rules page, click New rule.
2. Select Bulk rewriting by values as the Rule type.
3. Choose the product query or All products.
4. On the left side, in the Element to search in field, enter the element you want to base CPC on.

• For categories, choose CATEGORYTEXT.
• For manufacturer, choose MANUFACTURER.

5. On the right side, in the Element to write to field, enter HEUREKA_CPC.
6. Then fill in the values of the chosen element on the left and the corresponding CPC value on the right.

• For categories, enter individual categories (e.g., t-shirts, shirts, pants, etc.) with their click prices.
• For manufacturers, enter individual manufacturers (e.g., Adidas, Nike, Reebok, etc.) with their click prices.

7. Enter a Rule name.
8. Click Create.
9. Remember to apply the rule.

How to Set Up Automatic Bidding So HEUREKA_CPC Adjusts Itself?#

For automatic bidding, the Bidding Fox extension is ideal. It analyzes the sales potential of products and dynamically manages their advertising for maximum visibility. For items with low potential, it reduces advertising to save your credit. It adjusts bidding several times a day based on the latest data it verifies directly on Heureka. It also lets you monitor your competitors’ CPC and adjust advertising based on that information.

More information and guides related to the HEUREKA_CPC element can be found here.

EAN#

EAN contains a code identifying individual products. Its entry is mandatory for the categories Books, Textbooks, Maps and Guides, Movies, Music, and Comics. For other categories, it is not mandatory but is recommended for all products.

Unlike ITEM_ID, these are not arbitrary codes you can assign to your products. They are official, so-called barcodes. Heureka supports the EAN-13 format.

Although Heureka does not pair products into product cards based on EAN codes, the Unpaired products report works with EAN codes. If you send EANs to Heureka, it will look up unpaired products by EAN and recommend the correct name and category for pairing.

The unpaired products report is available in your shop’s Heureka administration under the Product pairing tab. It is available only for online stores in PPC mode, and Heureka generates it once a day.

If you have correctly filled EAN codes and do not want to spend time manually pairing products, use the Pairing Bear extension. It automatically pairs your products with product cards on Heureka based on EANs and offers intelligent recommendations for items that cannot be paired.

How to Find Products with Invalid EAN?#

You can easily find products with invalid EAN using the Find products with invalid EAN automation.

1. In the selected project, click the Automation tab.
2. Click the automation called Find products with invalid EAN.
3. The automation has EAN pre-set as the EAN code element. Leave it as is.
4. Click Run automation.

The automation saves products with invalid EAN into a query called “Products with invalid EAN”. You can then fix the codes or temporarily hide these products (Hide product rule) until the EANs are corrected.

How to Find Products with Missing EAN?#

You can find products with missing EAN by creating a query.

1. On the Products page, select the Simple interface option.
2. For Search products, choose on input.
3. In the search field, type EAN and then choose is empty.
4. Click Search.
5. All products with a missing EAN will be displayed.
6. Enter a query name (e.g., Products with missing EAN).
7. Click Save.

On the same page, click the Saved queries tab to find this query. Try to fill in the EAN as soon as possible.

More information and guides related to the EAN element.

OTHER HEUREKA ELEMENTS#

Information about other Heureka feed elements is available on our forum:

SHOP, SHOPITEM, PRODUCT, DESCRIPTION, IMGURL_ALTERNATIVE, VAT, ITEM_TYPE, PARAM, MANUFACTURER, ISBN, ACCESSORY, GIFT, EXTENDED_WARRANTY, SPECIAL_SERVICE, and SALES_VOUCHER.

FAQ#

Why does Heureka not display or reject some products?#

Most often, it is because of missing or incorrectly filled elements in your product XML feed. Heureka has specific requirements for what a product feed should look like, and incorrectly filled elements prevent pairing into product cards. Mergado offers a free Feed Audit that you can run at any time to detect errors and get immediate fix recommendations.

How does Mergado help with product pairing on Heureka?#

Mergado converts your input feed structure into Heureka’s format and lets you use rules and automations to bulk-fix or add element values to match Heureka’s requirements. Mergado handles fixes in bulk and automatically, so you do not need to correct each product manually.

Which elements are essential for correct pairing and product display on Heureka?#

The most essential elements for correct product pairing are PRODUCTNAME (mandatory, containing the exact product name) and CATEGORYTEXT (containing the full path to the correct product category from Heureka’s tree). Additional mandatory elements without which your product will not be displayed are ITEM_ID (unique and permanent product identifier), PRICE_VAT (final product price with VAT), and URL (unique product URL in your online store). Also important are DELIVERY (carriers and shipping prices), DELIVERY_DATE (days until dispatch), IMGURL (main product image URL), ITEMGROUP_ID (variant identifier), HEUREKA_CPC (maximum CPC if bidding), and EAN (product barcode, mandatory for selected categories).

What must the PRODUCTNAME element contain?#

PRODUCTNAME is a mandatory Heureka feed element. It is essential for correct product pairing and must contain the exact product name. Each product category has a specific format specification. For example, for Men’s socks, the mandatory data are Brand | Line | Color | Size. Mandatory data for each category and example names are on Heureka’s website.

How do I bulk-add manufacturers to product names?#

The easiest way is the Add producer to product title automation.

1. In the selected project, click the Automation tab.
2. Click the automation called Add producer to product title.
3. Fill in the Manufacturer element name (e.g., MANUFACTURER).
4. Fill in the Product name element name (e.g., PRODUCTNAME).
5. As the Output product name element, enter PRODUCTNAME.
6. Click Run automation.

How do I bulk-add size, material, or other information to product names?#

The easiest way is the Rewrite rule.

1. First, create a product query on the Products page for the products to modify.
2. Go to the Rules page and click New rule.
3. Select Rewrite as the rule type.
4. Choose the product query.
5. In the Element field, enter PRODUCTNAME.
6. In the New value field, enter all elements that should be in PRODUCTNAME. Mark them as variables with the “%” character. Separate individual variables with a space.

Example: PRODUCTNAME currently contains “Nike t-shirt green.” You want it to read “Nike t-shirt green XL.” The size is in the PARAM element with PARAM_NAME and VAL.

In the New value field, enter:

%PRODUCTNAME% %PARAM{PARAM_NAME=“VELIKOST”} | VAL%

Mergado will combine the original name with the size value (e.g., XL).

7. Enter a rule name and click Create.

How do I correctly fill the CATEGORYTEXT element?#

CATEGORYTEXT must contain the full path to the correct product category from Heureka’s category tree. If filled incorrectly, Heureka will not pair categories and will not proceed to pair products. A correct path looks like: Heureka.cz | Large Appliances | Washers and Dryers | Washing Machines.

How do I bulk-set correct categories from Heureka’s category tree?#

The Rename categories in bulk rule is ideal.

1. Go to the Rules page and click New rule.
2. Select Rename categories in bulk as the rule type.
3. Choose All products or create a new product query.
4. Click Suggest categories. Mergado fills in your input feed categories on the left and assigns Heureka tree categories on the right. Review and adjust.
5. Enter a rule name and click Create.

How do I add ITEM_ID if my feed does not have it?#

ITEM_ID is a mandatory element. If your feed lacks it, use the ITEM_ID from MERGADO_ID automation. It creates the element and fills it with unique codes. Simply go to the Automation page, click the automation, and click Run automation.

How do I automatically change prices on Heureka based on competition?#

The Pricing Fox extension is ideal for automatic pricing. It fills the PRICE_VAT element based on your rules and current competitor data, keeping your prices attractive yet profitable.

Must each product in the Heureka feed have a unique URL?#

Yes. Each product must have a different URL in the feed leading to the product page in your online store. Each variant must also have a unique URL. See the instructions above for setting different URLs for variants.

How do I differentiate variant URLs that share one online store page?#

If variants share one page, create a unique URL for each by appending # followed by a unique code from the @MERGADO_ID system variable. Use the Rewrite rule with the value: %URL%#%@MERGADO_ID%

How do I find out how many customers come from Heureka?#

Check Google Analytics for this information. For more detailed tracking, add UTM parameters to product URLs using the Set UTM parameters rule.

How do I add carriers and set shipping prices for the Heureka feed?#

Use the Set shipping rates rule. Create product queries if needed, add carriers (Mergado suggests Heureka-allowed carriers), and set prices for prepaid and cash-on-delivery shipping.

How do I set free shipping for some products?#

Create a product query for products eligible for free shipping (e.g., products above 2000 CZK), then use the Set shipping rates rule with a price of zero.

How do I remove carriers from the Heureka feed?#

Use the Set shipping rates rule, enter the carrier to remove on the left, and leave the right side empty. Mergado does not include empty elements in the output feed.

How do I mark in-stock products in the Heureka feed?#

For in-stock products, enter a value of zero in the DELIVERY_DATE element.

How do I hide products with long delivery times from Heureka advertising?#

Create a product query for products with long delivery times (e.g., DELIVERY_DATE > 10), then use the Hide product rule.

How do I ensure Heureka always has current availability and stock information?#

The most reliable source is the availability feed, which your online store system should generate automatically. Heureka downloads it every ten minutes, and it takes priority over the main product feed. Make sure ITEM_ID values match between the product and availability feeds. Details on Heureka’s availability feed format are on their website.

What image dimensions does Heureka require?#

Minimum recommended: 175 x 175 pixels (approximately 30,000 pixels). Maximum: 4096 x 4096 pixels and 2000 kB. Check your images for free with Image Audit. Adjust dimensions and quality in bulk with Feed Image Editor.

Can product images on Heureka contain watermarks?#

No. Images must not contain watermarks, discounts, bonuses, or award badges. Check with Image Audit and remove them using Feed Image Editor.

How do I mark all variants of a product in the Heureka feed?#

Heureka requires each variant to be listed as a separate product with a shared identifier in the ITEMGROUP_ID element.

How do I add ITEMGROUP_ID values if they are missing from my input feed?#

There are several approaches depending on your feed type. One option is the Data file import rule. If you need help, contact our technical support at mergado@mergado.com.

How do I set CPC (cost per click) for Heureka?#

Use the Cost per click pricing rule. Create product queries, choose the rule type, select the price tier, and choose between minimum click price or percentage of product price calculations.

The HEUREKA_CPC element is automatically filled by this rule. You can also use Bulk rewriting by queries or Bulk rewriting by values.

How do I set up automatic bidding on Heureka?#

The Bidding Fox extension is ideal. It analyzes product sales potential and dynamically manages advertising. It requires a Heureka connection through Mergado Keychain.

Is EAN (barcode) mandatory for products advertised on Heureka?#

It is mandatory for Books, Textbooks, Maps and Guides, Movies, Music, and Comics. For other categories, it is not mandatory but recommended for all products.

How do I find products with invalid or missing EANs?#

For invalid EANs, use the Find products with invalid EAN automation. For missing EANs, create a product query where the EAN element “is empty.”

How do I simplify product pairing for Heureka in Mergado?#

Use the Pairing Bear extension. It automatically pairs products by EAN and suggests adjustments for unpaired items, such as product name (PRODUCTNAME) or category (CATEGORYTEXT) changes.