Additional Properties

Additional niches properties of products allow studying user preferences and calculating recommendations more accurately. This section describes allowing filling the product feed with jewelry niche features.

Jewelry

The "jewelry" element must be inside the "offer" element.

<offer ...>
    ...
    <jewelry>
        ...
    </jewelry>
</offer>

Gender

The "gender" element must be inside the "jewelry" element and can have one of the following values:

Value	Description
m	For men's products
f	For women's products

If the product is equally suitable for either gender, there is no need to add this element.

<offer ...>
	...
	<jewelry>
		<gender>f</gender>
	</jewelry>
</offer>

Ring Size

The "ring_size" elements must be inside the "ring_sizes" element of the "jewelry" element.

Don't use this element for products that are not rings.

<offer ...>
    ...
	<jewelry>
	    <ring_sizes>
			<ring_size>16</ring_size>
			<ring_size>16.5</ring_size>
			<ring_size>17</ring_size>
		</ring_sizes>
	</jewelry>
</offer>

Bracelet Size

The "bracelet_size" elements must be inside the "bracelet_sizes" element of the "jewelry" element.

Don't use this element for products that are not bracelets.

<offer ...>
    ...
	<jewelry>
	    <bracelet_sizes>
			<bracelet_size>16</bracelet_size>
			<bracelet_size>16.5</bracelet_size>
			<bracelet_size>17</bracelet_size>
		</bracelet_sizes>
	</jewelry>
</offer>

Necklace Size

Optional parameter <chain_sizes>. Contains the full list of available sizes for the given SKU (i.e necklace). The size is measured in centimeters and is the circumference length. You should list all the available sizes for each given SKU. Use a dot as the decimal mark.

NOTE

Don't use this parameter for the SKUs that are not necklaces or don't come in different sizes.

XML example

 ...
<offer ...>
    ...
	<jewelry>
	    <gender>f</gender>
	    <chain_sizes>
			<chain_size>16</chain_size>
			<chain_size>16.5</chain_size>
			<chain_size>17</chain_size>
		</chain_sizes>
	</jewelry>
</offer>
...

Item Color

Optional parameter <jewelry_color>. Sent as a string with one of the parameters from the table below.

NOTE

Don't use this parameter if the item color is different from the table or it is a multi-color item.

Color	Value
White (silver or metallic gray) color	white
Red color	red
Yellow color	yellow
Black color	black

XML example

 ...
<offer ...>
    ...
	<jewelry>
	    <gender>f</gender>
		<jewelry_color>white</jewelry_color>
	</jewelry>
</offer>
...

Metal Type

Optional parameter <jewelry_metal>. Sent as a string with one of the parameters from the table below.

NOTE

Don't use this parameter if the metal type is different from the table.

Metal type	Value
Gold	gold
Silver	silver
Platinum	platinum

XML example

 ...
<offer ...>
    ...
	<jewelry>
	    <gender>f</gender>
		<jewelry_metal>silver</jewelry_metal>
	</jewelry>
</offer>
...

Gemstone Type

Optional parameter <jewelry_gem>. Sent as a string with one of the parameters from the table below.

NOTE

Don't use this parameter if the gemstone type is different from the table.

Gemstone type	Value
Agate	agate
Alexandrite	alexandrite
Rhinestone (Swarovski, Preciosa)	swarkovski
Amethyst	amethyst
Turquoise	turquoise
Diamond	diamond
Garnet	garnet
Synthetic garnet	garnet_synthetic
Pearl	pearl
Emerald	emerald
Synthetic emerald	emerald_geothermal
Quartz	quartz
Morion (smoky quartz)	quartz_smoky
Coral	coral
Corundum	corundum
Synthetic corundum	corundum_synthetic
Malachite (mountain green)	malachite
Nanocrystal	nanocrystal
Onyx	onyx
Nacre	nacre
Rhodolite	rhodolite
Ruby	ruby
Synthetic ruby	ruby_synthetic
Sapphire	sapphire
Synthetic sapphire	sapphire_geothermal
Sitall	sitall
Glass	glass
Topaz	topaz
Tourmaline	tourmaline
Fianite (a.k.a Fianit)	fianit
Chalcedony	chalcedony
Olivine (chrysolite, peridot)	chrysolite
Сhrysoprase	chrysoprase
Сitrine (yellow quartz)	citrine
Spinel	spinel
Synthetic spinel	spinel_synthetic
Amber	amber
Mix of stones	mix

XML example

 ...
<offer ...>
    ...
	<jewelry>
	    <gender>f</gender>
		<jewelry_gem>rubin</jewelry_gem>
	</jewelry>
</offer>
...