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

> Referenz der Objekte Configuration, Visitor, Visit, Device, Geolocation und Weather.

Diese Objekte beschreiben die Website-Konfiguration und den Besucher. Das Visitor-Objekt enthält alle Besuche, die Kameleoon für diesen Besucher erfasst.

## Configuration

Ein Configuration-Objekt enthält globale konstante Werte, die sich auf die aktuelle Konfiguration von Kameleoon auf dieser Website beziehen.

**Properties**

| Name | Type | Description |
| - | - | - |
| siteCode | String | Die eindeutige Site-Code, die der auf der Website installierten Kameleoon-Anwendungsdatei entspricht. Sie besteht aus 10 zufälligen Zeichen (Kleinbuchstaben und Ziffern). |
| singlePageSupport | Boolean | Auf **true** setzen, wenn Single Page Support konfiguriert ist. Sie konfigurieren es global in der Kameleoon-App oder mit `Kameleoon.API.Core.enableSinglePageSupport()`. Single Page Support sorgt dafür, dass URL-Änderungen `Kameleoon.API.Core.load()` auslösen, ohne dass die Browserseite neu geladen werden muss. |
| goals | Array | Liste der [Goal-Objekte](https://docs.kameleoon.com/de/developer-docs/apis/activation-api-js/api-reference/objects/goal-segment-trigger-and-product.md#goal), die alle aktiven (konfigurierten) Ziele dieser Website darstellen. |
| generationTime | Number | Zeit der letzten Erzeugung der Kameleoon-Anwendungsdatei (UTC-Format - ms seit 1. Januar 1970). |

## Visitor

Ein Visitor-Objekt enthält besucherspezifische Daten unabhängig von bestimmten Besuchen. Dieses Objekt umfasst eine Liste aller [Visit objects](#visit) für den Besucher.

**Properties**

| Name | Type | Description |
| - | - | - |
| code | String | Der zufällig generierte Besuchercode. Es ist eine Zeichenkette von 16 Zufallszeichen (Kleinbuchstaben und Ziffern), es sei denn, ein benutzerdefinierter Wert wurde speziell auf dem Server gesetzt (über ein Kameleoon Server-seitiges SDK). |
| numberOfVisits | Number | Gesamtbesuche für den Besucher. Dieser Wert kann `visits.length` übersteigen, da die Activation API nur die neuesten 25 Besuche behält. |
| firstVisitStartDate | Number | Startdatum (UNIX-Millisekunden) für den ersten Besuch. Dieser Wert stimmt möglicherweise nicht mit `visits[0].startDate` überein, da die Activation API nur die letzten 25 Besuche speichert. |
| visits | Array | Liste aller [Visit-Objekte](#visit), die dieser Besucher auf Ihrer Website durchgeführt hat, mit maximal 25 Besuchen. Wenn dieser Besucher mehr als 25 Besuche durchgeführt hat, sind nur die neuesten 25 über diese Eigenschaft verfügbar. |
| currentVisit | Object | [Visit-Objekt](#visit) des aktuellen, laufenden Besuchs. Die Eigenschaft verweist auf dasselbe Objekt wie **Kameleoon.API.CurrentVisit**. |
| previousVisit | Object | [Visit-Objekt](#visit), das dem vorherigen Besuch entspricht. Wenn es keinen vorherigen Besuch gab (d. h. der aktuelle Besuch ist der erste), ist diese Eigenschaft **null**. |
| customData | Object | Map aller benutzerdefinierten Daten mit Bereich **VISITOR**. Die Schlüssel der Map sind die definierten Namen für benutzerdefinierte Daten. Diese Map enthält nur benutzerdefinierte Daten, die Sie in der Kameleoon App mit Bereich **VISITOR** definiert haben. Sie können auf andere benutzerdefinierte Daten aus einem Visit-Objekt zugreifen. |
| experimentLegalConsent | Boolean | Wenn **true**, hat die Engine die gesetzliche Einwilligung erhalten (oder sie ist nicht erforderlich), damit der Besucher Experimente aktivieren kann. Diese Eigenschaft ist **null**, wenn der Besucher weder zugestimmt noch abgelehnt hat. |
| personalizationLegalConsent | Boolean | Wenn **true**, hat die Engine die gesetzliche Einwilligung erhalten (oder sie ist nicht erforderlich), damit der Besucher Personalisierungen aktivieren kann. Diese Eigenschaft ist **null**, wenn der Besucher weder zugestimmt noch abgelehnt hat. |

## Visit

Ein Visit-Objekt stellt einen einzelnen Besuch dar und enthält Echtzeit-Informationen, die Kameleoon sammelt. Datenpunkte umfassen Besuchskontext (Gerät, Standort), beobachtetes Verhalten (Dauer, Seitenaufrufe) und Kameleoon-Operationen, wie etwa ausgelöste Experimente oder Personalisierungen.

**Properties**

| Name | Type | Description |
| - | - | - |
| index | Number | Index des Besuchs. Der erste Besuch eines bestimmten Besuchers hat einen Index von 0. Da die Activation API nur die letzten 25 Besuche speichert, ist `Kameleoon.API.Visitor.visits[0].index` möglicherweise nicht gleich 0. |
| startDate | Number | Datum (UTC-Format - ms seit 1. Januar 1970) des Beginns des Besuchs. |
| duration | Number | Dauer dieses Besuchs in ms. Handelt es sich um den aktuellen Besuch, ist dieser Wert immer aktuell (die Engine berechnet ihn bei jedem Lesen neu). |
| pageViews | Number | Anzahl der während des Besuchs aufgerufenen Seiten. In SPAs erhöht der Aufruf von `Kameleoon.API.Core.load()` diese Zahl. URL-Änderungen lösen diesen Aufruf automatisch aus, wenn Sie Single Page Support aktivieren. |
| locale | String | Das Gebietsschema des Browsers des Besuchers. |
| device | Object | [Device object](#device) für das Gerät des Besuchers für diesen Besuch. |
| geolocation | Object | [Geolocation object](#geolocation) für den Standort des Besuchers für diesen Besuch. |
| weather | Object | [Weather object](#weather) für das Wetter des Besuchers für diesen Besuch. |
| activatedExperiments | Array | Liste der [ExperimentActivation-Objekte](https://docs.kameleoon.com/de/developer-docs/apis/activation-api-js/api-reference/objects/experiment-and-personalization.md#experimentactivation), die allen Experimenten entsprechen, die die Engine bei diesem Besuch aktiviert hat. |
| activatedPersonalizations | Array | Liste der [PersonalizationActivation-Objekte](https://docs.kameleoon.com/de/developer-docs/apis/activation-api-js/api-reference/objects/experiment-and-personalization.md#personalizationactivation), die allen Personalisierungen entsprechen, die die Engine bei diesem Besuch aktiviert hat. |
| conversions | Object | Zuordnung der Conversions, die bei diesem Besuch erfolgt sind. Die Schlüssel der Zuordnung sind die definierten Ziel-IDs. Die Werte sind Objekte mit zwei Schlüsseln: **count** (Anzahl der Male, die der Besuch dieses Ziel konvertiert hat) und **revenue** (Gesamtumsatz dieses Ziels für diesen Besuch). |
| customData | Object | Map aller benutzerdefinierten Daten mit Bereich **PAGE** oder **VISIT**. Die Schlüssel der Map sind die definierten Namen für benutzerdefinierte Daten. Diese Map enthält nur benutzerdefinierte Daten, die Sie in der Kameleoon App mit Bereich **PAGE** oder **VISIT** definiert haben. Sie können auf andere benutzerdefinierte Daten aus dem Visitor-Objekt zugreifen. |
| currentProduct | Object | [Product-Objekt](https://docs.kameleoon.com/de/developer-docs/apis/activation-api-js/api-reference/objects/goal-segment-trigger-and-product.md#product), das dem Produkt auf der aktuellen Produktseite entspricht. Befindet sich der Besucher nicht auf einer Produktseite, ist diese Eigenschaft **null**. |
| products | Array | Liste der [Product-Objekte](https://docs.kameleoon.com/de/developer-docs/apis/activation-api-js/api-reference/objects/goal-segment-trigger-and-product.md#product), die allen Produktseiten entsprechen, die der Besuch aufgerufen hat (einschließlich **currentProduct**, falls zutreffend). |
| acquisitionChannel | String | Name des Akquisekanals für den Besuch. Die Liste der Akquisekanäle und ihre Merkmale (vor allem, wie Kameleoon sie erkennen kann, etwa über einen URL-Parameter) definieren Sie in der Kameleoon-App. |
| landingPageURL | String | URL der ersten Seite des Besuchs, üblicherweise als Landingpage bezeichnet. |
| initialConversionPredictions | Object | Zuordnung von Kameleoon Conversion Scores (KCS). Die Schlüssel der Zuordnung sind die definierten Key-Moment-Namen. Die Werte reichen von 0 bis 100 und stellen den KCS für den designierten Key-Moment dar. (Hinweis: Kameleoon hat "key moment" in der Kameleoon-App kürzlich in "triggers" geändert.) |

> [!NOTE]
>
> Die Eigenschaft `kameleoonConversionScores` ist nur mit dem Add-on Contextual Bandit & AI Targeting Premium verfügbar.

## Device

Ein Device-Objekt enthält Daten über das Gerät für einen bestimmten Besuch.

**Properties**

| Name | Type | Description |
| - | - | - |
| browser | String | Name des Browsers. Mögliche Werte sind: **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 | Version des Browsers. |
| os | String | Name des Betriebssystems. Mögliche Werte sind: **Windows**, **Mac**, **Linux**, **Android**, **iOS**, **Chrome OS**, **Windows Phone**. |
| type | String | Gerätetyp. Mögliche Werte sind: **Desktop**, **Tablet**, **Phone**. |
| screenHeight | Number | Höhe des Gerätebildschirms (in Pixeln). |
| screenWidth | String | Breite des Gerätebildschirms (in Pixeln). |
| windowHeight | Number | Höhe des Browserfensters (in Pixeln). |
| windowWidth | String | Breite des Browserfensters (in Pixeln). |
| adBlocker | Boolean | Boolescher Wert gleich **true**, wenn dieses Gerät einen aktiven Adblocker hat, andernfalls **false**. |
| timeZone | String | Zeitzone des Browsers. Der Wert ist eine Zeichenkette (z. B. "Europe/Paris"), die der [TZ-Datenbank der Zeitzonen entspricht.](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) |

## Geolocation

Ein Geolocation-Objekt enthält Daten über den physischen Standort des Besuchers für einen bestimmten Besuch.

**Properties**

| Name | Type | Description |
| - | - | - |
| country | String | Country name, in English. |
| region | String | Name der Region in der bevorzugten Sprache des Landes. |
| city | String | Name der Stadt in der bevorzugten Sprache des Landes. |
| postalCode | String | Postal code. |
| latitude | Number | Latitude (in degrees). |
| longitude | Number | Longitude (in degrees). |

## Weather

Ein Weather-Objekt enthält Daten über die Wetterbedingungen, die zum Zeitpunkt des Besuchs herrschen.

**Properties**

| Name | Type | Description |
| - | - | - |
| temperature | String | Temperature in Kelvin. |
| humidity | String | Luftfeuchtigkeit in Prozent (von 0 bis 100). |
| pressure | String | Atmospheric pressure in hPa. |
| windSpeed | String | Wind speed in meters/sec. |
| cloudiness | Number | Bewölkung in Prozent (von 0 bis 100). |
| sunrise | Number | Zeitpunkt des Sonnenaufgangs (UTC-Format, in ms seit dem 1. Januar 1970). |
| sunset | Number | Zeitpunkt des Sonnenuntergangs (UTC-Format, in ms seit dem 1. Januar 1970). |
| conditionCode | Number | Weather condition ID code. [Die vollständige Referenzliste ist hier verfügbar.](https://openweathermap.org/weather-conditions) |
| conditionDescription | String | Wetterbedingungsbeschreibung, die dem `conditionCode` entspricht. Beispielsweise hat ein `conditionCode` von **800** eine `conditionDescription` von **clear sky**. |
