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

language	xml
theme	Midnight

<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

language	xml
theme	Midnight

<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

language	xml
theme	Midnight

<offer ...>
    ...
	<cosmetic>
	    <hypoallergenic>1</hypoallergenic>
	</cosmetic>
</offer>

Skin

The "skin" element must be inside the "cosmetics" element.

Code Block

language	xml
theme	Midnight

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

ValueDescriptiondehydratedProducts related to dehydrated skinsensitiveProducts related to sensitive skinproblemProducts related to problematic skinfadingProducts related to aging skin Code Block

language	xml
theme	Midnight

Code Block

language	xml
theme	Midnight

<offer ...>
    ...
	<cosmetic>
	    <skin>
			<condition>sensitive<<type>normal</condition>type>
			<condition>fading<<type>dry</condition>type>
		</skin>
	</cosmetic>
</offer>

Part

Condition (skin)

The "partcondition" elements must be inside the "skin" element of the "cosmetics" element and can have one of the following values:

Value	Description

face

dehydrated

Products related

to facial care, makeup, oral hygiene, etc.body

to dehydrated skin
sensitive	Products related

to body care, perfume, etc.intim

to sensitive skin
problem	Products related

to personal hygienehand

to problematic skin
fading	Products related

to hand and nail carelegProducts related to foot care

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

to aging skin

Code Block

language	xml
theme	Midnight

<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

language	xml
theme	Midnight

<offer ...>
    ...
	<cosmetic>
	    <skin>
			<part>face</part>
			<part>body</part>
		</skin>
	</cosmetic>
</offer>

Hair

The "hair" element must be inside the "cosmetics" element.

Code Block

language	xml
titletheme	XML exampleMidnight

 <offer ...
<offer>
    <cosmetics>
       ...>
        <hair>
            ...
	<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

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

Description
dry

dry typenormalnormal typeoilyoily typecombycombination 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

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

language	xml
theme	Midnight

<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

dyed

Products related to dyed hair

damaged

Products related to damaged hair

waved

curly

Products related to curly hair

seborea

dandruff

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

help

Consider the following example of use:

helping

...

Code Block

language	xml
titletheme	XML example

Midnight

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

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

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

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

Table of Contents

class	personaclick-fixed-position

Versions Compared

Old Version 9

New Version 10

Key

Additional Properties

Cosmetics

Gender

Hypoallargenic

Skin

Type (skin)

Condition (skin)

Condition (skin)

Part (skin)

Hair

Subsection `<hair>`

Hair Type

Type (hair)

Current Hair Condition

Condition (hair)

Subsection `<nail>`

Care Type

Subsection `<perfume>`

Main fragrance families (<family>)

Subgroups of fragrance families (<aroma>)

Product Volume

Purchase Frequency

Professional Products

Page Comparison

Versions Compared

Old Version 9

New Version 10

Key

Additional Properties

Cosmetics

Gender

Hypoallargenic

Skin

Type (skin)

Condition (skin)

Condition (skin)

Part (skin)

Hair

Subsection <hair>

Hair Type

Type (hair)

Current Hair Condition

Condition (hair)

Subsection <nail>

Care Type

Subsection <perfume>

Main fragrance families (<family>)

Subgroups of fragrance families (<aroma>)

Product Volume

Purchase Frequency

Professional Products

Subsection `<hair>`

Subsection `<nail>`

Subsection `<perfume>`