> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Google Analytics 4 — Event Streaming
> Streamen Sie Ereignisse zur Exposition gegenüber Kameleoon-Experiments automatisch serverseitig an Google Analytics 4 für eine angereicherte Verhaltensanalyse nach Experiment-variation.
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](https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference?client_type=gtag#transport) 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](https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference?client_type=gtag#payload).
* **Measurement ID:** Für Web-SDKs der Identifier für einen Data Stream, wie [hier](https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference?client_type=gtag#payload) dokumentiert.
* **Firebase app ID:** Für Mobile-SDKs der Identifier für eine Firebase-App, wie [hier](https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference?client_type=firebase#payload) 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
```javascript theme={null}
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](https://developers.google.com/analytics/devguides/collection/ga4/integration) 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:
```json theme={null}
{
"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](https://feedback.kameleoon.com/) einreichen.