Saltar al contenido principal
Con esta integración, puede conectar Kameleoon con Segment de forma fluida para:
  • Utilizar Kameleoon como fuente para enviar datos de eventos de exposición de campañas (nombre de campaña y nombre de variación) a Segment, que pueden ser utilizados por otras plataformas disponibles en el marketplace de Segment.
  • Utilizar Kameleoon como destino para:
    • importar eventos de Segment, que puede usar en experimentos y personalizaciones web de Kameleoon.
    • importar personas, traits y grupos de Segment, y usarlos en nuestro Segment Builder a través de datos personalizados.
Ventajas clave:
  • Envíe automáticamente cualquier dato, incluidos los KPIs, desde Segment a Kameleoon para crear campañas de optimización altamente rastreadas y segmentadas.
  • Mejore la segmentación y analice los resultados de sus tests A/B/n con los datos de eventos de Segment.
  • Analice el efecto de las campañas de prueba en todo el recorrido del cliente.
  • Llegue a los visitantes expuestos a una campaña online en otros canales (por ejemplo, campañas de email marketing, aplicaciones móviles) utilizando los eventos de Segment enviados por Kameleoon.

​
Enviar eventos de exposición de Kameleoon a Segment

​
Habilitar la integración de Segment en Kameleoon

  1. Inicie sesión en la aplicación de Kameleoon.
  2. Haga clic en Admin > Integrations > Install the tool.
  3. Seleccione los proyectos en los que quiere configurar Segment.
  4. Haga clic en Validate.
Verá entonces un interruptor ON a la derecha de la línea de la herramienta y el número de proyectos en los que está configurada.
Asegúrese de que el script de Segment (analytics.js) esté instalado en sus páginas, ya que Kameleoon enviará los eventos de exposición de campañas a Segment utilizando la JavaScript API de Segment.

​
Asociar Segment como herramienta de informes en un experimento o personalización de Kameleoon

Una vez activada la integración en la página de integraciones, puede seleccionarla como herramienta de informes en la pestaña Integrations del panel de finalización del editor gráfico/de código.
Cuando haya activado y definido Segment como herramienta de informes en una campaña, se enviará automáticamente un evento llamado “Experiment viewed” cada vez que un visitante vea una variación de un experimento A/B activo de Kameleoon.
Si necesita enviar eventos de exposición para feature flags, debe habilitar las funcionalidades híbridas.

​
Obtener el sitecode de su proyecto

También necesitará obtener su sitecode en su cuenta de Kameleoon. Para aprender cómo encontrar su sitecode, lea esta documentación.

​
Introducir esta información al configurar Kameleoon como destino en su aplicación de Segment

  1. Desde el Destinations Catalog en la aplicación de Segment, haga clic en Add Destination.
  2. Busque Kameleoon en el Destinations Catalog y seleccione el destino Kameleoon.
  1. Haga clic en Configure Kameleoon.
  2. Elija la Source (por ejemplo, aplicación o sitio web) que enviará los datos al destino Kameleoon.
  3. Introduzca la API Key y el sitecode en la configuración del destino Kameleoon en Segment.

​
Hacer coincidir usuarios entre Kameleoon y Segment

La integración requiere que utilice el mismo sistema de identificadores para ambas herramientas, lo que significa que el valor userId que pasa a Segment debe ser el mismo valor que utiliza Kameleoon para identificar a un “visitor”. Si utiliza Kameleoon Web Experiment, Kameleoon coloca una cookie que contiene un identificador único anónimo, llamado el visitorCode de Kameleoon, asignado aleatoriamente a un visitante. Este ID se utiliza para identificar de forma única a un usuario en un navegador. Tiene varias opciones disponibles:
  • Puede pasar nuestro visitorCode en la propiedad userId de la llamada identify de Segment para garantizar que Kameleoon pueda atribuir todos los datos de eventos recibidos de Segment al visitante correcto.
  • Puede pasar nuestro visitorCode en una llamada adicional de Segment del siguiente modo: analytics.track('Kameleoon identifier', {'k_visitorCode': Kameleoon.API.Visitor.code}). Kameleoon enlazará automáticamente el user ID o ID anónimo de Segment con nuestro propio visitorCode. Asegúrese de llamarlo solo una vez por sesión. Por ejemplo, si utiliza Kameleoon Web Experimentation, o ha implementado nuestro archivo de aplicación de Kameleoon (kameleoon.js) para beneficiarse de las funcionalidades de experimentación híbrida, puede utilizar el siguiente ejemplo de código en la sección Global custom script de la propiedad del proyecto de Kameleoon.
