Returns the number of items with the highest value for a specified attribute.
Note: This function is only available in Templates and can’t be used in Reporting.
Syntax
count_with_max(value, order_value)
Parameters
value: Any type of attribute or column (number, text, or boolean). The function returns the highest value of this attribute for one of the selected items.order_value: Any type of standard attribute or custom attribute (number, text, or boolean), though typically you specify numeric or monetary attribute. The function selects all items that share the highest value of this attribute.
If you specify a text attribute, the function sorts by lexicographic order and selects items at the end of the sort list.
Learn more About custom columns in templates.
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,
[count_with_max(DISCOUNT, PRICE)]does the following:
- Scans the
PRICEcolumn and finds the items that share the highest price.
In this case, the function selects "Red shoes", "Yellow shoes", and "Blue shoes" (which all specify a price of $10). - Scans the
DISCOUNTcolumn for "Red shoes", "Yellow shoes", and "Blue shoes" and returns the number of items that share the highest discount.
In this example, the function returns 2 ("Red shoes" and "Yellow shoes" both specify a 10% discount).
- In an ad template,
[count_with_max(TITLE, PRICE)]returns 1, since all items with the highest price have unique titles.