Amplitude — Event Streaming

​

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

• 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.

​

Einrichtung

​

Für web experiments

1. Öffnen Sie Amplitude auf der Seite Integrations.
2. Wählen Sie unter Use this tool on die Projekte aus, an die Sie Events an Amplitude senden möchten.
3. Wählen Sie unter Tracking method die Option Event dispatcher aus.
4. Geben Sie Ihren Amplitude API key ein und wählen Sie anschließend Ihren Endpoint und Ihren Amplitude plan aus.
5. Klicken Sie auf Validate.

1. Klicken Sie auf Finalize > Integrations.
2. Klicken Sie auf Activate neben Amplitude.

​

Für feature experiments

1. Klicken Sie auf Edit für das Feature-Flag, das Sie verfolgen möchten.
2. Klicken Sie im Abschnitt Reporting auf Integrations. Alle von Ihnen aktivierten Integrationen werden angezeigt.
3. Schalten Sie Amplitude für Delivery rules, Feature experiments oder beides ein.

• 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

{
    "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
}

​

Payload-Anpassung für user_id, device_id und session_id

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