Versions Compared

Old Version 3

changes.mady.by.user Andrey Veprikov

Saved on

compared with

New Version Current

changes.mady.by.user Andrey Veprikov

Saved on

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

...


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.
...
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.
...
titleNOTE
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.
...
The "chain_size" elements must be inside the "chain_sizes" element of the "jewelry" element.
 Warning
Don't use this 
...
element for 
...
products that are not necklaces
...
.

 Code Block
languagexml
...
theme
...
Midnight
<offer ...>
    ...
	<jewelry>
...


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

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.
...
 Anchor
color
color
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
...
redRed color
...
yellowYellow color
...
blackBlack color
...

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

 Code Block
languagexml
...
theme
...
Midnight
<offer ...>
    ...
	<jewelry>
...

		<jewelry_
...
color>red</jewelry_color>
	</jewelry>
</offer>
...

Metal
...
Optional parameter <jewelry_metal>. Sent as a string with one of the parameters from the table below.
...
 Anchor
metal
metal
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 
...
element for products with a different type of metal or products with more than one type of metal.

 Code Block
languagexml
...
theme
...
Midnight
<offer ...>
    ...
	<jewelry>
...

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

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

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

 Code Block
languagexml
...
theme
...
Midnight
<offer ...>
    ...
	<jewelry>
...

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


 Column
Page Navigation
 Table of Contents
maxLevel2
indent0px
stylenone


Related Pages
 Filter by label (Content by label)
showLabelsfalse
showSpacefalse
sorttitle
cqllabel = "products"