Element PARAM#

Basic information#

The PARAM element is a wrapper for:

• PARAM_NAME (the parameter name) and
• VAL (the parameter value).

These three elements are used to specify product parameters. The number of PARAM blocks in the feed matches the number of parameters the product has.

Parameters are used on Heureka to filter products within a category.

• PARAM element specification on the Heureka website

Note: for some products, the mandatory parameters must also be present in the product name, in the PRODUCTNAME element.

• List of mandatory Heureka parameters

Frequently asked questions#

• How do I add parameters (colour, size, dimensions, volume…) to products in the feed?
  • Use the Set product parameters rule, which lets you add parameters in bulk for different groups of products (different queries).
• How do I remove specific parameters?
  • Use the Remove parameter values rule. You can either remove only certain values of a specific parameter (for example just certain colours from the Colour parameter), or remove all values — so the parameter is deleted entirely and will not appear in any product in the output feed.
• How do I rename a parameter or its value?
  • Use the Find and replace rule to easily change a parameter name or value.
    • To rename a parameter, use the following path in the rule: PARAM | PARAM_NAME
    • To change a parameter value, use the path: PARAM | VAL
• How do I add mandatory parameters to the product name?
  • First, create product queries on the Products page, which you will then use in rules. A query should contain the group of products that need to include a specific mandatory parameter in their names but currently do not. For example, you can create a query for clothing that must contain the Size parameter in the name. Then use the query in the Rewrite rule to add the mandatory parameters to the product name.

Example: Adding the value from the Size parameter to PRODUCTNAME

1. On the Products page, create a product query where the Size parameter is not empty (i.e. filter only products for which the Size parameter exists).

2. On the Rules page, create a new rule:

• Select Rewrite as the rule type.
• Select the product query you created in step 1.
• Choose PRODUCTNAME as the element whose value you want to rewrite.
• In the new value field, enter variables that combine the original product name and the size parameter value. Variables in Mergado are written with a % sign at the beginning and end, so for example the new value field might contain:

%PRODUCTNAME% %PARAM { PARAM_NAME = "SIZE" } | VAL %

Note: this notation may vary if the parameter elements have different names. Once you type the opening % sign, variable suggestions will appear and you can select from the list.

When rules are applied to the feed, the product name (part: %PRODUCTNAME%) and the value from its size parameter (part: %PARAM { PARAM_NAME = "SIZE" } | VAL %) are combined for each product.

• How do I copy parameters and their values from another element, for example from g:product_detail?
  • Use the Bulk copy values rule, which can copy the entire element structure including parameters.
  • To copy the entire structure, enter all paths to the elements belonging to the copied structure, one per line — starting from the least nested element (the “wrapper”) to the most deeply nested.
  • Example of how to configure the copy rule to copy all parameters and their values while preserving the element structure:

    Source		Target
    g:product_detail	->	PARAM
    g:product_detail | g:attribute_name	->	PARAM | PARAM_NAME
    g:product_detail | g:attribute_value	->	PARAM | VAL

What Mergado Audit checks for the PARAM element#

• Whether PARAM_NAME or VAL is missing under the PARAM element — i.e. whether the structure of these elements in the feed is correct.
• Whether the PARAM_NAME and VAL sub-elements contain any invalid value (for example links, or semicolons in VAL values).
• Whether the value in PARAM_NAME is unique — i.e. whether a product has parameters with duplicate names. Duplicate parameter names risk Heureka processing only the first parameter and ignoring subsequent values with the same name.
• Whether the VAL sub-element appears more than once per parameter — it should appear exactly once for each parameter.
• The audit also flags when a product in the feed is missing mandatory parameters for its category.

If you need help, contact our technical support.