Segment destination actions

​

Segment-Ereignisse, -Traits, -Gruppen und -Personas in Kameleoon importieren

• Jedes von Segment ausgeloste Ereignis wird automatisch an Kameleoon gesendet, was Entwicklern Zeit beim Neuimplementieren eines bestehenden Segment-Tracking-Plans in Kameleoon spart. Page-, Screen- und Track-Ereignisse werden automatisch als Kameleoon-Custom-Ziel erfasst. Sie konnen jedes davon in Ihren Experimenten/Personalisierungen verwenden oder um Benutzer anzusprechen, die eine bestimmte Aktion auf Ihrer Website oder mobilen App ausfuhren.
• Track-Ereignisse vom Typ Audience Entered oder Audience exited werden als Kameleoon-Custom-Data erfasst, um in unserem Segment Builder zum Targeting von Benutzer-Personas verwendet zu werden.
• Track-Ereignisse vom Typ identify mit Traits werden als Kameleoon-Custom-Data erfasst, um in unserem Segment Builder zum Targeting von Benutzern mit bestimmten Traits verwendet zu werden.
• Track-Ereignisse vom Typ group werden als Kameleoon-Custom-Data erfasst, um in unserem Segment Builder zum Targeting einer Gruppen-ID verwendet zu werden.

​

Uberlegungen

• Sie mussen diese Integration in jedem Segment-Projekt aktivieren, in dem Sie sie verwenden mochten.
• Sie benotigen einen kostenpflichtigen Kameleoon-Plan, um diese Integration zu aktivieren.
• Sie mussen Ihre Segment-Benutzer mit Kameleoon-Besuchern abgleichen, indem Sie dasselbe Identifikationssystem fur beide Tools verwenden.
• Diese Integration weist technische Beschrankungen auf.
• Segment sendet alle Benutzer-, Ereignis- und Gruppen-Eigenschaften zusammen mit dem Ereignis.

​

Beschrankungen

• Maximale Grosse der Ereignisdaten von 1 MB
• Es konnen nicht mehr als 50 Kameleoon-Ziele innerhalb von 10 Sekunden erstellt werden
• Es konnen nicht mehr als 1000 Kameleoon-Ziele innerhalb von 60 Minuten erstellt werden

​

Einrichtung

​

Voraussetzungen

• REST API Key: Um mit dem Senden von Daten an Kameleoon zu beginnen, benotigen Sie Ihren API Key. Weitere Hilfe finden Sie im Abschnitt Generate your API Key.
• Sitecode: Sie mussen den Sitecode fur das Projekt angeben, das Sie mit dieser Integration verwenden mochten. Wo Sie Ihren Sitecode finden, erfahren Sie in der dedizierten Kameleoon-Dokumentation.

​

Kameleoon-Einrichtung

​

Generieren Sie Ihren API Key

1. Holen Sie sich Ihre Client-ID und Ihr Client Secret. Sie finden sie in Ihrer Profilseite.
2. Verwenden Sie Ihre Client-ID und Ihr Client Secret mit der folgenden URL, um Ihren API Key zu generieren:

​

Sitecode abrufen

​

Segment-Einrichtung

1. Klicken Sie in der Segment-Webanwendung auf Catalog > Destinations > Destinations Actions > Add destination.
2. Wahlen Sie die Source aus, die Sie mit Kameleoon (Actions) verbinden mochten.
3. Klicken Sie auf Confirm Source.

4. Fullen Sie im Seitenpanel Basic Settings die erforderlichen Felder aus:
   • Name: Geben Sie einen Namen ein, der Ihnen hilft, dieses Ziel in Segment zu identifizieren.
   • API Key: Fugen Sie Ihren Kameleoon-API-Key ein.
   • Sitecode: Fugen Sie den Sitecode Ihres Kameleoon-Projekts ein. Sie finden ihn im Projekt-Dashboard.
5. Klicken Sie auf den Schalter Enable Destination.
6. Klicken Sie auf Save Changes.

​

Einen Segment-Benutzer mit einem Kameleoon-Besucher abgleichen

// 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();
   });

• Fur iOS
• Fur Android

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

​

Automatisch erstellte Ziele abrufen

​

Automatisch erstellte Ziele umbenennen oder loschen

​

Automatische Ziel-Conversion

​

Von den Funktionen der Segment Destination Actions profitieren

​

Funktionen

• Filters: Mit Zielfiltern konnen Sie Ereignisse, Eigenschaften und Benutzer-Traits senden oder blockieren, damit sie ein Ziel erreichen. Zielfilter werden auf der Ebene der Zielinstanz einer bestimmten Quelle angewendet. Aktivierte Filter werden auf jedes passende Ereignis angewendet, das zu diesem Ziel ubermittelt wird. Details zu erweiterten Funktionen finden Sie in der Destination Filters API-Dokumentation.
• Mappings: Konfigurieren Sie das Daten-Mapping von Ihrer Quelle zum Ziel (Kameleoon).
• Event tester: Um sicherzustellen, dass Ihre Ereignisse an ihr Ziel geliefert werden, generieren Sie ein Ereignis-Payload und senden Sie ein Testereignis. Visit Documentation.
• Alerts: Abonnieren Sie Benachrichtigungen, wenn die Ubermittlungsrate dieses Ziels innerhalb eines Zeitraums von 24 Stunden unter einen bestimmten Schwellenwert fallt.
• Event delivery: Das Event Delivery-Tool hilft Ihnen zu verstehen, ob Daten Ihre Ziele erreichen, und zu sehen, ob Segment Probleme bei der Lieferung Ihrer Quelldaten hatte. Siehe die dedizierte Dokumentation
• Functions: Verwenden Sie Insert Functions, um benutzerdefinierte Transformationen an Ereignis-Payloads vorzunehmen, bevor Sie sie an ein verbundenes Ziel senden. Um eine vorhandene Insert Function zu verwenden, verbinden Sie eine aus dem Katalog mit diesem Ziel.

​

Migration vom klassischen Kameleoon-Ziel

​

Besucher-Identifikation

• Fugen Sie den kameleoonVisitorCode in Ihre Segment-Ereignisse ein, um Besucher genau zu verfolgen.

​

Mapping, Filter und Tests

• Definieren Sie Mapping und Filter auf der Ziel-Konfigurationsseite.
• Testen Sie Ereignisse, um die genaue Zielerstellung und Conversion-Verfolgung sicherzustellen.

​

Aktivierung

• Aktivieren Sie das Kameleoon (Actions)-Ziel, wenn alles getestet und bereit ist.
• Deaktivieren Sie das klassische Kameleoon-Ziel.

​

Personas, Traits und Gruppe

​

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

​

Segment Persona-Namen in Kameleoon abrufen

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

​

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