Kameleoon.API.Core.runWhenConditionTrue(
     () => window.analytics && window.analytics.track && window.analytics.user,
     () => {
         const kSegmentioIdentifier = window.localStorage.getItem('k_segmentio_identifier');
         if(kSegmentioIdentifier && kSegmentioIdentifier === window.analytics.user().anonymousId()) return;
         window.localStorage.setItem('k_segmentio_identifier', window.analytics.user().anonymousId());
         window.analytics.track('Kameleoon identifier', {'k_visitorCode': Kameleoon.API.Visitor.code})
     }
 );
Si utiliza Kameleoon Feature Experimentation, consulte la documentación del SDK de Kameleoon, ya que puede establecer su propio ID en lugar de utilizar un código de visitante de Kameleoon generado y tener el mismo ID exacto entre Segment y Kameleoon.

​
Eventos y Personas de Segment compatibles

Kameleoon admite los siguientes métodos: Track, Identify, Page, Screen y Group, como se especifica en la Segment Spec. Si el nombre del evento de Segment coincide con el nombre de un objetivo existente en su cuenta de Kameleoon, se asociará una conversión para este objetivo con el visitante. Si el objetivo no existe, Kameleoon creará un objetivo personalizado utilizando el nombre del evento de Segment y asociará la conversión con el visitante. El objetivo aparecerá en la página de objetivos de Kameleoon con la convención de nombres SegmentIO [eventType] - [eventName]. Una vez creado el objetivo, puede utilizarlo en cualquiera de sus campañas. Las llamadas track de Segment del tipo Audience Entered, Audience Exited, Identify y Group. Estas se recogen como un dato personalizado de Kameleoon. Segment utiliza el endpoint map de nuestra Data API para enviar datos a Kameleoon.

​
Personas, traits y grupo

Kameleoon le permite segmentar a los usuarios en función de su Segment persona, grupo o propiedades específicas. Para utilizar personas, traits e IDs de grupo en nuestro Segment builder, debe configurar un dato personalizado en su cuenta de Kameleoon para el proyecto que elija.
Personas
Puede nombrar su persona (por ejemplo, SegmentIO personas) y el dato personalizado debe ser de tipo List of string.
Siga las siguientes pautas solo para Web Experimentation.
Puede utilizar el siguiente código en el método de adquisición del dato personalizado: 
window.k_segmentIO = window.k_segmentIO || {};
 if(!window.k_segmentIO.runtime)
 {
     window.k_segmentIO.runtime = true;
Dependiendo de su configuración, debe determinar la lógica adecuada para obtener el user ID. Si ha estado usando una llamada de evento track para enviar nuestro código de visitante, use la siguiente línea: const user_id = Kameleoon.API.Visitor.code; Alternativamente, si utiliza nuestro Visitor Code como el user ID de Segment o necesita recuperar el user ID del objeto analytics de Segment, utilice el siguiente código: 
const user_id = window.analytics.user().id() || window.analytics.user().anonymousId();

Kameleoon.API.Data.retrieveDataFromRemoteSource(`COHORTS_${user_id}`, cohorts => {     window.k_segmentIO.cohorts = cohorts && cohorts !== '{}' ? Object.keys(cohorts).filter(key => cohorts[key]) : []; });``
 }
 if(!window.k_segmentIO.cohorts || !window.k_segmentIO.cohorts.length) return;
 return {"value": window.k_segmentIO.cohorts, "overwrite": true};
