Versions Compared

Key

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

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

Panel
titleFollowing steps are covered

Table of Contents

Add Additional Parameters to Your XML-file

...

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

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

...

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
m

...

For men's

...

products
f

...

For women's

...

products

Tip

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


Code Block
languagexml

...

theme

...

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

...

Info

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.

...

titleNOTE


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

...

theme

...

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

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.

...

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

...

theme

...

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

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


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

Tip
titleNOTE

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


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

Tip
titleNOTE

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


Metal typeValue
Goldgold
Silversilver
Platinumplatinum


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

Tip
titleNOTE

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


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


Table of Contents