Versions Compared

Old Version 4

changes.mady.by.user Andrey Veprikov

Saved on

compared with

New Version 5

changes.mady.by.user Andrey Veprikov

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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.

Code Block
languagexml
themeMidnight
<offer ...>
    ...
    <jewelry>
        ...
    </jewelry>
</offer>

Gender

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

ValueDescription
mFor men's products
fFor women's products

Tip

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


Code Block
languagexml
themeMidnight
<offer ...>
	...
	<jewelry>
		<gender>f</gender>
	</jewelry>
</offer>

Ring Size

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

Warning

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


Code Block
languagexml
themeMidnight
<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.

Warning

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


Code Block
languagexml
themeMidnight
<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.

Tip
titleNOTE

The "chain_size" elements must be inside the "chain_sizes" element of the "jewelry" element.

Warning

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


 ...
Code Block
languagexml
titlethemeXML example
Midnight
<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.

Tip
titleNOTE

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

ColorValue

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

ValueDescription
whiteWhite (silver or metallic gray) color
white
redRed color
red
yellowYellow color
yellow
blackBlack color
black

Tip
titleNOTE

Don't use this element for products in other colors or multicolors.


 ...
Code Block
languagexml
titlethemeXML example
Midnight
<offer ...>
    ...
	<jewelry>
	    <gender>f</gender>
		<jewelry_color>white<color>red</jewelry_color>
	</jewelry>
</offer>
...

Metal

Type

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

TiptitleNOTE

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

ValueDescription
goldGold Jewelry
silverSilver Jewelry
platinumPlatinum Jewelry

Warning

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

Metal typeValueGoldgoldSilversilverPlatinumplatinum

element for products with a different type of metal or products with more than one type of metal.


 ...
Code Block
languagexml
titlethemeXML example
Midnight
<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.  

Tip
titleNOTE

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

Gemstone typeValue

Agate

agate

Alexandrite

alexandrite

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

ValueDescription

agate

Agate

alexandrite

Alexandrite

swarkovski

Rhinestone (Swarovski, Preciosa)

swarkovski

amethyst

Amethyst

amethyst

turquoise

Turquoise

turquoise

diamond

Diamond

diamond

garnet

Garnet

garnet_synthetic

Synthetic garnet

garnet_synthetic

pearl

Pearl

pearl

emerald

Emerald

emerald_geothermal

Synthetic emerald

emerald_geothermal

quartz

Quartz

quartz_smoky

Morion (smoky quartz)

quartz_smoky

coral

Coral

coral

corundum

Corundum

corundum_synthetic

Synthetic corundum

corundum_synthetic

malachite

Malachite (mountain green)

malachite

nanocrystal

Nanocrystal

nanocrystal

onyx

Onyx

onyx

nacre

Nacre

nacre

rhodolite

Rhodolite

rhodolite

ruby

Ruby

ruby_synthetic

Synthetic ruby

ruby_synthetic

sapphire

Sapphire

sapphire_geothermal

Synthetic sapphire

sapphire_geothermal

sitall

Sitall

sitall

glass

Glass

glass

topaz

Topaz
topaz

tourmaline

Tourmaline

tourmaline

fianit

Fianite (a.k.a Fianit)
fianit

chalcedony

Chalcedony

chalcedony

chrysolite

Olivine (chrysolite, peridot)
chrysolite

chrysoprase

Сhrysoprase
chrysoprase

citrine

Сitrine (yellow quartz)
citrine

spinel

Spinel

spinel_synthetic

Synthetic spinel

spinel_synthetic

amber

Amber

amber

mix

Mix of stones

mix

Tip
titleNOTE

Don't use this element for products with another type of gemstone or products with more than one type of gemstone.


 ...
Code Block
languagexml
titlethemeXML example
Midnight
<offer ...>
    ...
	<jewelry>
	    <gender>f</gender>
		<jewelry_gem>rubin</jewelry_gem>
	</jewelry>
</offer>
...


Table of Contents