Passer au contenu principal
La Data API de Kameleoon est une API REST qui offre plusieurs fonctionnalités, notamment le stockage et la récupération de données spécifiques aux utilisateurs externes et la gestion des conversions d’objectifs hors ligne. Utilisez la Data API pour déterminer si Kameleoon a reçu les événements de visite envoyés automatiquement par Kameleoon ou via les méthodes de l’Activation API ou du SDK. Cet article explique comment utiliser l’endpoint GET visit/visitor de la Data API pour vérifier si des types d’événements spécifiques ont été ingérés par Kameleoon. Cette vérification est particulièrement utile lors du test du code de tracking. Les sections suivantes expliquent comment vérifier ces événements de manière programmatique :

​
Paramètres d’événement

Comme mentionné ci-dessus, toutes les requêtes doivent être adressées à l’endpoint GET visit/visitor de la Data API. Les paramètres standards pour les requêtes d’exposition à une expérience, de custom data et d’événement de conversion incluent : Soit :
  • visitorCode (string) : ID unique de Kameleoon pour un visiteur. Requis si mappingValue n’est pas fourni.
OU
  • mappingValue (string) : valeur du custom data configuré comme identifiant de mapping (servant d’ID visiteur cross-device) le cas échéant. Requis si visitorCode n’est pas fourni.
  • siteCode (string) : chaîne unique de lettres et de chiffres qui identifie un projet Kameleoon. Récupérez ce code via ce lien.
  • currentVisit (string | optionnel) : définissez sur true pour recevoir des données relatives aux visites en cours. Seuls les utilisateurs de Feature Experimentation peuvent demander des données pour les visites actives.
  • En fonction de l’événement spécifique demandé, chaque requête doit inclure un paramètre booléen supplémentaire défini sur true : experiment, customdata ou conversion, comme illustré dans les exemples ci-dessous.

​
Requêtes d’événement

Voici des exemples du format utilisé pour les requêtes et les réponses, spécifiques à chaque événement :
Pour une sortie plus lisible, incluez le paramètre prettyPrint=true dans l’en-tête de la requête.

​
Exposition à une expérience

Requête 
curl -X GET 'https://eu-data.kameleoon.io/visit/visitor?siteCode=f17c21u1ag&visitorCode=245fc&currentVisit=true&maxNumberPreviousVisits=20&experiment=true'
Réponse 
{
	"previousVisits": [
    	{
        	"siteCode": "f17c21u1ag",
        	"visitorCode": "245fc",
        	"timeStarted": 1748912914969,
        	"timeLastEvent": 1748912914969,
        	"experimentEvents": [
                {
                    "itp": false,
                    "tabId": -218793282,
                    "time": 1748977476606,
                    "data": {
                       "id": 250830,
                       "variationId": 978588
                    }
                }
            ]
    	}
	]
}
Dans l’exemple de réponse, id représente l’ID de l’expérience, tandis que variationId est la variation spécifique de l’expérience à laquelle le visiteur est exposé.

​
Custom data

Requête 
curl -X GET 'https://eu-data.kameleoon.io/visit/visitor?siteCode=f17c21u1ag&visitorCode=245fc&currentVisit=true&maxNumberPreviousVisits=20&customdata=true'
Réponse 
{
	"previousVisits": [
    	{
        	"siteCode": "f17c21u1ag",
        	"visitorCode": "245fc",
        	"timeStarted": 1748912914969,
        	"timeLastEvent": 1748912914969,
        	"customDataEvents": [
                "itp": false,
                "tabId": 51426880,
                "time": 1748978024982,
                "data": {
                   "index": 1,
                   "valuesCountMap": {
                      "true":1
                      },
                    "overwrite": true,
                    "mappingIdentifier": false
                },
                "itp": false,
                "tabId": 51426880,
                "time": 1748978024982,
                "data": {
                   "index": 3,
                   "valuesCountMap": {
                      "1": 1},

                },
                "overwrite": false,
                "mappingIdentifier": false
            ]
    	}
	]
}
Dans l’exemple de réponse, index est l’ID unique du custom data.

​
Conversion

Requête 
curl -X GET 'https://eu-data.kameleoon.io/visit/visitor?siteCode=f17c21u1ag&visitorCode=245fc&currentVisit=true&maxNumberPreviousVisits=20&conversion=true'
Réponse 
{
	"previousVisits": [
    	{
        	"siteCode": "f17c21u1ag",
        	"visitorCode": "245fc",
        	"timeStarted": 1748912914969,
        	"timeLastEvent": 1748912914969,
        	"conversionEvents": [
            	{
                	"itp": false,
                	"time": 1748912914969,
                	"data": {
                    	"goalId": 361517,
                    	"revenue": 23.5,
                    	"negative": false,
                    	"metadata": {}
                	}
            	}
        	]
    	}
	]
}