Skip to main content
Su CRM o plataforma de datos de clientes suele contener datos de visitantes, como un segmento o intereses de producto, que Kameleoon no puede leer por sí solo. Los endpoints de map de la Data API almacenan esos datos para una clave determinada, normalmente un código de visitante o un ID de usuario interno. Después, un punto de datos personalizado recibe cada valor almacenado en su sitio web, y un segmento puede incluir únicamente a los visitantes que tienen ese valor.

Enviar datos de usuario a Kameleoon

Para almacenar datos de una o varias claves, envíe un objeto JSON al endpoint POST /map/maps, con una entrada por cada clave. Cada entrada puede contener varios campos, como userSegment y categoryAffinities. También puede usar los endpoints de map para recuperar los datos almacenados de una clave.
Tabla que muestra los datos de usuario enviados desde una herramienta de terceros a Kameleoon, y los experimentos web, las personalizaciones web y los experimentos de funcionalidades que pueden utilizarlos.
Example of payload:
Example of request:

Recuperar datos de usuario en Kameleoon

Para usar los datos almacenados en una campaña, cree un punto de datos personalizado y, a continuación, defina su valor desde el script global de su sitio web con el método retrieveDataFromRemoteSource de la Activation API de Kameleoon. Todos los SDK de Kameleoon utilizan el mismo método.

Crear un punto de datos personalizado

Para recibir los datos de usuario, cree un punto de datos personalizado con el método de recuperación Kameleoon Activation API.
  1. Haga clic en Settings > Custom Data, y a continuación en New custom data.
  2. Asigne un nombre a sus datos personalizados.
  3. Seleccione su proyecto.
  4. Seleccione Kameleoon Activation API como método de recuperación.
  5. Elija el tipo List y el formato String.
  6. Elija el ámbito Page.
  7. Haga clic en Next.
Ventana emergente New custom data con el método de recuperación Kameleoon Activation API, el tipo List, el formato String y el ámbito Page seleccionados.
Evite usar el método de recuperación Custom JavaScript code con estos datos. La opción Custom JavaScript code debe devolver un valor de forma síncrona, por lo que no puede llamar al método asíncrono retrieveDataFromRemoteSource.

Definir los datos personalizados desde su script global

Añada este código al script global de su sitio web, que se carga en todas las páginas. Reemplace NAME_OF_YOUR_CUSTOMDATA por el nombre de sus datos personalizados y NAME_OF_YOUR_USER_ID por la clave que almacenó con el endpoint Map.
El ejemplo define el campo userSegment de los datos almacenados. Cree un punto de datos personalizado independiente para cada campo que quiera segmentar.

Save the values for the targeting condition associated with the custom data point

Para elegir valores en el segment builder, active Save the values for the targeting condition associated with the custom data point en el paso Options. En el campo de código, devuelva un array de objetos. Cada objeto tiene un value, que debe coincidir con el tipo de los datos personalizados, y un label que muestra el segment builder. Añada un objeto por cada valor que el segment builder debe ofrecer.
Paso Options con el interruptor Save the values for the targeting condition activado y un campo de código que enumera los valores.
Haga clic en Next > Create. Para más detalles, consulte Crear datos personalizados.

Crear sus segmentos

Crear un segmento nuevo para su proyecto

Para crear un segmento que use sus datos personalizados, cree primero el segmento y, a continuación, añada los datos personalizados como condición.
  1. Haga clic en Settings > Segments, y a continuación en New segment.
  2. Asigne un nombre a su segmento.
  3. Seleccione su proyecto.
  4. Seleccione Campaign type y, a continuación, elija All types.
  5. Haga clic en Next.
Ventana emergente New segment con los campos de nombre del segmento, proyecto, Campaign type y descripción.

Añadir una condición de datos personalizados a su segmento

Para segmentar visitantes según los datos personalizados, úselos como condición en su segmento. En el segment builder, expanda Technical en la columna Conditions y, a continuación, haga doble clic en la condición de datos personalizados para añadirla. En el campo Include visitors with, seleccione su punto de datos personalizado y elija is among the values. Marque cada valor que debe incluir el segmento. La lista muestra los valores que guardó al crear los datos personalizados.
Segment builder con una condición de datos personalizados definida como is among the values, que muestra los valores guardados.

Usar el segmento en una campaña

Un segmento controla qué visitantes incluye su campaña. En un experimento, seleccione Target a segment en el paso Targeting del panel de finalización. En una personalización, haga clic en Target a segment en el panel Segments del paso Targeting. Para ver los pasos completos, consulte Configurar un segmento en una campaña.