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.

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.

Case Sensitivity

Warning
All parameter names are case-sensitive and should follow the spelling used in this documentation.

Cosmetics

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

Code Block

language	xml
theme	Midnight

<offer ...>
    ...
    <cosmetics>
        ...
    </cosmetics>
</offer>

Gender

Anchor

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

Hypoallergenic

The "hypoallergenic" element must be inside the "cosmetics" element and can have the following values:

Value	Description
1	Product is hypoallergenic
0	Product is non-hypoallergenic. The default value.

Code Block

language	xml
theme	Midnight

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

Skin

Anchor

	skin
	skin

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

Code Block

language	xml
theme	Midnight

<offer ...>
    <cosmetics>
       ...
        <skin>
            ...
        </skin>
    </cosmetics>
</offer>

Type (skin)

Anchor

	skin_type
	skin_type

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

language	xml
theme	Midnight

<offer ...>
    ...
	<cosmetic>
	   <cosmetics>         ...
    </cosmetics>
</offer>

Gender

The "gender" element

<skin>
			<type>normal</type>
			<type>dry</type>
		</skin>
	</cosmetic>
</offer>

Condition (skin)

Anchor

	skin_condition
	skin_condition

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

Value	Description
m	For men's products
f	For women's productsdehydrated	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

language	xml
theme	Midnight

<offer ...>
    ...
	<cosmetic>
	    <skin>
			<condition>sensitive</condition>
 <gender>f</gender>			<condition>fading</condition>
		</skin>
	</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

Part

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

Value	Description
1	Product is hypoallergenic
0	Product is non-hypoallergenic
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>
 <hypoallergenic>1</hypoallergenic>			<part>body</part>
		</skin>
	</cosmetic>
</offer>

Skin

Hair

Anchor

	hair
	hair

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

Code Block

language	xml
theme	Midnight

<offer ...>
    <cosmetics>
       ...
        <skin><hair>
            ...
        </skin>hair>
    </cosmetics>
</offer>

Skin Type

Optional parameter <type>. Placed inside the <offer> section, within the <cosmetics> subsection, within the <skin> sub-subsection.

Consider the following table of possible values

Type (hair)

Anchor

	hair_type
	hair_type

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

skin

hair
normal	Products related to normal

skin

hair
oily	Products related to oily

skin

hair

comby

combination skin

Current Skin Condition

Optional parameter <condition>. Placed inside the <offer> section, within the <cosmetics> subsection, within the <skin> sub-subsection.

Consider the following table of possible values:

ValueDescriptiondehydrateddehydratedsensitivesensitiveproblempropblematicfadingageing

Consider the following examle of use:

Code Block

language	xml
title	XML example

... <offer ...> ...

Products related to combination hair

Code Block

language	xml
theme	Midnight

<offer ...>
    ...
	<cosmetic>
	    <skin><hair>
			<part>face</part>
			<part>body</part>
			<type>normal</type>
			<type>oily</type>
			<condition>sensitive</condition>
			<condition>fading</condition>
		</skin>hair>
	</cosmetic>
</offer>
...

Local Application

Optional parameter <part>. Placed inside the <offer> section, within the <cosmetics> subsection, within the <skin> sub-subsection.

Consider the following table of possible values:

ValueDescriptionfacefacial care, makeup and oral hygiene productsbodybody care products, perfumeintimpersonal hygiene productshandhand and nail care productslegfoot care products

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:

Code Block

language	xml
title	XML example

 ...
<offer ...>

Condition (hair)

Anchor

	hair_condition
	hair_condition

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

language	xml
theme	Midnight

<offer ...>
    ...
	<cosmetic>
	    <hair>
			<condition>colored</condition>
			<condition>damaged</condition>
		</hair>
	</cosmetic>
</offer>

Nail

Anchor

	nail
	nail

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

Code Block

language	xml
theme	Midnight

<offer ...>
    ...
    <cosmetics>
        <nail>
            ...
	<cosmetic> 	    <skin> 			<part>face</part> 			<part>body</part> 		</skin>nail>
	</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:

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

Value Descriptioncoloreddyed hairdamageddamaged hairwavedcurly hairseboreadandruffakneaсne, others head skin conditionslosshair loss treatmentgrowhair growth helpConsider the following example of use:

    <cosmetics>
</offer>

Type (nail)

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