Para utilizar personas de Segment en experimentos del lado del servidor o feature flags, puede consultar las pautas descritas en la documentación de cada SDK.Nuestros SDKs emplean el método getRemoteData(). Este método recupera los datos almacenados por Segment en nuestros servidores y los hace accesibles en el código de su backend.El valor “key” a utilizar como primer parámetro debe seguir este formato: COHORTS_{user_id}.
Obtener los nombres de Personas de Segment en Kameleoon
Haga clic en Next y active la opción Save the values for the targeting condition associated with the custom data point. Añada el siguiente código JS y sustituya XXXXXXXXX por el Sitecode de Kameleoon. Para encontrarlo, siga esta documentación. 
var xhr = new XMLHttpRequest();
xhr.open("GET", '[https://api-data.kameleoon.com/data?key=common&siteCode=XXXXXXXXX](https://api-data.kameleoon.com/data?key=common&siteCode=XXXXXXXXX)', false);
var SegmentIOPersonas = [];
xhr.onreadystatechange = function() { 
   if(this.readyState === 4) {
     var segmentIOcohorts = JSON.parse(xhr.response);
	  if (segmentIOcohorts && segmentIOcohorts.cohorts) {
		  segmentIOcohorts.cohorts.forEach(persona => SegmentIOPersonas.push({value: persona, label: persona}) );

	   }
   }
}
xhr.send();
return SegmentIOPersonas;
Haga clic en Validate para crear el dato personalizado. ¡Eso es todo! Ahora puede utilizar Segment Personas en nuestro Segment builder. La lista de personas disponibles aparece cuando elige el operador is among the values.
Traits
Para utilizar traits en nuestro segment builder, debe crear un dato personalizado por tipo de trait. Supongamos que quiere segmentar a los usuarios en función del plan al que se han suscrito en su sitio web, y tiene tres planes diferentes: freemium, scale y enterprise. Debe configurar un dato personalizado llamado “Subscribed Plan”, y el dato personalizado debe ser de tipo “string”.
Siga las siguientes pautas solo para Web Experimentation.
Puede utilizar el siguiente código en el método de adquisición del dato personalizado: 
window.k_segmentIO = window.k_segmentIO || {};
 if(!window.k_segmentIO.runtime)
 {
     window.k_segmentIO.runtime = true;
Dependiendo de su configuración, deberá determinar la lógica adecuada para obtener el user ID. Si ha estado usando una llamada de evento track para enviar nuestro código de visitante, use la siguiente línea: const user_id = Kameleoon.API.Visitor.code; Alternativamente, si utiliza nuestro Visitor Code como el user ID de Segment o necesita recuperar el user ID del objeto analytics de Segment, utilice la siguiente línea: 
const user_id = window.analytics.user().id() || window.analytics.user().anonymousId(); 
   
  Kameleoon.API.Data.retrieveDataFromRemoteSource(`IDENTIFY_${user_id}`, segment_identify_properties => {
         if(segment_identify_properties && segment_identify_properties.traits && segment_identify_properties.traits.plan){
             window.k_segmentIO.plan = segment_identify_properties.traits.plan;
         }
     });
 }
 if(!window.k_segmentIO.plan) return;
 return {"value": window.k_segmentIO.plan, "overwrite": true};
Para utilizar traits en experimentos del lado del servidor o feature flags, puede consultar las pautas descritas en la documentación de cada SDK.Nuestros SDKs emplean el método getRemoteData(). Este método recupera los datos almacenados por Segment en nuestros servidores y los hace accesibles en el código de su backend.El valor “key” a utilizar como primer parámetro debe seguir este formato: IDENTIFY_{user_id}.
Puede seguir las mismas pautas para cada propiedad de trait que desee utilizar en el Segment builder de Kameleoon.
IDs de grupo
Para utilizar IDs de grupo en nuestro Segment builder para segmentar sus campañas, debe configurar un dato personalizado llamado “Group ID”, y el dato personalizado debe ser de tipo string.
Siga las siguientes pautas solo para Web Experimentation.
Puede utilizar el siguiente código en el método de adquisición del dato personalizado: 
window.k_segmentIO = window.k_segmentIO || {};
 if(!window.k_segmentIO.runtime)
 {
     window.k_segmentIO.runtime = true;
Dependiendo de su configuración, deberá determinar la lógica adecuada para obtener el user ID. Si ha estado usando una llamada de evento track para enviar nuestro código de visitante, use la siguiente línea: const user_id = Kameleoon.API.Visitor.code; Alternativamente, si utiliza nuestro Visitor Code como el user ID de Segment o necesita recuperar el user ID del objeto analytics de Segment, utilice la siguiente línea: 
const user_id = window.analytics.user().id() || window.analytics.user().anonymousId(); 
  
   Kameleoon.API.Data.retrieveDataFromRemoteSource(`IDENTIFY_${user_id}`, segment_identify_properties => {
         if(segment_identify_properties && segment_identify_properties.groupId){
             window.k_segmentIO.groupId = segment_identify_properties.groupId;
         }
     });
 }
 if(!window.k_segmentIO.groupId) return;
 return {"value": window.k_segmentIO.groupId, "overwrite": true};
Para utilizar traits en experimentos del lado del servidor o feature flags, puede consultar las pautas descritas en la documentación de cada SDK.Nuestros SDKs emplean el método getRemoteData(). Este método recupera los datos almacenados por Segment en nuestros servidores y los hace accesibles en el código de su backend.El valor “key” a utilizar como primer parámetro debe seguir este formato: IDENTIFY_{user_id}.