Comprobar exposiciones a experimentos, custom data y eventos de conversión

La Data API de Kameleoon es una API REST que ofrece varias funcionalidades, incluido el almacenamiento y recuperación de datos específicos de usuarios externos y la gestión de conversiones de objetivos offline. Utilice la Data API para determinar si Kameleoon ha recibido eventos de visita enviados automáticamente por Kameleoon o a través de los métodos de la Activation API o del SDK. Este artículo explica cómo utilizar el endpoint GET visit/visitor de la Data API para comprobar si determinados tipos de eventos han sido ingeridos por Kameleoon. Esta verificación resulta especialmente útil al probar el código de tracking. Las siguientes secciones explican cómo comprobar estos eventos de forma programática:

Eventos de exposición a experimentos
Eventos de custom data
Eventos de conversión

Parámetros del evento

Como se ha mencionado anteriormente, todas las solicitudes deben hacerse al endpoint GET visit/visitor de la Data API. Los parámetros estándar para las solicitudes de eventos de Exposición a experimentos, Custom data y Conversión incluyen: Ya sea:

visitorCode (string): ID único de Kameleoon para un visitante. Obligatorio si no se proporciona mappingValue.

mappingValue (string): Valor del custom data configurado como identificador de mapeo (actuando como un ID cross-device del visitante) si procede. Obligatorio si no se proporciona visitorCode.
siteCode (string): Una cadena única de letras y números que identifica un proyecto de Kameleoon. Recupere este código a través de este enlace.
currentVisit (string | opcional): Establecido en true para recibir datos relacionados con las visitas en curso. Solo los usuarios que utilizan Feature Experimentation pueden solicitar datos sobre las visitas activas.
Dependiendo del evento específico solicitado, cada solicitud debe incluir un parámetro booleano adicional establecido en true: o bien experiment, customdata o conversion, como se muestra en los ejemplos siguientes.

Solicitudes de eventos

A continuación se muestran ejemplos del formato utilizado para las solicitudes y respuestas, específicos para cada evento:

Para obtener una salida más legible, incluya el parámetro prettyPrint=true en el encabezado de la solicitud.

Exposición a experimentos

Solicitud

curl -X GET 'https://eu-data.kameleoon.io/visit/visitor?siteCode=f17c21u1ag&visitorCode=245fc&currentVisit=true&maxNumberPreviousVisits=20&experiment=true'

Respuesta

{
	"previousVisits": [
    	{
        	"siteCode": "f17c21u1ag",
        	"visitorCode": "245fc",
        	"timeStarted": 1748912914969,
        	"timeLastEvent": 1748912914969,
        	"experimentEvents": [
                {
                    "itp": false,
                    "tabId": -218793282,
                    "time": 1748977476606,
                    "data": {
                       "id": 250830,
                       "variationId": 978588
                    }
                }
            ]
    	}
	]
}

En la respuesta de ejemplo, id representa el ID del experimento, mientras que variationId es la variación concreta del experimento a la que está expuesto el visitante.

Custom data

Solicitud

curl -X GET 'https://eu-data.kameleoon.io/visit/visitor?siteCode=f17c21u1ag&visitorCode=245fc&currentVisit=true&maxNumberPreviousVisits=20&customdata=true'

Respuesta

{
	"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
            ]
    	}
	]
}

En la respuesta de ejemplo, index es el ID único del custom data.

Conversión

Solicitud

curl -X GET 'https://eu-data.kameleoon.io/visit/visitor?siteCode=f17c21u1ag&visitorCode=245fc&currentVisit=true&maxNumberPreviousVisits=20&conversion=true'

Respuesta

{
	"previousVisits": [
    	{
        	"siteCode": "f17c21u1ag",
        	"visitorCode": "245fc",
        	"timeStarted": 1748912914969,
        	"timeLastEvent": 1748912914969,
        	"conversionEvents": [
            	{
                	"itp": false,
                	"time": 1748912914969,
                	"data": {
                    	"goalId": 361517,
                    	"revenue": 23.5,
                    	"negative": false,
                    	"metadata": {}
                	}
            	}
        	]
    	}
	]
}

​Parámetros del evento

​Solicitudes de eventos

​Exposición a experimentos

​Custom data

​Conversión

Parámetros del evento

Solicitudes de eventos

Exposición a experimentos

Custom data

Conversión