> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Goal, segment, trigger, and product objects

> Référence des objets Goal, Segment, Trigger, Product, Category, Param, Fashion, Color, Auto et Compatible.

Ces objets décrivent les objectifs, les segments et les déclencheurs, ainsi que les éléments du catalogue utilisés par les méthodes produit.

## Goal

Un objet `Goal` représente un indicateur clé de performance (KPI) défini dans la Kameleoon app.

**Properties**

| Name | Type | Description |
| - | - | - |
| id | Number | ID de l’objectif. |
| name | String | Nom de l’objectif. |
| type | String | Type d'objectif. Les valeurs possibles sont : **CLICK**, **SCROLL**, **URL**, **ENGAGEMENT** et **CUSTOM**. |

## Segment

Un objet `Segment` contient les critères qu'une visite doit respecter pour appartenir au segment. Sur la plate-forme Kameleoon, les segments incluent des conditions constantes, tel que l'âge ou l'emplacement, et les conditions de déclenchement, tel que le temps sur la page ou le contenu du panier.

**Properties**

| Name | Type | Description |
| - | - | - |
| id | Number | ID du segment. |
| name | String | Nom du segment. |

## Trigger

Un objet Trigger contient les critères qu'une visite doit respecter pour déclencher le déclencheur. Sur la plate-forme Kameleoon, les déclencheurs incluent des conditions constantes, tel que l'âge ou l'emplacement, et les conditions de déclenchement, tel que le temps sur la page ou le contenu du panier.

**Properties**

| Name | Type | Description |
| - | - | - |
| id | Number | ID du trigger. |
| name | String | Nom du trigger. |

## Product

Un objet `Product` décrit les articles d'un catalogue. La plupart des propriétés sont optionnelles et peuvent être **null**.

**Properties**

| Name | Type | Requis | Description |
| - | - | - | - |
| id | String | True | Unique ID du product. |
| name | String | False | Nom du product. |
| sku | String | False | Unité de gestion des stocks (SKU) du produit. |
| categories | Array | False | Liste des [Category objects](#category) |
| imageURL | String | False | L'URL de l'image principale de ce produit. |
| price | Number | False | Le prix actuel du produit. |
| oldPrice | Number | False | Le prix d'origine du produit, généralement avant les réductions ou les promotions. |
| brand | String | False | Nom du product's brand. |
| description | String | False | Description textuelle du produit. |
| available | Boolean | False | Indique si le produit est en stock. |
| availableQuantity | Number | False | Stock actuel du produit. |
| rating | Number | False | Note (généralement de 0 à 5, mais peut être un nombre quelconque) attribuée au produit. |
| tags | Array | Faux | Liste des balises (en tant que chaînes de caractères) pour ce produit. |
| typePrefix | String | Faux | Type de produit, tel que « téléphone mobile » ou « machine à laver ». Utilisé par les algorithmes de recherche. |
| merchantID | String | False | ID du vendeur / commerçant de ce produit si votre site Web fonctionne comme une place de marché. |
| groupId | String | False | Utilisez ce champ pour combiner les variantes de produits en un seul groupe. |
| model | String | False | Modèle du produit. |
| leftovers | String | False | Inventaire pour un produit particulier. Utilisez l'une des valeurs suivantes : `one` (un exemplaire disponible), `few` (quantités limitées, jusqu'à 10 unités), ou `lot` (10 unités ou plus disponibles). |
| priceMargin | Number | False | Un facteur de pondération de la marge bénéficiaire du produit, entre 0 et 100. |
| isFashion | Boolean | False | Définir sur `true` pour les produits de vêtement. |
| isChild | Boolean | False | Utilisez ce champ si produit enfant. |
| isNew | Boolean | False | Utilisez ce champ si nouveau produit. |
| accessories | Array | False | Tableau d'ID de produits qui peuvent être complémentaires ou équivalents au produit actuel. |
| seasonality | Array | False | Tableau de integers (months: 1-12). |
| params | Array | False | Liste des [Param objects](#param) |
| fashion | Object | False | [Fashion object](#fashion) |
| auto | Object | False | [Auto object](#auto) |

## Category

**Properties**

| Name | Type | Requis | Description |
| - | - | - | - |
| id | String | True | Unique ID du category. |
| name | String | False | Nom du category. |
| parent | String | False | Unique ID du parent category. |
| url | String | False | L'URL de la catégorie. |

## Param

Champ générique facultatif qui vous permet de transmettre des informations personnalisées sur un produit qui ne rentrent pas dans les autres champs.
Par exemple, ces informations pourraient être le statut d'adhésion requis pour acheter un produit ou les dates de départ et de retour pour un circuit de voyage.

**Properties**

| Name | Type | Requis | Description |
| - | - | - | - |
| name | String | True | Nom du param. |
| value | Array | True | Liste des valeurs (sous forme de chaînes). |
| unit | String | Faux | Utilisez des abréviations de deux caractères pour les unités SI, tel que cm (centimètres), W (watts) ou g (grammes). |

## Fashion

Un champ générique optionnel qui vous permet de télécharger des informations personnalisées sur le produit.

**Properties**

| Name | Type | Description |
| - | - | - |
| gender | String | Doit être « f » (Femelle) ou « m » (Mâle). |
| type | String | Product type. Possible values: `shoe`, `shirt`, `tshirt`, `underwear`, `trouser`, `jacket`, `blazer`, `sock`, `belt`, `hat`, `glove`. |
| feature | String | Utilisez ce champ pour indiquer si le produit est destiné aux adultes ou aux enfants uniquement. Doit prendre la valeur « child » ou « adult ». |
| colors | Array | Liste des [Color objects](#color). |

## Color

**Properties**

| Name | Type | Description |
| - | - | - |
| color | String | Product colors. |
| picture | String | L'URL de l'image. |

## Auto

Un champ générique optionnel qui vous permet de télécharger des informations personnalisées sur le produit.

**Properties**

| Name | Type | Description |
| - | - | - |
| vds | Array | Tableau qui contient les numéros d'identification de véhicule (VIN) qui servent d'empreinte digitale de la voiture. |
| compatibility | Array | Contient une liste d’[objets Compatible](#compatible) |

## Compatible

**Properties**

| Name | Type | Requis | Description |
| - | - | - | - |
| brand | String | True | Car brand name. |
| model | String | False | Car model name. |
