Zum Hauptinhalt springen
Mit der Kameleoon-Google-Analytics-4-Event-Streaming-Integration können Sie automatisch Events an Ihr Google-Analytics-4-Konto senden, wann immer Besucher einem Kameleoon-Experiment ausgesetzt werden. Diese Funktion ermöglicht erweiterte Analysen in Google Analytics 4 und liefert Erkenntnisse zur Experiment-Exposition, damit Sie das Verhalten und das Engagement der Benutzer besser verstehen können.
Diese Integration nutzt den Event-Dispatcher von Kameleoon, um serverseitige Events in Stapeln über den Endpunkt /mp/collect der Google Analytics 4 HTTP API an Ihr Google-Analytics-4-Konto zu senden.

​
Wichtige Vorteile

  • Präzise Verhaltenseinblicke: Die Integration sendet spezifische Events an Drittanbieter-Tools für Besucher, die web experiments und feature flags in SDK-basierten Projekten ausgesetzt sind. Dieses detaillierte Tracking liefert einen klaren Blick darauf, wie sich verschiedene variations auf die Benutzeraktionen auswirken. Beispielsweise können Sie beobachten, welche variation mehr Klicks, Konversionen oder andere gewünschte Ergebnisse erzielt, was Ihnen hilft, den effektivsten Ansatz zu bestimmen.
  • Entscheidungsfindung in Echtzeit: Die Integration liefert Daten in Echtzeit. Mit diesen aktuellen Erkenntnissen können Sie Ihre Strategien schnell anpassen, wenn eine variation nicht wie erwartet abschneidet, oder Ressourcen einsetzen, um erfolgreiche variations zu nutzen.
  • Mühelose Einrichtung: Aktivieren Sie Drittanbieter-Integrationen in der Kameleoon-App, ohne benutzerdefinierten Code oder SDK-Änderungen.

​
Hinweise

Zeitpunkt der Event-Zustellung: Der Kameleoon-Server versendet Events mit einer Verzögerung von mindestens 30 Minuten an Google Analytics 4.

​
Voraussetzungen

Für die Konfiguration dieser Integration benötigen Sie die folgenden Informationen:
  • Kameleoon SDK: Ein SDK muss in Ihrem serverseitigen Projekt installiert sein.
  • API secret: Das in Google Analytics generierte API secret, dokumentiert hier.
  • Measurement ID: Für Web-SDKs der Identifier für einen Data Stream, wie hier dokumentiert.
  • Firebase app ID: Für Mobile-SDKs der Identifier für eine Firebase-App, wie hier dokumentiert.

​
Den richtigen GA4-Identifier auswählen

Um eine korrekte Benutzerzuordnung in GA4-Berichten sicherzustellen, müssen Sie je nach App-Typ die richtigen benutzerdefinierten Daten erstellen:
  • Für webbasierte Projekte (Websites, die gtag.js verwenden): Erstellen Sie eine benutzerdefinierte Daten namens ga4_client_id und rufen Sie die client_id aus GA4 ab (üblicherweise im Cookie _ga gespeichert).
  • Für Firebase-basierte Mobile-Apps: Erstellen Sie eine benutzerdefinierte Daten namens ga4_app_instance_id und rufen Sie die app_instance_id aus dem Firebase SDK ab.
Diese Unterscheidung gilt für alle Arten von GA4-Integrationen in Kameleoon, sowohl für web experiments als auch für feature-flag-Experiments.

​
Einrichtung

Diese Integration kann für Web- und Feature-Experimentation verwendet werden.

​
Für web experiments

Aktivieren Sie die Integration auf der Integrationsseite.

​
GA4-Client-ID identifizieren

Sie müssen bei jedem Besuch einen Instanz-Identifier an das Kameleoon-Backend senden. Der genaue Identifier hängt von Ihrer GA4-Einrichtung ab. Wenn Sie GA4 mit der gtag.js-Methode verwenden, senden Sie die client_id. Im Folgenden sehen Sie ein Beispiel für eine gtat.js-Implementierung mit unserer Activation API.

​
Die benutzerdefinierte Daten einrichten

  • Name: ga4_client_id
  • Wählen Sie Ihr Projekt aus.
  • Abrufmethode: Kameleoon Activation API.
  • Typ: Single
  • Format: String
  • Umfang: Besuch

​
Code im globalen Skript hinzufügen

