Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Additional
PropertiesAdditional 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 | ||||
|---|---|---|---|---|
| ||||
<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 | 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 | ||||
|---|---|---|---|---|
| ||||
<offer ...> ... <jewelry> <gender>f</gender> </jewelry> </offer> |
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 | ||||
|---|---|---|---|---|
| ||||
<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
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 | ||||
|---|---|---|---|---|
| ||||
<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.
| 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 | ||||||
|---|---|---|---|---|---|---|
| ...
| |||||
<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>
... |
Color
Optional parameter <jewelry_color>. Sent as a string with one of the parameters from the table below.
| Tip | ||
|---|---|---|
| ||
Don't use this parameter if the item color is different from the table or it is a multi-color item. |
The "jewelry_color" element must be inside the "jewelry" element and can have one of the following values: Anchor color color
| Value | Description |
|---|---|
| white | White (silver or metallic gray) color |
| red | Red color |
| yellow | Yellow color |
| black | Black color |
| Tip | ||
|---|---|---|
| ||
Don't use this element for products in other colors or multicolors. |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ...
| |||||
<offer ...>
...
<jewelry>
<gender>f</gender>
<jewelry_color>white<color>red</jewelry_color>
</jewelry>
</offer>
... |
Metal
TypeOptional parameter <jewelry_metal>. Sent as a string with one of the parameters from the table below.
The "jewelry_metal" element must be inside the "jewelry" element and can have one of the following values: Anchor metal metal
| 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. |
element for products with a different type of metal or products with more than one type of metal. |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ...
| |||||
<offer ...>
...
<jewelry>
<gender>f</gender>
<jewelry_metal>silver</jewelry_metal>
</jewelry>
</offer>
... |
Gemstone
TypeOptional parameter <jewelry_gem>. Sent as a string with one of the parameters from the table below.
| Tip | ||
|---|---|---|
| ||
Don't use this parameter if the gemstone type is different from the table. |
Agate
agate
Alexandrite
The "jewelry_gem" element must be inside the "jewelry" element and can have one of the following values: Anchor gem gem
| Value | Description |
|---|---|
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 | ||||||
|---|---|---|---|---|---|---|
| ...
| |||||
<offer ...>
...
<jewelry>
<gender>f</gender>
<jewelry_gem>rubin</jewelry_gem>
</jewelry>
</offer>
... |
| Column | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Page Navigation
Related Pages
|