Configuration
Un objet Configuration contient les valeurs de constantes globales liées à la configuration actuelle de Kameleoon sur ce site. Properties| Name | Type | Description |
|---|---|---|
| siteCode | String | Le code de site unique correspondant au fichier d’application Kameleoon installé sur le site web. Il s’agit d’une chaîne de 10 caractères aléatoires (lettres minuscules et chiffres). |
| singlePageSupport | Boolean | Définie sur true si Single Page Support est configuré. Vous le configurez globalement dans l’application Kameleoon ou avec Kameleoon.API.Core.enableSinglePageSupport(). Single Page Support garantit que les changements d’URL déclenchent Kameleoon.API.Core.load() sans rechargement de la page dans le navigateur. |
| goals | Array | Liste des objets Goal représentant tous les objectifs actifs (configurés) de ce site. |
| generationTime | Number | Heure de la dernière génération du fichier d’application Kameleoon (format UTC - ms depuis le 1er janvier 1970). |
Visitor
Un objet Visitor contient des données portées par le visiteur indépendantes des visites spécifiques. Cet objet inclut une liste de tous les objets Visit pour le visiteur. Properties| Name | Type | Description |
|---|---|---|
| code | String | Le code de visiteur généré aléatoirement. À moins qu’une valeur personnalisée n’ait été spécifiquement définie sur le serveur (via un SDK côté serveur Kameleoon), c’est une chaîne de 16 caractères aléatoires (lettres minuscules et chiffres). |
| numberOfVisits | Number | Nombre total de visites pour le visiteur. Cette valeur peut dépasser visits.length, car l’API Activation ne conserve que les 25 dernières visites. |
| firstVisitStartDate | Number | Date de début (en millisecondes UNIX) pour la première visite. Cette valeur peut ne pas correspondre à visits[0].startDate, car l’API Activation ne conserve que les 25 dernières visites. |
| visits | Array | Liste de tous les objets Visit effectués par ce visiteur sur votre site Web, avec un maximum de 25 visites. Si ce visiteur a effectué plus de 25 visites, seules les 25 dernières sont disponibles via cette propriété. |
| currentVisit | Object | Objet Visit correspondant à la visite en cours. La propriété référence le même objet que Kameleoon.API.CurrentVisit. |
| previousVisit | Object | Objet Visit correspondant à la visite précédente. Si la visite précédente n’existe pas (c’est-à-dire que la visite actuelle est la première), cette propriété est null. |
| customData | Object | Mappage de toutes les données personnalisées avec une portée VISITOR. Les clés de la mappage sont les noms de données personnalisées définis. Cette mappage inclut uniquement les données personnalisées que vous avez définies dans l’application Kameleoon avec une portée VISITOR. Vous pouvez accéder à d’autres données personnalisées à partir d’un objet Visit. |
| experimentLegalConsent | Boolean | Lorsque la valeur est true, le moteur a obtenu le consentement légal (ou celui-ci n’est pas requis) pour activer les expériences du visiteur. Cette propriété vaut null si le visiteur n’a ni donné ni refusé son consentement. |
| personalizationLegalConsent | Boolean | Lorsque la valeur est true, le moteur a obtenu le consentement légal (ou celui-ci n’est pas requis) pour activer les personnalisations du visiteur. Cette propriété vaut null si le visiteur n’a ni donné ni refusé son consentement. |
Visit
Un objet Visit représente une visite unique et contient les informations en temps réel que Kameleoon collecte. Les points de données incluent le contexte de visite (appareil, localisation), le comportement observé (durée, pages vues) et les opérations Kameleoon, tel que les expériences déclenchées ou les personnalisations. Properties| Name | Type | Description |
|---|---|---|
| index | Number | Index de la visite. La première visite d’un visiteur donné a un index de 0. Comme l’API Activation ne conserve que les 25 dernières visites, Kameleoon.API.Visitor.visits[0].index pourrait ne pas être égal à 0. |
| startDate | Number | Date (format UTC - ms depuis le 1er janvier 1970) du début de la visite. |
| duration | Number | Durée de cette visite en ms. S’il s’agit de la visite en cours, cette valeur est toujours à jour (le moteur la recalcule à chaque lecture). |
| pageViews | Number | Nombre de pages consultées pendant la visite. Dans les SPA, l’appel de Kameleoon.API.Core.load() incrémente ce nombre. Les changements d’URL déclenchent automatiquement cet appel si vous activez Single Page Support. |
| locale | String | Paramètre régional du navigateur du visiteur. |
| device | Object | Objet Device correspondant à l’appareil du visiteur pour cette visite. |
| geolocation | Object | Objet Geolocation correspondant à la localisation du visiteur pour cette visite. |
| weather | Object | Objet Weather correspondant à la météo du visiteur pour cette visite. |
| activatedExperiments | Array | Liste des objets ExperimentActivation, correspondant à toutes les expériences que le moteur a activées pendant cette visite. |
| activatedPersonalizations | Array | Liste des objets PersonalizationActivation, correspondant à toutes les personnalisations que le moteur a activées pendant cette visite. |
| conversions | Object | Dictionnaire des conversions réalisées pendant cette visite. Les clés du dictionnaire sont les ID des objectifs définis. Les valeurs sont des objets comportant deux clés : count (nombre de fois où la visite a converti cet objectif) et revenue (revenu total de cet objectif pour cette visite). |
| customData | Object | Mappage de toutes les données personnalisées avec une portée PAGE ou VISIT. Les clés de la mappage sont les noms de données personnalisées définis. Cette mappage inclut uniquement les données personnalisées que vous avez définies dans l’application Kameleoon avec une portée PAGE ou VISIT. Vous pouvez accéder à d’autres données personnalisées à partir de l’objet Visitor. |
| currentProduct | Object | Objet Product correspondant au produit affiché sur la page produit actuelle. Si le visiteur ne se trouve pas sur une page produit, cette propriété vaut null. |
| products | Array | Liste des objets Product correspondant à toutes les pages produit consultées pendant la visite (y compris currentProduct, le cas échéant). |
| acquisitionChannel | String | Nom du canal d’acquisition de la visite. Vous définissez la liste des canaux d’acquisition et leurs caractéristiques (principalement la manière dont Kameleoon peut les déduire, par exemple via un paramètre d’URL) dans l’application Kameleoon. |
| landingPageURL | String | URL de la première page de la visite, généralement appelée page de destination. |
| initialConversionPredictions | Object | Carte des scores de conversion Kameleoon (KCS). Les clés de la carte sont les noms de moment clé définis. Les valeurs vont de 0 à 100, représentant le KCS pour le moment clé désigné. (Remarque : Kameleoon a récemment changé « key moment » en « triggers » dans l’application Kameleoon.) |
La propriété
kameleoonConversionScores n’est disponible qu’avec le module complémentaire Contextual Bandit & AI Targeting Premium.Device
Un objet Device contient des données sur l’appareil pour une visite donnée. Properties| Name | Type | Description |
|---|---|---|
| browser | String | Nom du navigateur. Les valeurs possibles sont : 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 du navigateur. |
| os | String | Nom du système d’exploitation. Les valeurs possibles sont : Windows, Mac, Linux, Android, iOS, Chrome OS, Windows Phone. |
| type | String | Type d’appareil. Les valeurs possibles sont : Desktop, Tablet, Phone. |
| screenHeight | Number | Hauteur de l’écran de l’appareil (en pixels). |
| screenWidth | String | Largeur de l’écran de l’appareil (en pixels). |
| windowHeight | Number | Hauteur de la fenêtre du navigateur (en pixels). |
| windowWidth | String | Largeur de la fenêtre du navigateur (en pixels). |
| adBlocker | Boolean | Booléen égal à true si cet appareil dispose d’un bloqueur de publicités actif, sinon à false. |
| timeZone | String | Fuseau horaire du navigateur. La valeur est une chaîne (par exemple, « Europe/Paris ») qui correspond à la base de données TZ des fuseaux horaires. |
Geolocation
Un objet Geolocation contient des données sur la localisation physique du visiteur pour une visite donnée. Properties| Name | Type | Description |
|---|---|---|
| country | String | Country name, in English. |
| region | String | Nom de la région, dans la langue préférée du pays. |
| city | String | Nom de la ville, dans la langue préférée du pays. |
| postalCode | String | Postal code. |
| latitude | Number | Latitude (in degrees). |
| longitude | Number | Longitude (in degrees). |
Weather
Un objet Weather contient des données sur les conditions météorologiques au moment de la visite. Properties| Name | Type | Description |
|---|---|---|
| temperature | String | Temperature in Kelvin. |
| humidity | String | Humidité en pourcentage (de 0 à 100). |
| pressure | String | Atmospheric pressure in hPa. |
| windSpeed | String | Wind speed in meters/sec. |
| cloudiness | Number | Nébulosité en pourcentage (de 0 à 100). |
| sunrise | Number | Heure du lever du soleil (format UTC, en ms depuis le 1er janvier 1970). |
| sunset | Number | Heure du coucher du soleil (format UTC, en ms depuis le 1er janvier 1970). |
| conditionCode | Number | Weather condition ID code. La liste de référence complète est disponible ici. |
| conditionDescription | String | Description de la condition météorologique qui correspond au conditionCode. Par exemple, un conditionCode de 800 a une conditionDescription de clear sky. |