Zum Hauptinhalt springen
Die Integration „Amplitude Event Streaming” sendet automatisch Ereignisse an Ihr Amplitude-Konto, wann immer Besucher einem Kameleoon-Experiment ausgesetzt werden. Diese Integration ermöglicht erweiterte Analysen in Amplitude 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 Ereignisse in Stapeln über den /import-Endpunkt der Amplitude HTTP API an Ihr Amplitude-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 wie Apps ausgesetzt sind. Dieses detaillierte Tracking ermöglicht einen klareren 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 und ermöglicht so spontane Entscheidungen. Mit aktuellen Erkenntnissen zu laufenden Experiments können Sie Ihre Strategien schnell anpassen, wenn eine variation nicht wie erwartet abschneidet.
  • Mühelose Einrichtung: Aktivieren Sie Drittanbieter-Integrationen direkt aus der Kameleoon-App, ohne benutzerdefinierten Code oder SDK-Änderungen.

Hinweise

  • Zeitpunkt der Event-Zustellung: Die Kameleoon-Server versenden Events mit einer Verzögerung von mindestens 30 Minuten.

Voraussetzungen

Für die Konfiguration dieser Integration benötigen Sie die folgenden Informationen:
  • Amplitude API key: Der API-Schlüssel, der für eines Ihrer Amplitude-Projekte eindeutig ist (wie hier dokumentiert)
  • Server-Residenz: Geben Sie an, ob Ihr Amplitude-Konto für die Standard-Hosting-Region oder für EU-Hosting konfiguriert ist.
  • Amplitude-Plan: Wählen Sie den Kundenplantyp aus, den Sie bei Amplitude erworben haben.
Das Kameleoon SDK muss außerdem in Ihrem serverseitigen Projekt installiert sein.

Einrichtung

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

Für web experiments

Aktivieren Sie die Integration auf der Seite „Integrationen”.
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 die Umgebungen, in denen sie aktiv sein soll.
Sobald die Integration aktiviert und Ihr Experiment live ist, sendet Kameleoon automatisch Experiment-Ereignisse an Amplitude, sobald ein Besucher diesem ausgesetzt ist. Jedes Ereignis enthält wichtige Details wie:
  • Den Kameleoon Visitor Code (gesendet sowohl als benutzerdefinierte Eigenschaft als auch als Standardwert des Felds device_id)
  • Zeitstempel der Exposition
  • Kameleoon Experiment-ID
  • Kameleoon variation-ID

Beispiel für Event-Payload

Kameleoon sendet Events im folgenden Format an Amplitude:
{
    "event_type": "$identify",
    "user_properties":
    {
        "$set":
        {
            "KAM_EXPERIMENT_12345": "KAM_VARIATION_15685",
            "KAM_VISITOR_CODE": "rjfloel55ug9fg"
        }
    },
    "device_id": "rjfloel55ug9fg" // also Kameleoon visitor code
    "time": 1730194985000
}
Standardmäßig enthält user_id den Kameleoon Visitor Code des Besuchers. Wenn Sie die geräteübergreifende Verlaufsabgleichung von Kameleoon eingerichtet haben, wird stattdessen der in den benutzerdefinierten Daten zur geräteübergreifenden Abgleichung hinterlegte Bezeichner verwendet.

Payload-Anpassung für user_id, device_id und session_id

Standardmäßig sendet Kameleoon Payloads, in denen Benutzer durch das Feld device_id identifiziert werden, das den Kameleoon Visitor Code enthält. Sie können den Inhalt dieser Payloads jedoch anpassen, indem Sie in Kameleoon benutzerdefinierte Daten erstellen und befüllen. Sie können eine oder alle der folgenden benutzerdefinierten Daten definieren:
  • Geräteübergreifende Identifikation (user_id):
    • Wenn Sie eine benutzerdefinierte Datenfeld erstellen und die Option „für geräteübergreifende Identifikation verwenden” aktivieren, wird sein Wert – sofern bei einem Besuch vorhanden – in das Amplitude-Feld user_id übertragen. Diese benutzerdefinierten Daten sind ideal für „eingeloggte” Bezeichner, die Ihren Benutzern zugeordnet sind.
  • Gerätebezeichner (device_id):
    • Wenn Sie eine benutzerdefinierte Daten namens amplitude_device_id erstellen, ersetzt ihr Wert – sofern vorhanden – den Kameleoon Visitor Code im Feld device_id der Payload. Diese benutzerdefinierten Daten werden für „anonyme” Bezeichner empfohlen, die mit Benutzergeräten verknüpft sind. Unabhängig davon, ob diese benutzerdefinierten Daten gesetzt sind, ist der ursprüngliche Kameleoon Visitor Code unter der benutzerdefinierten Eigenschaft KAMELEOON_VISITOR_CODE weiterhin in Ihren Payloads enthalten.
  • Sitzungsbezeichner (session_id):
    • Wenn Sie eine benutzerdefinierte Daten namens amplitude_session_id erstellen, wird ihr Wert – sofern vorhanden – in das Amplitude-Feld session_id übertragen. Wir empfehlen, diesen Wert so zu setzen, dass er mit der Amplitude-Session-ID übereinstimmt.

Beispiel für Event-Payload

{
    "event_type": "$identify",
    "user_properties":
    {
        "$set":
        {
            "KAM_EXPERIMENT_12345": "KAM_VARIATION_15685",
            "KAM_VISITOR_CODE": "rjfloel55ug9fg"
        }
    },
    "device_id": "dfkslj47h9"
    "user_id": "xf54dd2thdd5",
    "session_id": 1396381378123
    "time": 1730194985000
}
Bitte beachten Sie, dass alle für Ihr Geschäft spezifischen benutzerdefinierten Daten, die normalerweise in Ihren Amplitude-Events enthalten sind, in den vom Kameleoon-Server gesendeten Events nicht vorhanden sind. Wenn Sie die Payload mit Daten anreichern müssen, die nicht nativ von Kameleoon erfasst werden, und Sie über ein Kameleoon-Konto verfügen, können Sie einen Feature-Request einreichen.