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

# Configuration and visitor objects

> Referencia de los objetos Configuration, Visitor, Visit, Device, Geolocation y Weather.

Estos objetos describen la configuración del sitio y al visitante. El objeto Visitor contiene todas las visitas que Kameleoon registra para ese visitante.

## Configuration

Un objeto Configuration contiene valores constantes globales relacionados con la configuración actual de Kameleoon en este sitio.

**Propiedades**

| Nombre | Tipo | Descripción |
| - | - | - |
| siteCode | String | El código de sitio único que corresponde al archivo de aplicación de Kameleoon instalado en el sitio web. Es una cadena de 10 caracteres aleatorios (letras minúsculas y números). |
| singlePageSupport | Boolean | Se establece en **true** si Single Page Support está configurado. Se configura de forma global en la aplicación Kameleoon o con `Kameleoon.API.Core.enableSinglePageSupport()`. Single Page Support hace que los cambios de URL activen `Kameleoon.API.Core.load()` sin necesidad de recargar la página del navegador. |
| goals | Array | Lista de [objetos Goal](https://docs.kameleoon.com/es/developer-docs/apis/activation-api-js/api-reference/objects/goal-segment-trigger-and-product.md#goal) que representan todos los objetivos activos (configurados) de este sitio. |
| generationTime | Number | Hora de la última generación del archivo de la aplicación de Kameleoon (formato UTC, ms desde el 1 de enero de 1970). |

## Visitor

Un objeto Visitor contiene datos a nivel de visitante independientes de visitas específicas. Este objeto incluye una lista de todos los [objetos Visit](#visit) del visitante.

**Propiedades**

| Nombre | Tipo | Descripción |
| - | - | - |
| code | String | El código de visitante generado aleatoriamente. A menos que se haya establecido un valor personalizado específicamente en el servidor (a través de un SDK server-side de Kameleoon), es una cadena de 16 caracteres aleatorios (letras minúsculas y números). |
| numberOfVisits | Number | Total de visitas del visitante. Este valor puede ser superior a `visits.length`, ya que la Activation API retiene solo las 25 últimas visitas. |
| firstVisitStartDate | Number | Fecha de inicio (UNIX en milisegundos) de la primera visita. Este valor puede no coincidir con `visits[0].startDate`, ya que la Activation API retiene solo las 25 últimas visitas. |
| visits | Array | Lista de todos los [objetos Visit](#visit) realizados por este visitante en su sitio web, con un máximo de 25 visitas. Si este visitante hizo más de 25 visitas, solo las 25 últimas están disponibles a través de esta propiedad. |
| currentVisit | Object | [Objeto Visit](#visit) correspondiente a la visita actual, en curso. La propiedad hace referencia al mismo objeto que **Kameleoon.API.CurrentVisit**. |
| previousVisit | Object | [Objeto Visit](#visit) correspondiente a la visita anterior. Si no hubo una visita anterior (es decir, la visita actual es la primera), esta propiedad es **null**. |
| customData | Object | Mapa de todos los datos personalizados con ámbito **VISITOR**. Las claves del mapa son los nombres definidos de los datos personalizados. Este mapa solo incluye los datos personalizados que definió en la app de Kameleoon con ámbito **VISITOR**. Puede acceder a otros datos personalizados desde un objeto Visit. |
| experimentLegalConsent | Boolean | Cuando es **true**, el motor ha obtenido el consentimiento legal (o no es necesario) para que el visitante active experimentos. Esta propiedad es **null** si el visitante no ha dado ni rechazado su consentimiento. |
| personalizationLegalConsent | Boolean | Cuando es **true**, el motor ha obtenido el consentimiento legal (o no es necesario) para que el visitante active personalizaciones. Esta propiedad es **null** si el visitante no ha dado ni rechazado su consentimiento. |

## Visit

Un objeto Visit representa una sola visita y contiene información en tiempo real que recopila Kameleoon. Los puntos de datos incluyen el contexto de la visita (dispositivo, ubicación), el comportamiento observado (duración, páginas vistas) y las operaciones de Kameleoon, como los experimentos o personalizaciones disparados.

**Propiedades**

| Nombre | Tipo | Descripción |
| - | - | - |
| index | Number | Índice de la visita. La primera visita de un visitante dado tiene un índice de 0. Como la Activation API retiene solo las 25 últimas visitas, `Kameleoon.API.Visitor.visits[0].index` puede no ser igual a 0. |
| startDate | Number | Fecha (formato UTC, ms desde el 1 de enero de 1970) del inicio de la visita. |
| duration | Number | Duración de esta visita en ms. Si es la visita actual, este valor siempre está actualizado (el motor lo recalcula cada vez que se lee). |
| pageViews | Number | Número de páginas vistas durante la visita. En las SPA, al llamar a `Kameleoon.API.Core.load()` este número aumenta. Los cambios de URL activan esta llamada automáticamente si habilita Single Page Support. |
| locale | String | Idioma del navegador del visitante. |
| device | Object | [Objeto Device](#device) correspondiente al dispositivo del visitante para esta visita. |
| geolocation | Object | [Objeto Geolocation](#geolocation) correspondiente a la ubicación del visitante para esta visita. |
| weather | Object | [Objeto Weather](#weather) correspondiente al clima del visitante para esta visita. |
| activatedExperiments | Array | Lista de [objetos ExperimentActivation](https://docs.kameleoon.com/es/developer-docs/apis/activation-api-js/api-reference/objects/experiment-and-personalization.md#experimentactivation), que corresponden a todos los experimentos que el motor activó en esta visita. |
| activatedPersonalizations | Array | Lista de [objetos PersonalizationActivation](https://docs.kameleoon.com/es/developer-docs/apis/activation-api-js/api-reference/objects/experiment-and-personalization.md#personalizationactivation), que corresponden a todas las personalizaciones que el motor activó en esta visita. |
| conversions | Object | Mapa de conversiones realizadas en esta visita. Las claves del mapa son los ID de objetivo definidos. Los valores son objetos con dos claves: **count** (número de veces que la visita convirtió este objetivo) y **revenue** (ingresos totales de este objetivo para esta visita). |
| customData | Object | Mapa de todos los datos personalizados con ámbito **PAGE** o **VISIT**. Las claves del mapa son los nombres definidos de los datos personalizados. Este mapa solo incluye los datos personalizados que definió en la app de Kameleoon con ámbito **PAGE** o **VISIT**. Puede acceder a otros datos personalizados desde el objeto Visitor. |
| currentProduct | Object | [Objeto Product](https://docs.kameleoon.com/es/developer-docs/apis/activation-api-js/api-reference/objects/goal-segment-trigger-and-product.md#product) correspondiente al producto mostrado en la página de producto actual. Si el visitante no está en una página de producto, esta propiedad es **null**. |
| products | Array | Lista de [objetos Product](https://docs.kameleoon.com/es/developer-docs/apis/activation-api-js/api-reference/objects/goal-segment-trigger-and-product.md#product) correspondientes a todas las páginas de producto que visitó la visita (incluido **currentProduct**, si corresponde). |
| acquisitionChannel | String | Nombre del canal de adquisición de la visita. Define la lista de canales de adquisición, junto con sus características (sobre todo cómo Kameleoon puede inferirlos, por ejemplo mediante un parámetro de URL), en la aplicación Kameleoon. |
| landingPageURL | String | URL de la primera página de la visita, normalmente llamada landing page. |
| initialConversionPredictions | Object | Mapa de Kameleoon Conversion Scores (KCS). Las claves del mapa son los nombres definidos de los momentos clave. Los valores van de 0 a 100, representando el KCS del momento clave designado. (Nota: Kameleoon ha cambiado recientemente "key moment" por "triggers" en la app de Kameleoon). |

> [!NOTE]
>
> La propiedad `kameleoonConversionScores` solo está disponible con el add-on Contextual Bandit & AI Targeting Premium.

## Device

Un objeto Device contiene datos sobre el dispositivo de una visita determinada.

**Propiedades**

| Nombre | Tipo | Descripción |
| - | - | - |
| browser | String | Nombre del navegador. Los valores posibles son: **Chrome**, **Chromium**, **Firefox**, **Safari**, **Microsoft Edge**, **Internet Explorer**, **Opera**, **Android**, **iPhone**, **iPad**, **iPod**, **Samsung Internet for Android**, **Opera Coast**, **Yandex Browser**, **UC Browser**, **Maxthon**, **Epiphany**, **Puffin**, **Sleipnir**, **K-Meleon**, **Windows Phone**, **Vivaldi**, **Sailfish**, **SeaMonkey**, **Amazon Silk**, **PhantomJS**, **SlimerJS**, **BlackBerry**, **WebOS**, **Bada**, **Tizen**, **QupZilla**, **Googlebot**, **Blink**, **Gecko**, **Webkit**. |
| browserVersion | String | Versión del navegador. |
| os | String | Nombre del SO. Los valores posibles son: **Windows**, **Mac**, **Linux**, **Android**, **iOS**, **Chrome OS**, **Windows Phone**. |
| type | String | Tipo de dispositivo. Los valores posibles son: **Desktop**, **Tablet**, **Phone**. |
| screenHeight | Number | Altura de la pantalla del dispositivo (en píxeles). |
| screenWidth | String | Anchura de la pantalla del dispositivo (en píxeles). |
| windowHeight | Number | Altura de la ventana del navegador (en píxeles). |
| windowWidth | String | Anchura de la ventana del navegador (en píxeles). |
| adBlocker | Boolean | Booleano igual a **true** si este dispositivo tiene un ad blocker activo; en caso contrario, **false**. |
| timeZone | String | Zona horaria del navegador. El valor es una cadena (por ejemplo, "Europe/Paris") que corresponde a la [base de datos TZ de zonas horarias.](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) |

## Geolocation

Un objeto Geolocation contiene datos sobre la ubicación física del visitante para una visita determinada.

**Propiedades**

| Nombre | Tipo | Descripción |
| - | - | - |
| country | String | Nombre del país, en inglés. |
| region | String | Nombre de la región, en el idioma preferido del país. |
| city | String | Nombre de la ciudad, en el idioma preferido del país. |
| postalCode | String | Código postal. |
| latitude | Number | Latitud (en grados). |
| longitude | Number | Longitud (en grados). |

## Weather

Un objeto Weather contiene datos sobre las condiciones meteorológicas en el momento de la visita.

**Propiedades**

| Nombre | Tipo | Descripción |
| - | - | - |
| temperature | String | Temperatura en grados Kelvin. |
| humidity | String | Humedad en porcentaje (de 0 a 100). |
| pressure | String | Presión atmosférica en hPa. |
| windSpeed | String | Velocidad del viento en metros/seg. |
| cloudiness | Number | Nubosidad en porcentaje (de 0 a 100). |
| sunrise | Number | Hora del amanecer (formato UTC, ms desde el 1 de enero de 1970). |
| sunset | Number | Hora del atardecer (formato UTC, ms desde el 1 de enero de 1970). |
| conditionCode | Number | ID del código de la condición meteorológica. [Lista de referencia completa disponible aquí.](https://openweathermap.org/weather-conditions) |
| conditionDescription | String | Descripción de la condición meteorológica correspondiente a `conditionCode`. Por ejemplo, un `conditionCode` de **800** tiene una `conditionDescription` de **clear sky**. |