unit_pricing_measure [unit_pricing_measure]: Definition

 

Use the unit_pricing_measure [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.

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 [unit_pricing_measure].

The unit_pricing_measure [unit_pricing_measure] attribute is optional, but you may be required to provide this information based on local laws or regulations.

Examples of products that often use this attribute are as follows:

• Hardware
• Office supplies
• Food
• Drinks
• Flooring
• Business cards
• Perfume

Format

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

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

 

File format	Example entry
Text	750 ml
XML feeds	<g:unit_pricing_measure>750ml</g:unit_pricing_measure>

To format your data for Content API, have a look at the Content API for Shopping.

Guidelines

Follow these guidelines to make sure that you submit high-quality data for your products.

Minimum requirements

These are the requirements that you'll need to meet to show your product. If you don't follow these requirements, we'll disapprove your product and let you know on 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 GBP for price [price], 150 ml for unit_pricing_measure [unit_pricing_measure] and 100 ml for unit_pricing_base_measure [unit_pricing_base_measure]. The unit price would be 2 GBP/100 ml.
• Submit unit_pricing_base_measure [unit_pricing_base_measure] to include the denominator for your unit price. This attribute is useful when products like yours are typically shown with a price for a specific number of units. For example, you might be selling 150 ml of a specific perfume, but users are interested in seeing the price per 100 ml.
• Submit a price that can be represented in your country of sale's currency (according to ISO 4217). For example, instead of 1.0012 GBP, submit 1.01 GBP. 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 [unit_pricing_measure] or energy_efficiency_class [energy_efficiency_class] attribute. Do not submit both. If both attributes are present, only energy_efficiency_class [energy_efficiency_class] will be shown.
• Don't provide more than two digits after a decimal. If you include more than two 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.

Additional guidelines

Review each section closely to determine whether 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 Diagnostics in your Merchant Center account.

United Kingdom only

• Submit metric values when targeting the UK. The imperial units (e.g. fl oz, pt, qt, gal) are interpreted as US imperial units, which are different from the imperial units used in the UK.

Examples

Drinks

Product	Red wine
title [title]	Pinot Noir – 2007 – California – 9 L
unit_pricing_measure [unit_pricing_measure]	9 L
unit_pricing_base_measure [unit_pricing_base_measure]	1 L
price [price]	69.99 GBP
Displayed value	£7.78/1 L

 

Product	10 bottles of red wine
title [title]	10 bottles of red wine
unit_pricing_measure [unit_pricing_measure]	7.5 L
unit_pricing_base_measure [unit_pricing_base_measure]	750 ml
price [price]	65.00 GBP
Displayed value	£6.50/750 ml

Flooring

Product	Walnut flooring
title [title]	Distressed natural walnut flooring
unit_pricing_measure [unit_pricing_measure]	2.38 sq m
unit_pricing_base_measure [unit_pricing_base_measure]	1 sq m
price [price]	113.19 GBP
Displayed value	£47.56/1 m²

Business cards

Product	Business cards
title [title]	50 custom-made business cards
unit_pricing_measure [unit_pricing_measure]	50 ct
unit_pricing_base_measure [unit_pricing_base_measure]	1 ct
price [price]	13.38 GBP
Displayed value	£0.27/1 ct

Perfume

Product	Perfume
title [title]	Eau de toilette 125 ml
unit_pricing_measure [unit_pricing_measure]	125 ml
unit_pricing_base_measure [unit_pricing_base_measure]	100 ml
price [price]	19.90 GBP
Displayed value	£15.92/100 ml

Variants

If your product comes in multiple unit price variants (e.g. 1.1 kg, 2.7 kg, etc.). Submit each variant as a separate product, but use the same value for the item_group_id [item_group_id] attribute.

Product	Basmati rice
title [title]	Basmati rice – extra long grain
id	575185159
item group id [item_group_id]	12345
price [price]	£11.20
unit_pricing_measure [unit_pricing_measure]	2.25 kg
unit_pricing_base_measure [unit_pricing_base_measure]	0.45 kg

 

Product	Basmati rice
title [title]	Basmati rice – extra long grain
id	575185160
item_group_id [item_group_id]	12345
price [price]	£19.90
unit_pricing _measure [unit_pricing_measure]	4.5 kg
unit_pricing_base_measure [unit_pricing_base_measure]	0.45 kg

 

Product	Basmati rice
title [title]	Basmati rice – extra long grain
id	575185161
item_group_id [item_group_id]	12345
price [price]	£24.40
unit_pricing_measure [unit_pricing_measure]	5.5 kg
unit_pricing_base_measure [unit_pricing_base_measure]	0.45 kg