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.
| Code Block |
|---|
|
<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 |
| Code Block |
|---|
|
<offer ...>
...
<cosmetic>
<gender>f</gender>
</cosmetic>
</offer> |
| Tip |
|---|
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 |
| Code Block |
|---|
|
<offer ...>
...
<cosmetic>
<hypoallergenic>1</hypoallergenic>
</cosmetic>
</offer> |
Skin
The "skin" element must be inside the "cosmetics" element.
| Code Block |
|---|
|
<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 |
| Code Block |
|---|
|
<offer ...>
...
<cosmetic>
<skin>
<type>normal</type>
<type>dry</type>
</skin>
</cosmetic>
</offer> |
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 |
| Code Block |
|---|
|
<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 |
| Code Block |
|---|
|
<offer ...>
...
<cosmetic>
<skin>
<part>face</part>
<part>body</part>
</skin>
</cosmetic>
</offer> |
Hair
The "hair" element must be inside the "cosmetics" element.
| Code Block |
|---|
|
<offer ...>
<cosmetics>
...
<hair>
...
</hair>
</cosmetics>
</offer> |
Type (hair)
The "type" elements must be inside the "hair" element of the "cosmetics" element and can have one of the following values:
| Value | Description |
|---|
| dry | Products related to dry hair |
| normal | Products related to normal hair |
| oily | Products related to oily hair |
| comby | Products related to combination hair |
| Code Block |
|---|
|
<offer ...>
...
<cosmetic>
<hair>
<type>normal</type>
<type>oily</type>
</hair>
</cosmetic>
</offer> |
Condition (hair)
The "condition" elements must be inside the "hair" element of the "cosmetics" element and can have one of the following values:
| Value | Description |
|---|
| colored | Products related to dyed hair |
| damaged | Products related to damaged hair |
| waved | Products related to curly hair |
| seborea | Products related to dandruff |
| akne | Products related to aсne, others head skin conditions |
| loss | Products related to hair loss treatment |
| grow | Products related to hair growth helping |
| Code Block |
|---|
|
<offer ...>
...
<cosmetic>
<hair>
<condition>colored</condition>
<condition>damaged</condition>
</hair>
</cosmetic>
</offer> |
Subsection <nail>
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:
| Code Block |
|---|
| language | xml |
|---|
| title | XML example |
|---|
|
...
<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:
| Code Block |
|---|
| language | xml |
|---|
| title | XML example |
|---|
|
...
<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:
| Code Block |
|---|
| language | xml |
|---|
| title | XML example |
|---|
|
...
<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:
| Code Block |
|---|
| language | xml |
|---|
| title | XML example |
|---|
| collapse | true |
|---|
|
...
<offer ...>
...
<cosmetic>
<volumes>
<volume>
<value>200</value>
<price>1000</price>
</volume>
<volume>
<value>400</value>
<price>2000</price>
</volume>
</volumes>
</cosmetic>
</offer>
... |
| Info |
|---|
|
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:
| Code Block |
|---|
| language | xml |
|---|
| title | XML example |
|---|
|
...
<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:
| Code Block |
|---|
| language | xml |
|---|
| title | XML example |
|---|
|
...
<offer ...>
...
<cosmetic>
<professional>1</professional>
</cosmetic>
</offer>
... |