Page tree
Skip to end of metadata
Go to start of metadata

"Jewelry" algorithm is developed to automatically identify particular characteristics of a new potential customer, such as the metal type of the item, finger and wrist size and so on, and specify product recommendations based on this data. 

Following steps are covered

Add Additional Parameters to Your XML-file

For the algorithm to work properly every product in your XML Product Feed should have additional properties stated inside the <offer> within the <jewelry>  subsection:

  • gender this product is targeted at
  • ring size a.k.a finger size
  • bracelet size a.k.a. wrist size
  • necklace size (circumference length)
  • item color
  • metal type
  • gemstone type

This data should be included into the XML-file in the form of specific product parameters and send to REES46.

Section <jewelry>

A distinctive jewelry piece feature is presence of the <jewelry> subsection inside the <offer>  section.

Add the following parameters to each product to your XML-File

Targeted Gender

Mandatory parameter <gender>. Placed inside the <offer> section, within the <adult> subsection.

ValueDescription
mMale (Men's product)
fFemale (Women's product)
XML example
...
<offer ...>
	...
	<jewelry>
		<gender>f</gender>
	</jewelry>
</offer>
...

No need to specify the gender this particular product is targeted at, if you do not have this data (gender). In this case, this particular product will simply be marked as 'unisex' and will have a lower displaying priority in relation to other products with the specified gender parameter.

 

Ring Size

Optional parameter <ring_sizes>. Contains the full list of available sizes for the given SKU (i.e ring). 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 rings or don't come in different sizes.

XML example
 ...
<offer ...>
    ...
	<jewelry>
	    <gender>f</gender>
	    <ring_sizes>
			<ring_size>16</ring_size>
			<ring_size>16.5</ring_size>
			<ring_size>17</ring_size>
		</ring_sizes>
	</jewelry>
</offer>
...

Bracelet Size

Optional parameter <bracelet_sizes>. Contains the full list of available sizes for the given SKU (i.e bracelet). 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 bracelets or don't come in different sizes.

XML example
 ...
<offer ...>
    ...
	<jewelry>
	    <gender>f</gender>
	    <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.

ColorValue
White (silver or metallic gray) colorwhite
Red colorred
Yellow coloryellow
Black colorblack
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 typeValue
Goldgold
Silversilver
Platinumplatinum
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 typeValue

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>
...

Return to the top of the page | Proceed to the next page

Table of Contents

  • No labels