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

title	Following steps are covered

Table of Contents

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

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

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.

Case Sensitivity

Warning
All parameter names are case-sensitive and should follow the spelling used in this documentation.

Jewelry

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

Code Block

language	xml
theme	Midnight

<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

Male (Men

For men's

product)

products

f

Female (Women

For women's

product)

products

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

...

Code Block

language	xml
titletheme	XML example

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.

TiptitleNOTE

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

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

...

Code Block

language	xml
titletheme	XML example

Midnight

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

TiptitleNOTE

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

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

...

Code Block

language	xml
titletheme	XML example

Midnight

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

Tip

title	NOTE

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

language	xml
titletheme	XML 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

title	NOTE

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

ColorValue

Anchor

	color
	color

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

Value	Description
white	White (silver or metallic gray) color

white

red

Red color

red

yellow

Yellow color

yellow

black

Black color

black

Tip

title	NOTE

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

...

Code Block

language	xml
titletheme	XML 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

Anchor

	metal
	metal

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

Value	Description
gold	Gold Jewelry
silver	Silver Jewelry
platinum	Platinum 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

language	xml
titletheme	XML 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

title	NOTE

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

Gemstone typeValue

Agate

agate

Alexandrite

alexandrite

Anchor

	gem
	gem

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

Value	Description
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

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

...

Code Block

language	xml
titletheme	XML example

Midnight

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

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

Panel

title	Table of Contents

Page TreerootNiche Solutions

Column

Page Navigation

Table of Contents

maxLevel	2
indent	0px
style	none

Related Pages

Filter by label (Content by label)

showLabels	false
showSpace	false
sort	title
cql	label = "products"

Versions Compared

Old Version 1

New Version Current

Key

Add Additional Parameters to Your XML-file

Section `<jewelry>`

Targeted Gender

Case Sensitivity

Jewelry

Gender

Ring Size

Bracelet Size

Necklace Size

Color

Metal

Gemstone

Page Comparison

Versions Compared

Old Version 1

New Version Current

Key

Add Additional Parameters to Your XML-file

Section <jewelry>

Targeted Gender

Case Sensitivity

Jewelry

Gender

Ring Size

Bracelet Size

Necklace Size

Color

Metal

Gemstone

Section `<jewelry>`