Las soluciones de Web y Feature Experimentation de Kameleoon permiten segmentar usuarios basándose en datos externos almacenados en otros sistemas (como CRMs y CDPs), usando el endpoint Map de la Data API y los custom data.
Este tutorial trata sobre:
- Almacenamiento de datos externos de usuarios usando el endpoint POST Map.
- Lectura de datos de usuarios usando el endpoint GET Map. (Nota: Este paso utiliza un método de la Activation API para Web Experimentation que envuelve la Data API. Para Feature Experimentation, hay disponible un método similar en los SDKs de Kameleoon, que simplifica el proceso al evitar la lógica manual de llamada a la API).
- Aprovechamiento de los datos almacenados en un segmento de targeting utilizando custom data con experimentos.
Publicar datos usando el endpoint MAP de la DATA API
Como la Data API es una API REST, una solicitud POST al endpoint MAP almacena información adicional vinculada a una clave concreta —que normalmente representa un código de visitante o un ID interno de usuario proporcionado cuando un usuario visita el sitio web.
Puede obtener un token de autenticación para acceder al endpoint MAP siguiendo el mismo flujo que la Automation API con tokens JSON web (opcional). Para obtener más información sobre la autenticación y la limitación de velocidad, consulte este artículo.
siteCode: Una cadena de letras y números que identifica el proyecto de experimentación. Consulte este artículo para aprender cómo recuperarlo.- Objeto JSON: El cuerpo de la solicitud contiene un objeto formado por una lista de claves y los datos de usuario relevantes.
User-Agent: Las solicitudes identificadas como bots o spiders se rechazan según las reglas de filtrado de user-agent de IAB/ABC. Kameleoon utiliza un método de una sola pasada, lo que significa que no se requiere ninguna acción para las solicitudes provenientes de bibliotecas estándar de navegador web (como XHR). Sin embargo, establezca un valor personalizado de User-Agent para sobrescribir el valor por defecto de la biblioteca en otros casos.
curl -X POST -L 'https://eu-data.kameleoon.io/map/maps?siteCode=f17c21u1ag' \
-H 'Content-Type: application/json' \
-H 'User-Agent: MyCustomUserAgent/1.0' \
-d '{
"myUserID1": {
"audiencesNames": {
"premium": true
}
},
"myUserID2": {
"audiencesNames": {
"premium": false
}
},
...
}'
Una solicitud procesada no devuelve contenido. Para verificar el éxito, envíe una solicitud a este endpoint usando la siguiente URL: https://eu-data.kameleoon.io/map/map?siteCode=f17c21u1ag&key=myUserID1 Obtener datos usando retrieveDataFromRemoteSource (Activation API)
Con los datos almacenados en los servidores de Kameleoon, utilice los custom data para acceder a la información de las personas que visitan el sitio. Los custom data sirven como condición de targeting dentro de los segmentos de experimento.
En primer lugar, cree y configure los custom data en Kameleoon.
En el menú de la izquierda del dashboard de Kameleoon, haga clic en Custom data dentro de Configure:
Será redirigido al dashboard de custom data. Haga clic en New custom data en la esquina superior derecha.
Accederá a la ventana Edit the custom data.
Ejemplo: Cree un custom data llamado “Premium users” para los usuarios con un estado “premium” igual a true. Esta información se guardó en el paso anterior.
"audiencesNames": {
"premium": true
}
true, ajuste el método de recuperación a Custom JavaScript e inserte el siguiente código para el método retrieveDataFromRemoteSource en Paste a sample code:
Kameleoon.API.Data.retrieveDataFromRemoteSource(user_id, function (data) {
if (data && data.audiencesNames && data.audiencesNames.premium !== undefined) {
Kameleoon.API.Data.setCustomData("Premium users", data.audiencesNames.premium);
}});
return {"value": null};
user_id contiene el ID único del usuario.
Los proyectos que utilizan Kameleoon Feature Experimentation pueden usar el método del SDK getRemoteData() dentro del código del feature flag para recuperar los datos.
