unit_pricing_measure: Definition

 
Use the unit_pricing_measure attribute to define the measure and dimension of your product. This value allows users to understand the exact cost per unit for your product.

How unit_pricing_measure might display in your ad

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.

The 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:

  • Hardware
  • Office Supplies
  • Food
  • Beverages
  • Tobacco categories
  • Flooring
  • Business Cards
  • Perfume

Format

Follow these formatting guidelines to make sure we understand the data you're submitting. 

Type Positive number plus unit
Supported units
  • Weight: oz, lb, mg, g, kg
  • Volume (US imperial): floz, pt, qt, gal
  • Volume (metric): ml, cl, l, cbm
  • Length: in, ft, yd, cm, m
  • Area: sqft, sqm
  • Per unit: ct

Repeated field No
Schema.org property (What’s this?) Offer.priceSpecification.referenceQuantity, Type: QuantitativeValue
 
File format Example entry
Text

750ml

XML feeds <g:unit_pricing_measure>750ml</g:unit_pricing_measure>
Content API v2 (JSON)

"unitPricingMeasure": {

  "value": 750,

  "unit": "ml"

}

Content API v2 (XML) <unit_pricing_measure>750ml</unit_pricing_measure>

Guidelines

Follow these guidelines to make sure you submit high-quality data for your products and get the best performance from your ads.

Minimum requirements

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. 

  • There are no minimum requirements for this attribute. Keep in mind that you still need to follow the formatting guidelines or the information you submit can't be used.

Best practices

These are best practices that can help you go beyond the basic requirements to optimize your product data for performance. 

  • 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.
  • Submit unit_pricing_base_measure to 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 unit_pricing_measure or energy_efficiency_class attribute. Do not submit both. If both attributes are present, only energy_efficiency_class will be shown.

Additional guidelines

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.

United Kingdom only
  • Submit metric values when targeting the UK. The imperial units (e.g., floz, pt, qt, gal) are interpreted as US imperial units, which are different than the imperial units used in the UK.

Examples

Beverages
Product Red Wine
title Pinot Noir - 2007 - California - 9l
unit_pricing_measure 9 l
unit_pricing_base_measure 1 l
price 69.99 EUR
Shown in your ad €7,78 / 1 l

 

Product 10 bottles of red wine
title 10 Bottles of Red Wine
unit_pricing_measure 7.5 l
unit_pricing_base_measure 750 ml
price 65.00 USD
Shown in your ad $6.50 / 750 ml
Flooring
Product Walnut flooring
title Distressed Natural Walnut Flooring
unit_pricing_measure 2.38 sqm
unit_pricing_base_measure 1 sqm
price 113.19 EUR
Shown in your ad €47,56 / 1 m²
Business cards
Product Business cards
title 50 custom made business cards
unit_pricing_measure 50 ct
unit_pricing_base_measure 1 ct
price 13.38 EUR
Shown in your ad €0,27 / 1 ct
Perfume
Product Perfume
title Eau de Toilette 125 ml
unit_pricing_measure 125 ml
unit_pricing_base_measure 100 ml
price 19.90 EUR
Shown in your ad €15,92 / 100 ml
 
Was this article helpful?
How can we improve it?