Finds a group of items that are valued highest according to the parameter MIN-ATTRIBUTE
, and then returns the value of RETURN-ATTRIBUTE
associated with that item.
Syntax
any_with_min(RETURN-ATTRIBUTE, MIN-ATTRIBUTE)
Learn more about syntax for functions.
Parameters
RETURN-ATTRIBUTE
: Any type of standard attribute or custom attribute (number, text, or other types). The function returns the value of this attribute for one of the selected items.MIN-ATTRIBUTE
: Any type of standard attribute or custom attribute (number, text, or other types), though typically you specify numeric or monetary attribute. The function selects all items that share the lowest value of this attribute.
If you specify a text attribute, the function sorts by lexicographic order and selects items at the beginning of the sort list.
Learn more about referring to inventory attributes.
Example
An ad group that's scoped to the "MyBrand" brand contains the following items:
BRAND | TITLE | PRICE | DISCOUNT |
---|---|---|---|
MyBrand | Red shoes | $10.00 | 10% |
MyBrand | Yellow shoes | $10.00 | 10% |
MyBrand | Blue shoes | $10.00 | 5% |
MyBrand | Crew socks | $5.00 | 20% |
MyBrand | Dress socks | $5.00 | 20% |
MyBrand | Knee-high socks | $5.00 | 15% |
In an ad template,
[any_with_min(TITLE, PRICE)]
does the following:
- Scans the PRICE column and finds the items that share the lowest price.
In this case, the function selects "Crew socks", "Dress socks", and "Knee-high socks" (which all specify a price of $5). - Returns the value of the TITLE attribute for one of those items. That is, the function returns either "Crew socks", "Dress socks", or "Knee-high socks".