Segment destination actions

​

Importer les evenements, traits, groupes et personas Segment dans Kameleoon

• Chaque evenement declenche par Segment sera automatiquement envoye a Kameleoon, ce qui fait gagner du temps aux developpeurs en evitant de reimplementer un Tracking plan Segment existant dans Kameleoon. Les evenements Page, Screen et Track sont automatiquement collectes en tant qu’objectif personnalise Kameleoon. Vous pouvez utiliser n’importe lequel d’entre eux dans vos experiences/personnalisations, ou pour cibler les utilisateurs effectuant une action specifique sur votre site web ou application mobile.
• Les evenements track de type Audience Entered ou Audience exited sont collectes en tant que custom data Kameleoon a utiliser dans notre Segment Builder pour cibler des personas d’utilisateurs.
• Les evenements track de type identify avec des traits sont collectes en tant que custom data Kameleoon a utiliser dans notre Segment Builder pour cibler des utilisateurs avec des traits specifiques.
• Les evenements track de type group sont collectes en tant que custom data Kameleoon a utiliser dans notre Segment Builder pour cibler un group ID.

​

Considerations

• Vous devez activer cette integration dans chaque projet Segment dans lequel vous souhaitez l’utiliser.
• Vous avez besoin d’un plan Kameleoon payant pour activer cette integration.
• Vous devez faire correspondre vos utilisateurs Segment avec les visiteurs Kameleoon en utilisant le meme systeme d’identifiants pour les deux outils.
• Cette integration a des limitations techniques.
• Segment envoie toutes les proprietes d’utilisateur, d’evenement et de groupe avec l’evenement.

​

Limitations

• Taille maximale de 1 MB des donnees d’evenement
• Impossible de creer plus de 50 objectifs Kameleoon sur une periode de 10 secondes
• Impossible de creer plus de 1000 objectifs Kameleoon sur une periode de 60 minutes

​

Configuration

​

Prerequis

• REST API Key : Pour commencer a envoyer des donnees a Kameleoon, vous avez besoin de votre cle API. Consultez la section Generate your API Key pour plus d’aide.
• Sitecode : Vous devez fournir le Sitecode du projet que vous souhaitez utiliser avec cette integration. Consultez la documentation Kameleoon dediee pour savoir ou trouver votre Sitecode.

​

Configuration Kameleoon

​

Generer votre cle API

1. Obtenez votre client ID et client secret. Vous pouvez les trouver dans votre page de profil.
2. Utilisez votre client ID et client secret avec l’URL suivante pour generer votre cle API :

​

Obtenir votre Sitecode

​

Configuration Segment

1. Dans l’application web Segment, cliquez sur Catalog > Destinations > Destinations Actions > Add destination.
2. Selectionnez la Source que vous souhaitez connecter a Kameleoon (Actions).
3. Cliquez sur Confirm Source.

4. Dans le panneau lateral Basic Settings, remplissez les champs requis :
   • Name : Saisissez un nom pour vous aider a identifier cette destination dans Segment.
   • API Key : Collez votre cle API Kameleoon.
   • Sitecode : Collez le sitecode de votre projet Kameleoon. Vous pouvez le trouver dans le tableau de bord du projet.
5. Cliquez sur le toggle Enable Destination.
6. Cliquez sur Save Changes.

​

Faire correspondre un utilisateur Segment avec un visiteur 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();
   });

• Pour iOS
• Pour Android

• Pour Node.js
• Pour 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
 );

​

Recuperer les objectifs crees automatiquement

​

Renommer ou supprimer les objectifs crees automatiquement

​

Conversion automatique d’objectif

​

Beneficier des fonctionnalites des Segment Destination Actions

​

Fonctionnalites

• Filters : Les filtres de destination vous permettent d’envoyer ou de bloquer des evenements, des proprietes et des traits utilisateur vers une destination. Les filtres de destination sont appliques au niveau de l’instance de destination d’une source donnee. Les filtres actives sont appliques a chaque evenement correspondant en transit vers cette destination. Pour plus de details sur les fonctionnalites avancees, consultez la documentation de l’API Destination Filters.
• Mappings : Configurez le mapping de donnees de votre source vers la destination (Kameleoon).
• Event tester : Pour vous assurer que vos evenements sont delivres a leur destination, generez un payload d’evenement et envoyez un evenement de test. Visit Documentation.
• Alerts : Abonnez-vous aux alertes lorsque le taux de delivrance de cette destination chute en dessous d’un certain seuil dans une periode de 24 heures.
• Event delivery : L’outil Event Delivery vous aide a comprendre si les donnees atteignent vos destinations et a voir si Segment a rencontre des problemes lors de la livraison des donnees source. Voir la documentation dediee
• Functions : Utilisez les insert functions pour effectuer des transformations personnalisees sur les payloads d’evenements avant de les envoyer a une destination connectee. Pour utiliser une insert function existante, connectez-en une a cette destination depuis le catalog.

​

Migration depuis la destination Kameleoon classique

​

Identification du visiteur

• Incluez le kameleoonVisitorCode dans vos evenements Segment pour un suivi precis des visiteurs.

​

Mapping, Filtres et Tests

• Definissez le Mapping et les Filtres dans la page de configuration de la destination.
• Testez les evenements pour garantir une creation precise des objectifs et un suivi des conversions.

​

Activation

• Activez la destination Kameleoon (Actions) lorsque tout est teste et pret.
• Desactivez la destination Kameleoon classique.

​

Personas, traits et groupes

​

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

​

Recuperer les noms de Persona Segment dans 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};

​

Group IDs

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