unit_pricing_measureattribute to define the measure and dimension of your product. This value allows users to understand the exact cost per unit for your product.
When to use
Optional for each product
If users might be interested in price per unit for your product and it falls into one of the following categories, then we recommend that you submit
unit_pricing_measure attribute is optional, but you may be required to provide this information based on local laws or regulations. For example, if your products target any of the EU member states or Switzerland, please consider the legal requirements on this matter defined in the national implementation acts of the EU directive 2010/30/EU and any other applicable local law.
Some products that often use this attribute:
- Office Supplies
- Tobacco categories
- Business Cards
Follow these formatting guidelines to make sure we understand the data you're submitting.
|Type||Positive number plus unit|
|Schema.org property (What’s this?)||Offer.priceSpecification.referenceQuantity, Type: QuantitativeValue|
|File format||Example entry|
|Content API v2 (JSON)||
|Content API v2 (XML)||
Follow these guidelines to make sure you submit high-quality data for your products and get the best performance from your ads.
These are the requirements you'll need to meet to show ads for your product. If you don't follow these requirements, we'll disapprove your product and let you know in the Diagnostics page of your Merchant Center account.
- Submit the total amount (number) and units that make up your product. For example, if you submit 3 USD for
price, 150 floz for
unit_pricing_measure, and 100 floz for
unit_pricing_base_measure. The unit price would be 2 USD / 100 floz.
unit_pricing_base_measureto include the denominator for your unit price. This attribute is useful when products like yours are typically shown as the price for a specific number of units. For example, you might be selling 150ml of a specific perfume, but users are interested in seeing the price per 100ml.
- Submit a price that can be represented in your country of sale’s currency (according to ISO 4217). For example, instead of 1.0012 USD, submit 1.01 USD. If your price can’t be represented in your country of sale’s currency, then we’ll round it to a value that can.
- Submit either the
energy_efficiency_classattribute. Do not submit both. If both attributes are present, only
energy_efficiency_classwill be shown.
- Don't provide more than 2 digits after a decimal. If you include more than 2 digits after the decimal, they'll automatically be rounded to the nearest acceptable value. For example, 1.0234 will be rounded to 1.02 and 29.8999 will be rounded to 29.90.
Review each section closely to determine if the requirements apply to your country or product. If you don't follow requirements that apply to you, we'll disapprove your product and let you know in the Diagnostics page of your Merchant Center account.
- Submit metric values when targeting the UK. The imperial units (e.g.,
gal) are interpreted as US imperial units, which are different than the imperial units used in the UK.
||Pinot Noir - 2007 - California - 9l|
|Shown in your ad||€7,78 / 1 l|
|Product||10 bottles of red wine|
||10 Bottles of Red Wine|
|Shown in your ad||$6.50 / 750 ml|
||Distressed Natural Walnut Flooring|
|Shown in your ad||€47,56 / 1 m²|
||50 custom made business cards|
|Shown in your ad||€0,27 / 1 ct|
||Eau de Toilette 125 ml|
|Shown in your ad||€15,92 / 100 ml|