Value	Description
tool	Products related to nail care tool
polish	Products related to nail polish
gel	Products related to gel polish
oil	Products related to nail oil
cleaner	Products related to nail cleaner

...

Code Block

language	xml
titletheme	XML example

Midnight

<offer ...>
    ...
	<cosmetic>
	    <hair><nail>
			<type>normal<<type>tool</type>
			<type>oily<</type>nail>
			<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:

ValuedescriptiontoolNail care toolpolishNail polishgelGel polishoilNail oilcleanerNail cleanerConsider the following example of use:

cosmetic>
</offer>

Polish Color

The "polish_color" element must be inside the "nail" element of the "cosmetics" element and can have any value describing the color of the nail polish.

Note
This element can only be used in combination with the "polish" type. See above.

Code Block

language	xml
theme	Midnight

<offer ...>
    ...
	<cosmetic>
	    <nail>
			<type>polish</type>
            <polish_color>red</polish_color>
		</nail>
	</cosmetic>
</offer>

Perfume

Anchor

	perfume
	perfume

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

...

Code Block

language	xml
titletheme	XML example

Midnight

<offer ...>
    ...
	<cosmetic>
	
    <cosmetics>
        <perfume>
          <nail> 			<type>tool</type>
 ...
        </perfume>
  <polish_color>red</polish_color> 		</nail>
	</cosmetic> <cosmetics>
</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

Family

Anchor

	family
	family

The "family" element must be inside the "perfume" element of the "cosmetics" element and can have one of the following values:

Value	Description
floral

Floral notes

Perfume products of the floral note family

oriental

Oriental notes

Perfume products of the oriental note family

woody

Woody notes

Perfume products of the woody note family

fresh

Fresh notes

Consider the following example of use:

Perfume products of the fresh note family

...

Code Block

language	xml
titletheme	XML example

Midnight

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

RelationsValueDescriptionCommentary

Floral notes

Oriental notes

Woody notes

Fresh notes

fruity_floral

Aroma

Anchor

	aroma
	aroma

The "aroma" element must be inside the "perfume" element of the "cosmetics" element and can have one of the following values:

Value	Relations	Description	Commentary
fruity_floral	Floral Family	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

include aldehydes and powdery notes

.


floral_oriental	Oriental Family	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	Woody Family	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	Fresh Family	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
titletheme	XML example

Midnight

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

ParameterDescription<volume>Wrapper for each product volume (for parameters <value> and <price>)<value>Volume in milliliters

<price>

Volume

The "volume" elements must be inside the "volumes" element of the "cosmetics" element. Each "volume" element must contain the "value" and "price" elements:

Name	Type	Description
value	number	Volume in milliliters
price	number	Price for each volume

Consider the following example of use:

...

Code Block

language	xml
title	XML example
collapse	true

theme	Midnight

<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

</cosmetic>
</offer>

Periodic

The "periodic" element must be inside the "cosmetics" element and can have the following values:

Value	Description
1	Product is purchased frequently
0	Product is purchased occasionally

Consider the following example of use:

. The default value.

...

Code Block

language	xml
titletheme	XML example

Midnight

<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

The "professional" element must be inside the "cosmetics" element and can have the following 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:

. The default value.

...

Code Block

language	xml
titletheme	XML example

Midnight

<offer ...>
    ...
	<cosmetic>
	    <professional>1</professional>
	</cosmetic>
</offer>
...

Table of Contentsclasspersonaclick-fixed-position

Column

Page Navigation

Table of Contents

maxLevel	2
indent	0px
style	none

Related Pages

Filter by label (Content by label)

showLabels	false
showSpace	false
sort	title
cql	label = "products"

Page Comparison

Versions Compared

Old Version 7

New Version Current

Key

Additional Properties

Cosmetics

Case Sensitivity

Cosmetics

Gender

Hypoallergenic

Skin

Type (skin)

Gender

Condition (skin)

Hypoallargenic

Part

Hair

Skin Type

Type (hair)

Current Skin Condition

Local Application

Condition (hair)

Nail

Subsection <hair>

Hair Type

Current Hair Condition

Type (nail)

Subsection <nail>

Care Type

Polish Color

Perfume

Subsection <perfume>

Main fragrance families (<family>)

Family

Subgroups of fragrance families (<aroma>)

Aroma

Product Volume

Volume

Purchase Frequency

Periodic

Professional

Subsection `<hair>`

Subsection `<nail>`

Subsection `<perfume>`