Segment destination actions

​

Importar eventos, traits, grupos y personas de Segment a Kameleoon

• Cada evento activado por Segment se enviará automáticamente a Kameleoon, lo que ahorra a los desarrolladores tiempo al evitar volver a implementar en Kameleoon un plan de seguimiento de Segment existente. Los eventos Page, Screen y Track se recogen automáticamente como un objetivo personalizado de Kameleoon. Puede usar cualquiera de ellos en sus experimentos/personalizaciones o para segmentar a los usuarios que realicen una acción específica en su sitio web o aplicación móvil.
• Los eventos Track del tipo Audience Entered o Audience exited se recogen como un dato personalizado de Kameleoon para utilizarse en nuestro Segment builder para segmentar a las personas de usuario.
• Los eventos Track del tipo identify con traits se recogen como datos personalizados de Kameleoon para utilizarse en nuestro Segment builder para segmentar a usuarios con traits específicos.
• Los eventos Track del tipo group se recogen como un dato personalizado de Kameleoon para utilizarse en nuestro Segment builder para segmentar un ID de grupo.

​

Consideraciones

• Debe habilitar esta integración en cada proyecto de Segment en el que quiera utilizarla.
• Necesita un plan de pago de Kameleoon para habilitar esta integración.
• Debe hacer coincidir sus usuarios de Segment con los visitantes de Kameleoon utilizando el mismo sistema de identificadores para ambas herramientas.
• Esta integración tiene limitaciones técnicas.
• Segment envía todas las propiedades de usuario, evento y grupo junto con el evento.

​

Limitaciones

• 1 MB de tamaño máximo de los datos del evento.
• No se pueden crear más de 50 objetivos de Kameleoon en un período de 10 segundos.
• No se pueden crear más de 1000 objetivos de Kameleoon en un período de 60 minutos.

​

Configuración

​

Requisitos previos

• REST API Key: Para empezar a enviar datos a Kameleoon, necesita su API Key. Consulte la sección Generar su API Key para obtener más ayuda.
• Sitecode: Debe proporcionar el Sitecode del proyecto que quiere utilizar con esta integración. Consulte la documentación específica de Kameleoon para saber dónde puede encontrar su Sitecode.

​

Configuración de Kameleoon

​

Generar su API Key

1. Obtenga su client ID y client secret. Puede encontrarlos en la página de su perfil.
2. Utilice su client ID y secret con la siguiente URL para generar su API Key:

​

Obtener su Sitecode

​

Configuración de Segment

1. En la aplicación web de Segment, haga clic en Catalog > Destinations > Destinations Actions > Add destination.
2. Seleccione la Source que quiere conectar con Kameleoon (Actions).
3. Haga clic en Confirm Source.

4. En el panel lateral Basic Settings, rellene los campos obligatorios:
   • Name: Introduzca un nombre que le ayude a identificar este destino en Segment.
   • API Key: Pegue su API key de Kameleoon.
   • Sitecode: Pegue el sitecode de su proyecto de Kameleoon. Puede encontrarlo en el panel del proyecto.
5. Haga clic en el interruptor Enable Destination.
6. Haga clic en Save Changes.

​

Hacer coincidir un usuario de Segment con un visitante de Kameleoon

// Retrieve kameleoonVisitorCode - client-side cookies
 const parseCookie = (str) =>
     str
         .split(";")
         .map((v) => v.split("="))
         .reduce((acc, v) => {
             acc[decodeURIComponent(v[0].trim())] = decodeURIComponent(v[1].trim());
             return acc;
         }, {});
 const {kameleoonVisitorCode} = parseCookie(document.cookie);

analytics.addSourceMiddleware(({ payload, next, integrations }) => {
     const event = payload.obj;
     const kamVC = Kameleoon.API.Visitor.code;
     switch (event.type) {
       case "track":
          payload.obj.properties.kameleoonVisitorCode = kamVC;
          break;
       case "page":
         payload.obj.properties.kameleoonVisitorCode = kamVC;
         break;
       case "identify":
         payload.obj.traits.kameleoonVisitorCode = kamVC;
         break;
     }
     next();
   });

• Para iOS
• Para Android

• Para Node.js
• Para C#/.NET

class KameleoonEnrichment : Plugin
{
    public override PluginType Type => PluginType.Enrichment;
    public override RawEvent Execute(RawEvent incomingEvent)
    {
        incomingEvent.Context["kameleoonVisitorCode"] = "PUT THE VISITOR CODE HERE";
        return incomingEvent;
    }
}

const addVisitorCodeToEventsPayload = ({ payload, next, integrations }) => {
     payload.obj.properties.kameleoonVisitorCode = window.Kameleoon.API.Visitor.code;
     next(payload);
 };
 Kameleoon.API.Core.runWhenConditionTrue(
     () => typeof window.analytics?.addSourceMiddleware === "function",
     () => analytics.addSourceMiddleware(addVisitorCodeToEventsPayload),
     100
 );

​

Recuperar los objetivos creados automáticamente

​

Renombrar o eliminar objetivos creados automáticamente

​

Conversión automática de objetivos

​

Aprovechar las funcionalidades de Segment Destination Actions

​

Funcionalidades

• Filters: Los Destination filters le permiten enviar o bloquear eventos, propiedades y traits de usuario para que no lleguen a un destino. Los Destination filters se aplican a nivel de instancia de destino de una fuente determinada. Los filtros habilitados se aplican a todos los eventos coincidentes en tránsito a este destino. Para obtener detalles sobre la funcionalidad avanzada, consulte la documentación de la Destination Filters API.
• Mappings: Configure el mapeo de datos desde su fuente al destino (Kameleoon).
• Event tester: Para asegurarse de que sus eventos se entregan en su destino, genere un payload de evento y envíe un evento de prueba. Visite la documentación.
• Alerts: Suscríbase a alertas cuando la tasa de entrega de este destino caiga por debajo de un determinado umbral dentro de un período de 24 horas.
• Event delivery: La herramienta Event Delivery le ayuda a entender si los datos están llegando a sus destinos y a ver si Segment ha encontrado algún problema al entregar los datos de su fuente. Consulte la documentación específica.
• Functions: Utilice insert functions para realizar transformaciones personalizadas en los payloads de eventos antes de enviarlos a un destino conectado. Para utilizar una insert function existente, conéctela a este destino desde el catálogo.

​

Migración del destino clásico de Kameleoon

​

Identificación del visitante

• Incluya el kameleoonVisitorCode en sus eventos de Segment para un seguimiento preciso del visitante.

​

Mapeo, filtros y pruebas

• Defina Mapping y Filters en la página de configuración del destino.
• Pruebe los eventos para garantizar la creación precisa de objetivos y el seguimiento de las conversiones.

​

Activación

• Active el destino Kameleoon (Actions) cuando todo esté probado y listo.
• Desactive el destino clásico de Kameleoon.

​

Personas, traits y grupo

​

Personas

window.k_segmentIO = window.k_segmentIO || {};
 if(!window.k_segmentIO.runtime)
 {
     window.k_segmentIO.runtime = true;

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};

​

Obtener los nombres de Personas de Segment en Kameleoon

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;

​

Traits

window.k_segmentIO = window.k_segmentIO || {};
 if(!window.k_segmentIO.runtime)
 {
     window.k_segmentIO.runtime = true;

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};

​

IDs de grupo

window.k_segmentIO = window.k_segmentIO || {};
 if(!window.k_segmentIO.runtime)
 {
     window.k_segmentIO.runtime = true;

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};