Segmentar sus audiencias importadas - Kameleoon Documentation

Las integraciones con data warehouses están disponibles como complemento premium para nuestros módulos Web Experimentation y Feature Experimentation. Para obtener más información, póngase en contacto con su Customer Success Manager.

Actualmente, admitimos integraciones con data warehouses de los siguientes proveedores:

BigQuery
Snowflake
Redshift
Databricks

Próximamente añadiremos soporte para el siguiente proveedor:

Microsoft Azure

Para obtener más información y si quiere formar parte de nuestro programa early adopter, póngase en contacto con su Customer Success Manager.

Elegir su enfoque de segmentación

Elija el enfoque que corresponda a lo que quiere segmentar:

Segmentar una audiencia preconfigurada de una Ingestion Task (por ejemplo, todos los visitantes de “The Londoners”): siga Segmentar sus audiencias importadas en un experimento de Kameleoon. Crea un único dato personalizado que enumera todas las audiencias de las Ingestion Tasks y después crea segmentos a partir de él.
Segmentar un atributo de visitante concreto (por ejemplo, place_of_birth con muchas ciudades distintas): siga Segmentar audiencias importadas por atributos. Añade el atributo a la consulta SQL y crea un dato personalizado que contiene su valor.

Elija el método de adquisición del dato personalizado según su configuración de Kameleoon:

Kameleoon SDK method: solo para Feature Experimentation.
Custom JavaScript code: para Web Experimentation, o para Web Experimentation y Feature Experimentation a la vez.

Adquisición del dato personalizado describe ambos métodos.

Segmentar sus audiencias importadas en un experimento de Kameleoon

Este ejemplo estándar muestra el método más sencillo para segmentar sus audiencias importadas en un experimento de Kameleoon. Supongamos que tiene una tabla user en su warehouse, una muestra de la cual tiene este aspecto:

En este ejemplo, queremos segmentar a todos los usuarios nacidos en Londres. Esta audiencia requiere una Ingestion Task que puede configurar como se describe anteriormente. Llamaremos a esta Ingestion Task “The Londoners”. La consulta SQL para esta tarea será: SELECT id FROM user WHERE place_of_birth="LONDON" Para segmentar la audiencia consultada por esta (y todas las demás) Ingestion Tasks, debe pasar por la siguiente configuración.

Configurar una entrada de Kameleoon Custom Data

En el menú de la izquierda, haga clic en Configure > Custom data.

Haga clic en New custom data.
Proporcione un nombre para su dato personalizado.
Seleccione el proyecto en el que configuró la Data Ingestion Task.
Elija el método de adquisición Kameleoon SDK method o Custom JavaScript code.
- Consulte la siguiente sección dedicada a este parámetro aquí.
Elija List para el tipo y String para el formato.
Para el Scope, seleccione Visit.
Haga clic en Next.

Puede establecer los diferentes valores que aparecerán en la condición de segmentación que cree. Haga clic en Save the values for the targeting condition associated with the custom data point.

const sitecode= "YOUR_SITE_CODE"; //replace this value with your project's sitecode.
const xhr = new XMLHttpRequest();
 xhr.open('GET', `https://data.kameleoon.io/map/maps?siteCode=${sitecode}&keys=%5B%22warehouse%5Faudience%5Fconfig%22%5D`, false);
 xhr.send(null);
 if (xhr.status === 200) {
    const data = JSON.parse(xhr.responseText)
    if ("warehouse_audience_config" in data) {
       if ("audience_labels" in data["warehouse_audience_config"]) {
          return data["warehouse_audience_config"]["audience_labels"];
       }
    }
    return [];
 } else {
    console.error("Error calling for existing custom data values");
    return [];
 }

Haga clic en Create.

Adquisición del dato personalizado

El método de adquisición del dato personalizado especifica qué código rellena el valor del dato personalizado y dónde se ejecuta ese código. Existen varias posibilidades de adquisición según su configuración de Kameleoon. Si está utilizando Feature Experimentation únicamente, puede seleccionar el Kameleoon SDK method. Cuando se utiliza este método, el código de adquisición se ejecutará en los puntos donde haya incluido métodos del SDK de Kameleoon. Estos métodos de Kameleoon recuperan las audiencias del warehouse a las que pertenece su visitante y almacenan esa información en la sección Custom Data. El fragmento de código preciso depende del SDK que esté utilizando. Aquí hay un ejemplo escrito con nuestro JavaScript SDK:

