"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.
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.
| Value | Description |
|---|---|
| m | Male (Men's product) |
| f | Female (Women's product) |
... <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.
...
<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.
...
<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.
...
<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.
| Color | Value |
|---|---|
| White (silver or metallic gray) color | white |
| Red color | red |
| Yellow color | yellow |
| Black color | black |
...
<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 type | Value |
|---|---|
| Gold | gold |
| Silver | silver |
| Platinum | platinum |
...
<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 type | Value |
|---|---|
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 |
...
<offer ...>
...
<jewelry>
<gender>f</gender>
<jewelry_gem>rubin</jewelry_gem>
</jewelry>
</offer>
...