Configuration and visitor objects - Kameleoon Documentation

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 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 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 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 correspondiente a la visita actual, en curso. La propiedad hace referencia al mismo objeto que Kameleoon.API.CurrentVisit.
previousVisit	Object	Objeto 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 correspondiente al dispositivo del visitante para esta visita.
geolocation	Object	Objeto Geolocation correspondiente a la ubicación del visitante para esta visita.
weather	Object	Objeto Weather correspondiente al clima del visitante para esta visita.
activatedExperiments	Array	Lista de objetos ExperimentActivation, que corresponden a todos los experimentos que el motor activó en esta visita.
activatedPersonalizations	Array	Lista de objetos 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 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 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).

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.

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

APIs

​Configuration

​Visitor

​Visit

​Device

​Geolocation

​Weather

Configuration

Visitor

Visit

Device

Geolocation

Weather