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

> Referencia de los objetos Goal, Segment, Trigger, Product, Category, Param, Fashion, Color, Auto y Compatible.

Estos objetos describen objetivos, segmentos y triggers, así como los elementos del catálogo que usan los métodos de producto.

## Goal

Un objeto `Goal` representa un Key Performance Indicator (KPI) definido en la app de Kameleoon.

**Propiedades**

| Nombre | Tipo | Descripción |
| - | - | - |
| id | Number | ID del objetivo. |
| name | String | Nombre del objetivo. |
| type | String | Tipo del objetivo. Los valores posibles son: **CLICK**, **SCROLL**, **URL**, **ENGAGEMENT** y **CUSTOM**. |

## Segment

Un objeto `Segment` contiene criterios que una visita debe cumplir para pertenecer al segmento. En la plataforma Kameleoon, los segmentos incluyen condiciones constantes, como la edad o la ubicación, y condiciones de disparo, como el tiempo en página o el contenido del carrito.

**Propiedades**

| Nombre | Tipo | Descripción |
| - | - | - |
| id | Number | ID del segmento. |
| name | String | Nombre del segmento. |

## Trigger

Un objeto Trigger contiene criterios que una visita debe cumplir para disparar el trigger. En la plataforma Kameleoon, los triggers incluyen condiciones constantes, como la edad o la ubicación, y condiciones de disparo, como el tiempo en página o el contenido del carrito.

**Propiedades**

| Nombre | Tipo | Descripción |
| - | - | - |
| id | Number | ID del trigger. |
| name | String | Nombre del trigger. |

## Product

Un objeto `Product` describe los artículos de un catálogo. La mayoría de las propiedades son opcionales y pueden ser **null**.

**Propiedades**

| Nombre | Tipo | Obligatorio | Descripción |
| - | - | - | - |
| id | String | True | ID único del producto. |
| name | String | False | Nombre del producto. |
| sku | String | False | Stock Keeping Unit (SKU) del producto. |
| categories | Array | False | Lista de [objetos Category](#category) |
| imageURL | String | False | URL de la imagen principal de este producto. |
| price | Number | False | Precio actual del producto. |
| oldPrice | Number | False | Precio original del producto, normalmente antes de descuentos o promociones. |
| brand | String | False | Nombre de la marca del producto. |
| description | String | False | Descripción textual del producto. |
| available | Boolean | False | Indica si el producto está en stock. |
| availableQuantity | Number | False | Stock actual del producto. |
| rating | Number | False | Valoración (normalmente de 0 a 5, aunque puede ser cualquier número) atribuida al producto. |
| tags | Array | False | Lista de etiquetas (como Strings) para este producto. |
| typePrefix | String | False | Tipo de producto, como "mobile phone" o "washing machine". Lo usan los algoritmos de búsqueda. |
| merchantID | String | False | ID del vendedor/comerciante de este producto si su sitio web opera como un marketplace. |
| groupId | String | False | Use este campo para combinar variantes de producto en un único grupo. |
| model | String | False | Modelo del producto. |
| leftovers | String | False | Inventario para un producto en particular. Use uno de los siguientes valores: `one` (una copia disponible), `few` (cantidades limitadas, hasta 10 unidades) o `lot` (10 o más unidades disponibles). |
| priceMargin | Number | False | Factor de ponderación del margen de precio del producto, entre 0 y 100. |
| isFashion | Boolean | False | Establezca en `true` para productos de ropa. |
| isChild | Boolean | False | Use este campo si es un producto infantil. |
| isNew | Boolean | False | Use este campo si es un producto nuevo. |
| accessories | Array | False | Array de IDs de producto que pueden ser complementarios o equivalentes al producto actual. |
| seasonality | Array | False | Array de enteros (meses: 1-12). |
| params | Array | False | Lista de [objetos Param](#param) |
| fashion | Object | False | [Objeto Fashion](#fashion) |
| auto | Object | False | [Objeto Auto](#auto) |

## Category

**Propiedades**

| Nombre | Tipo | Obligatorio | Descripción |
| - | - | - | - |
| id | String | True | ID único de la categoría. |
| name | String | False | Nombre de la categoría. |
| parent | String | False | ID único de la categoría padre. |
| url | String | False | URL de la categoría. |

## Param

Campo genérico opcional que permite subir información personalizada sobre un producto que no encaja en los demás campos.
Por ejemplo, esta información podría ser el estado de membresía necesario para comprar un producto o las fechas de salida y vuelta de un circuito turístico.

**Propiedades**

| Nombre | Tipo | Obligatorio | Descripción |
| - | - | - | - |
| name | String | True | Nombre del param. |
| value | Array | True | Lista de valores (como Strings). |
| unit | String | False | Use abreviaturas de dos caracteres para unidades del SI, como cm (centímetros), wt (watts) o gr (gramos). |

## Fashion

Un campo genérico opcional que permite cargar información personalizada sobre el producto.

**Propiedades**

| Nombre | Tipo | Descripción |
| - | - | - |
| gender | String | Debe ser "f" (femenino) o "m" (masculino). |
| type | String | Tipo de producto. Valores posibles: `shoe`, `shirt`, `tshirt`, `underwear`, `trouser`, `jacket`, `blazer`, `sock`, `belt`, `hat`, `glove`. |
| feature | String | Use este campo para indicar si el producto es para adultos o solo para niños. Debe tomar el valor "child" o "adult". |
| colors | Array | Lista de [objetos Color](#color). |

## Color

**Propiedades**

| Nombre | Tipo | Descripción |
| - | - | - |
| color | String | Colores del producto. |
| picture | String | URL de la imagen. |

## Auto

Un campo genérico opcional que permite cargar información personalizada sobre el producto.

**Propiedades**

| Nombre | Tipo | Descripción |
| - | - | - |
| vds | Array | Array que contiene los Vehicle Identification Numbers (VIN) que sirven como huella del coche. |
| compatibility | Array | Contiene una lista de [objetos Compatible](#compatible) |

## Compatible

**Propiedades**

| Nombre | Tipo | Obligatorio | Descripción |
| - | - | - | - |
| brand | String | True | Nombre de la marca del coche. |
| model | String | False | Nombre del modelo del coche. |