if(!Kameleoon.API.CurrentVisit.customData["ga4_client_id"]){

// First, create a ga4ClientId variable and obtain your GA4 client ID.
let gaClientId = null;

const getClientId = () =>{
    gtag('get', 'G-XXXXXXXXXX', 'client_id', function(clientId) {
        gaClientId = clientId;
    });
    return gaClientId !== null
}

Kameleoon.API.Core.runWhenConditionTrue(
    () => getClientId(),
    () =>{
        // Then set your Kameleoon "ga_client_id" custom data to this value using Kameleoon's Activation API
        Kameleoon.API.Data.setCustomData("ga4_client_id", gaClientId);
    },
    200
)

}

​
Die Integration für Ihre Kampagnen aktivieren

Fügen Sie die Integration während der Finalisierung Ihres web experiments hinzu.

​
Für feature experiments

Richten Sie die Integration in der feature-flag-Umgebung im Abschnitt Integrationen ein. Aktivieren Sie sie für jede Umgebung, in der sie aktiv sein soll.

​
Für Mobile

Wenn Sie GA4-Analytics mit einer Firebase-App verwenden, müssen Sie die Firebase app instance ID senden. Hier ein Beispiel mit dem Kameleoon Android SDK:
  1. GA4 Firebase app instance ID identifizieren
  2. Eine benutzerdefinierte Daten einrichten
    • Name: ga_app_instance_id
    • Wählen Sie Ihr Projekt aus.
    • Abrufmethode: Kameleoon SDK-Methode.
    • Typ: Single
    • Format: String
    • Umfang: Besuch

​
Java-Beispiel mit dem Kameleoon Android SDK

Rufen Sie zunächst Ihre Firebase app instance ID ab und speichern Sie sie in einer Variablen. Verwenden Sie anschließend das Kameleoon SDK, um Ihre benutzerdefinierte Daten ga4_app_instance_id auf diesen Wert zu setzen. Achten Sie darauf, den korrekten Index für die benutzerdefinierte Daten ga4_app_instance_id zu verwenden, den Sie in der Kameleoon-Oberfläche finden. In diesem Beispiel ist der Index 12: kameleoonClient.addData(new CustomData(12, appInstanceId)); Sobald die Integration aktiv und Ihr Experiment live ist, beginnt Kameleoon damit, Experiment-Events an Google Analytics 4 zu senden, sobald ein Besucher diesem ausgesetzt ist. Diese Events werden gemäß den von Google empfohlenen Best Practices erstellt. Diese Events enthalten wichtige Details wie:
  • Einen eindeutigen Identifier für die Firebase-App-Instanz, nur für SDK-Setups, genannt app_instance_id.
  • Einen eindeutigen Identifier für den Client, nur für Web-Setups, genannt client_id.
  • Zeitpunkt der Exposition
  • Einen eindeutigen Identifier für das Experiment und die variation im Format KAM-XXXX-YYYY, wobei XXXX die Kameleoon-Experiment-ID und YYYY die variation-ID ist.

​
Beispiel für Event-Payload

Kameleoon sendet Events im folgenden Format an Google Analytics 4: 
{
  "events": [
    {
      "name": "experience_impression",
      "exp_variant_string": "KAM-1234-5567",
      "timestamp_micros": 1718201234000
    },
    {
      "name": "experience_impression",
      "exp_variant_string": "KAM-5678-6978",
      "timestamp_micros": 1718201267000
    }
  ],
  "app_instance_id": "example-instance-id"
}
Benutzer identifizieren
Kameleoon enthält standardmäßig keine Benutzeridentifikatoren (wie user_id oder client_id) im Event-Payload. Die Identifikation erfolgt je nach Umgebung über die folgenden Felder:
  • Mobile: app_instance_id (Standard für GA4-Mobile-Apps)
  • Web: client_id (das Äquivalent zu app_instance_id für Web-Clients)
Wenn Sie Kameleoon in einem Web-Backend oder einer serverseitigen Einrichtung verwenden, können Sie die GA4 client_id übertragen, indem Sie sie als benutzerdefinierten Datenfeld (zum Beispiel ga4_client_id) definieren. Sie können dieses Feld mit jeder verfügbaren Abrufmethode setzen – nicht nur mit der Activation API. Es muss lediglich mindestens einmal pro Kameleoon-Sitzung definiert werden.
Events anreichern
Kameleoon nimmt Ihre geschäftsspezifischen benutzerdefinierten Daten nicht in die serverseitige Event-Payload auf. Wenn Sie die Payload mit zusätzlichen Daten (z. B. client_id oder Benutzerattributen) anreichern müssen und ein Kameleoon-Konto besitzen, können Sie diese über benutzerdefinierte Datenfelder in Ihrer SDK-Konfiguration hinzufügen oder einen Feature-Request einreichen.