import { KameleoonClient } from '@kameleoon/javascript-sdk';
 const client = new KameleoonClient({ siteCode: 'my_site_code' });
 async function init() {
 await client.initialize();
 // -- Get visitor code
 const visitorCode = client.getVisitorCode();
 // -- Replace with the visitor ID your organization uses in your warehouse
 const warehouseVisitorId = 'YOUR_WAREHOUSE_VISITOR_ID';
 // -- Index of your custom data
 const customDataIndex = 10;
 // -- Get visitor warehouse audience data using `warehouseKey`
 // and add it to storage
 const customData = await getVisitorWarehouseAudience({
 visitorCode: visitorCode,
 customDataIndex: customDataIndex,
 warehouseKey: warehouseVisitorId,
 });
 }
 init();

Sustituya YOUR_WAREHOUSE_VISITOR_ID para que la variable warehouseVisitorId contenga el ID de visitante que su organización utiliza para este visitante en su warehouse. Este valor depende del sistema de identificación de visitantes de su organización (consulte Identificación del visitante). Si no tiene uno, puede utilizar el Kameleoon Visitor Code, pero también debe utilizar el Kameleoon Visitor Code en su warehouse. Sustituya el valor de customDataIndex por el índice de su dato personalizado. Puede encontrar el índice en el panel:

Si está utilizando Web Experimentation (o tanto Web Experimentation como Feature Experimentation), puede seleccionar Custom JavaScript code. En este caso, el fragmento de código se ejecutará por el archivo kameleoon.js. Puede añadir el siguiente fragmento al script global de su proyecto (en Admin > Configure > y luego editar el proyecto correspondiente):

// Replace with the visitor ID your organization uses in your warehouse
const warehouseVisitorId = 'YOUR_WAREHOUSE_VISITOR_ID';
Kameleoon.API.Data.retrieveDataFromRemoteSource(warehouseVisitorId, function(data) {
     if("warehouseAudiences" in data){
         Kameleoon.API.Data.setCustomData("My Warehouse Audiences", Object.keys(data["warehouseAudiences"]));
     }
});

En este caso, necesitamos utilizar el nombre de su Custom Data y no el índice, como en el ejemplo anterior del SDK. Alternativamente, puede introducir el siguiente fragmento en el campo apropiado al configurar el dato personalizado:

// Replace with the visitor ID your organization uses in your warehouse
const warehouseVisitorId = 'YOUR_WAREHOUSE_VISITOR_ID';
 if (typeof window.kameleoon_configured_warehouse_audiences === 'undefined') {
    window.kameleoon_configured_warehouse_audiences = null;
    Kameleoon.API.Data.retrieveDataFromRemoteSource(warehouseVisitorId, function(data) {
      if ("warehouseAudiences" in data) {
        window.kameleoon_configured_warehouse_audiences = Object.keys(data["warehouseAudiences"]);
      }
    });
 }
 if (window.kameleoon_configured_warehouse_audiences === null) {
    return null;
 }
 return {"value": window.kameleoon_configured_warehouse_audiences};

Esta es una configuración única que funcionará para todas sus Ingestion Tasks.

Por ejemplo, supongamos que tiene una segunda Ingestion Task que consulta a los visitantes nacidos en marzo, y la llama “Born in March”. El valor del dato personalizado para un visitante nacido en marzo y en Londres contendrá ambas audiencias (“The Londoners”, “Born in March”). Por tanto, puede utilizar este único dato personalizado para todos sus segmentos de Kameleoon que segmenten las audiencias de su warehouse. A continuación, puede utilizar este dato personalizado en sus campañas de Kameleoon (experimentos, experimentos de funcionalidades o personalizaciones) para segmentar a los usuarios en función de su pertenencia a una audiencia específica de su warehouse. Para crear dicho segmento, siga estos pasos:

Cree un segmento como se explica en la documentación específica.
En su segmento, utilice una condición de dato personalizado.
Al elegir el operador is among the values, debería ver la lista de audiencias asociadas a las Data Ingestion Tasks que creó: The Londoners, Born in March, etc.

Segmentar audiencias importadas por atributos

Esta sección explica un método alternativo para segmentar las audiencias que ha importado desde su warehouse. Este método es especialmente útil si quiere ejecutar experimentos separados que segmenten diferentes valores del mismo atributo de visitante. Mantendremos los mismos datos y caso de uso que en el ejemplo anterior, solo que esta vez queremos segmentar muchas ciudades de origen diferentes y no solo visitantes nacidos en Londres. Esta segmentación sería posible con la configuración descrita anteriormente: crearía una Ingestion Task para cada lugar de nacimiento que quiera segmentar. Sin embargo, esto podría resultar un poco tedioso si quiere segmentar 50 ciudades diferentes. Kameleoon le permite importar atributos de los visitantes en las audiencias de su warehouse. La importación se logra añadiendo campos adicionales a la consulta SQL después del campo de ID de visitante, así: SELECT id, place_of_birth FROM user A continuación, puede crear un Custom Data que, esta vez, contendrá el valor del atributo place_of_birth. Para la implementación con el JavaScript SDK, el código tiene este aspecto:

