- Created by Andrey Veprikov, last modified on Apr 28, 2021
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 9 Next »
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 niche features of cosmetics and perfumes.
Cosmetics
The "cosmetics" element must be inside the "offer" element.
<offer ...>
...
<cosmetics>
...
</cosmetics>
</offer>
Gender
The "gender" element must be inside the "cosmetics" element and can have one of the following values:
| Value | Description |
|---|---|
| m | For men's products |
| f | For women's products |
<offer ...>
...
<cosmetic>
<gender>f</gender>
</cosmetic>
</offer>
If the product is equally suitable for either gender, there is no need to add this element.
Hypoallargenic
The "hypoallargenic" element must be inside the "cosmetics" element and can have the following values:
| Value | Description |
|---|---|
| 1 | Product is hypoallergenic |
| 0 | Product is non-hypoallergenic |
<offer ...>
...
<cosmetic>
<hypoallergenic>1</hypoallergenic>
</cosmetic>
</offer>
Skin
The "skin" element must be inside the "cosmetics" element.
<offer ...>
<cosmetics>
...
<skin>
...
</skin>
</cosmetics>
</offer>
Type (skin)
The "type" elements must be inside the "skin" element of the "cosmetics" element and can have one of the following values:
| Value | Description |
|---|---|
| dry | Products related to dry skin |
| normal | Products related to normal skin |
| oily | Products related to oily skin |
| comby | Products related to combination skin |
Condition (skin)
The "condition" elements must be inside the "skin" element of the "cosmetics" element and can have one of the following values:
| Value | Description |
|---|---|
| dehydrated | Products related to dehydrated skin |
| sensitive | Products related to sensitive skin |
| problem | Products related to problematic skin |
| fading | Products related to aging skin |
<offer ...>
...
<cosmetic>
<skin>
<condition>sensitive</condition>
<condition>fading</condition>
</skin>
</cosmetic>
</offer>
Part (skin)
The "part" elements must be inside the "skin" element of the "cosmetics" element and can have one of the following values:
| Value | Description |
|---|---|
| face | Products related to facial care, makeup, oral hygiene, etc. |
| body | Products related to body care, perfume, etc. |
| intim | Products related to personal hygiene |
| hand | Products related to hand and nail care |
| leg | Products related to foot care |
If this particular product is intended for various purposes/various local applications, additional data is passed in the form of a list in the <part> section.
Consider the following examle of use:
...
<offer ...>
...
<cosmetic>
<skin>
<part>face</part>
<part>body</part>
</skin>
</cosmetic>
</offer>
...
Subsection <hair>
Subsection <hair> contains additional characteristics of Hair Care products.
Hair Type
Optional parameter <type>. Placed inside the <offer> section, within the <cosmetics> subsection, within the <hair> sub-subsection.
Consider the following table of possible values:
| Value | description |
|---|---|
| dry | dry type |
| normal | normal type |
| oily | oily type |
| comby | combination type |
Current Hair Condition
Optional parameter <condition>. Placed inside the <offer> section, within the <cosmetics> subsection, within the <hair> sub-subsection.
Consider the following table of possible values:
| Value | Description |
|---|---|
| colored | dyed hair |
| damaged | damaged hair |
| waved | curly hair |
| seborea | dandruff |
| akne | aсne, others head skin conditions |
| loss | hair loss treatment |
| grow | hair growth help |
Consider the following example of use:
...
<offer ...>
...
<cosmetic>
<hair>
<type>normal</type>
<type>oily</type>
<condition>colored</condition>
<condition>damaged</condition>
</hair>
</cosmetic>
</offer>
...
Subsection <nail>
Subsection <nails> contains additional characteristics of Nail Care Care products.
Care Type
Optional parameter <type>. Placed inside the <offer> section, within the <cosmetics> subsection, within the <nail> sub-subsection.
Consider the following table of possible values:
| Value | description |
|---|---|
| tool | Nail care tool |
| polish | Nail polish |
| gel | Gel polish |
| oil | Nail oil |
| cleaner | Nail cleaner |
Consider the following example of use:
...
<offer ...>
...
<cosmetic>
<nail>
<type>tool</type>
<polish_color>red</polish_color>
</nail>
</cosmetic>
</offer>
...
Subsection <perfume>
Subsection <perfume> contains characteristics of fragrances.
Main fragrance families (<family>)
Mandatory parameter <family>. Placed inside the <offer> section, within the <cosmetics> subsection, within the <perfume> sub-subsection.
Consider the following table of possible values:
| Value | Description |
|---|---|
| floral | Floral notes |
| oriental | Oriental notes |
| woody | Woody notes |
| fresh | Fresh notes |
Consider the following example of use:
...
<offer ...>
...
<cosmetic>
<perfume>
<family>woody</family>
</perfume>
</cosmetic>
</offer>
...
Subgroups of fragrance families (<aroma>)
Optional parameter <aroma>. Placed inside the <offer> section, within the <cosmetics> subsection, within the <perfume> sub-subsection, within the <family> sub-sub-subsection.
| Relations | Value | Description | Commentary |
|---|---|---|---|
Floral notes Oriental notes Woody notes Fresh notes | fruity_floral | Fruity Floral (Fruity + Floral Notes) | Main notes include fruits and floral notes |
| floral | Floral (Floral + Fresh Notes) | Main notes include fresh-cut flowers. | |
| soft_floral | Soft Floral (Floral Notes) | Main notes include aldehydes and powdery notes. | |
| floral_oriental | Floral Oriental (Floral + Oriental Notes) | Main notes include white flowers (such as orange blossom) and sweet spices. | |
| soft_oriental | Soft Oriental (Oriental + Floral Notes) | Main notes include incense and amber. | |
| oriental | Oriental (Oriental Notes) | Main notes include oriental resins such as frankincense, and vanilla. | |
| woody_oriental | Woody Oriental (Oriental + Woody Notes) | Main notes include sandalwood and patchouli. | |
| woods | Woods | Main notes include aromatic woods and vetiver. | |
| mossy_woods | Mossy Woods (Woody + Oriental Notes) | Main notes include oakmoss and amber. | |
dry_woods | Dry Woods (Woody Notes) | Main notes include dry woods and leather. | |
| aromatic | Aromatic Fougère (Fresh Notes) | Main notes include lavender and aromatic herbs. This universal fragrance group includes elements from different families: the freshness from the Citrus family, floral notes of lavender, the spicy-sweetness of a Floral Oriental, the ambery depth of an Oriental and the Mossy Woods warmth of sandalwood and oakmoss. | |
| citrus | Citrus (Woody + Fresh Notes) | Main notes include bergamot and other citrus oils. | |
| water | Water (Fresh + Floral Notes) | Main notes include marine and aquatic notes, generally from the chemical calone. | |
| green | Green (Fresh + Floral Notes) | Main notes include galbanum and green notes. | |
| fruity | Fruity (Fresh + Floral Notes) | Main notes include berries and other non-citrus fruits. |
Consider the following example of use:
...
<offer ...>
...
<cosmetic>
<perfume>
<family>woody</family>
<aroma>mossy_woods</aroma>
</perfume>
</cosmetic>
</offer>
...
Product Volume
Optional parameter <volume> and <price> are wrapped in the parameter <volumes>. Placed inside the <offer> section, within the <cosmetics> subsection.
<volumes> allows to specify product volume and volume-dependable pricing.
Consider the following table of possible sub-parameters:
| Parameter | Description |
|---|---|
<volume> | Wrapper for each product volume (for parameters <value> and <price>) |
<value> | Volume in milliliters |
<price> | Price for each volume |
Consider the following example of use:
...
<offer ...>
...
<cosmetic>
<volumes>
<volume>
<value>200</value>
<price>1000</price>
</volume>
<volume>
<value>400</value>
<price>2000</price>
</volume>
</volumes>
</cosmetic>
</offer>
...
IMPORTANT
Measurment units for the <value> parameter are milliliters.
Purchase Frequency
Optional parameter <periodic>. Placed inside the <offer> section, within the <cosmetics> subsection.
Consider the following table of possible values:
| Value | Description |
|---|---|
| 1 | Product is purchased frequently |
| 0 | Product is purchased occasionally |
Consider the following example of use:
...
<offer ...>
...
<cosmetic>
<periodic>1</periodic>
</cosmetic>
</offer>
...
Professional Products
Optional parameter <professional>. Placed inside the <offer> section, within the <cosmetics> subsection.
Consider the following table of possible values:
| Value | Description |
|---|---|
| 1 | Product is purchased for professional use (by professionals) |
| 0 | Product is purchased for everyday use (by ordinary customers) |
Consider the following example of use:
...
<offer ...>
...
<cosmetic>
<professional>1</professional>
</cosmetic>
</offer>
...
- No labels