import { KameleoonClient } from '@kameleoon/javascript-sdk';
const client = new KameleoonClient({ siteCode: 'my_site_code' });
async function init() {
    await client.initialize();
    // -- Replace with the visitor ID your organization uses in your warehouse
    const warehouseVisitorId = 'YOUR_WAREHOUSE_VISITOR_ID';
    // -- Id of the ingestion task
    const taskId = "your_task_id";
    // -- Name of the attribute
    const attributeName = "place_of_birth";
    // -- Get remote data
    const jsonData = await getRemoteData(warehouseVisitorId);
    const data = JSON.parse(jsonData);
    if ("warehouseAudiences" in data){
        if (taskId in data["warehouseAudiences"]){
            const city = data["warehouseAudiences"][taskId][attributeName];
             // -- The index of the custom data you have created
             const customDataIndex = 10; // replace with your custom data index
             const customData = new CustomData(customDataIndex, city);
             // -- Add custom data
             client.addData(warehouseVisitorId, customData); 
         }
     }
}
init();

Alternativamente, este es el fragmento de código equivalente que puede utilizar al configurar el dato personalizado con el método de adquisición “Custom JavaScript code”:

// Replace with the visitor ID your organization uses in your warehouse
const warehouseVisitorId = 'YOUR_WAREHOUSE_VISITOR_ID';
const taskId = "your_task_id";
const attributeName = "place_of_birth";
// Unique storage key for this custom data, built from the attribute name and the task ID
const storageKey = "kameleoon_warehouse_" + attributeName + "_" + taskId;

 if (typeof window[storageKey] === 'undefined') {
     window[storageKey] = null;
     Kameleoon.API.Data.retrieveDataFromRemoteSource(warehouseVisitorId, function(data) {
         if ("warehouseAudiences" in data) {
             if (taskId in data["warehouseAudiences"]){
                  const city = data["warehouseAudiences"][taskId][attributeName];
                  window[storageKey] = city;
             }
         }
     });
 }
 if (window[storageKey] === null) {
     return null;
 }
 return {"value": window[storageKey]};

A continuación, puede crear un segmento de Kameleoon que segmente el nombre de la ciudad en el valor del dato personalizado. Si quiere segmentar varias ciudades en un solo segmento, puede añadir varias condiciones Or al mismo dato personalizado al crear el segmento. El fragmento almacena su resultado en una propiedad de window cuyo nombre se construye a partir de attributeName y taskId. Mantenga este nombre único para cada dato personalizado que cree, porque dos scripts de datos personalizados que comparten una propiedad de window se sobrescriben mutuamente el valor. El taskId es el Ingestion Task ID: el número único que Kameleoon asigna a la tarea. La lista de Data Ingestion Tasks muestra cada tarea como su ID seguido de su nombre, por ejemplo 543 Attributes. El ID es solo el número (543), no el nombre. Establezca taskId en ese número. Puede añadir tantos atributos de visitante como desee en la petición SQL y utilizar estos atributos de muchas maneras con nuestros SDKs.

Identificación del visitante

Las aplicaciones y sitios web modernos utilizan muchas herramientas externas y, a menudo, muchos identificadores de visitante. Para que esta funcionalidad funcione, el identificador de visitante que utilice en los ejemplos de código anteriores para recuperar el objeto JSON debe ser el mismo identificador extraído de su warehouse. Cómo se genera este identificador de visitante depende de usted. Hay muchas posibilidades. Puede utilizar identificadores que solo se obtienen después de que el usuario inicie sesión en su solución, como una dirección de correo electrónico. Puede utilizar identificadores anónimos si su negocio no requiere o admite el inicio de sesión. Incluso puede utilizar una mezcla de ambos si tiene un caso de uso en el que quiera segmentar a los usuarios independientemente de si han iniciado sesión o no. Usted está a cargo de su data warehouse y de gestionar la tabla desde la que Kameleoon consulta, por lo que no hay limitaciones, excepto que el identificador debe estar disponible para el seguimiento en algún momento. El equipo de Customer Success de Kameleoon puede asesorarle sobre cómo elegir un identificador en función de su configuración específica, herramientas externas y requisitos de negocio.

Integraciones

​Elegir su enfoque de segmentación

​Segmentar sus audiencias importadas en un experimento de Kameleoon

​Configurar una entrada de Kameleoon Custom Data

​Adquisición del dato personalizado

​Segmentar audiencias importadas por atributos

​Identificación del visitante

Elegir su enfoque de segmentación

Segmentar sus audiencias importadas en un experimento de Kameleoon

Configurar una entrada de Kameleoon Custom Data

Adquisición del dato personalizado

Segmentar audiencias importadas por atributos

Identificación del visitante