Skip to main content
Ihr Team verfolgt Nutzeraktionen womöglich schon in Amplitude. Den Tracking-Plan in Kameleoon neu anzulegen kostet Entwicklungszeit. Diese Integration sendet Ihre Amplitude-Ereignisse an Kameleoon. Kameleoon legt für jedes Ereignis ein benutzerdefiniertes Ziel an, das nach dem Ereignis benannt ist, und erfasst eine Conversion für den passenden Besucher. Um diese Ziele auszulösen, brauchen Sie keinen Code. Sie müssen jedoch den Kameleoon-Besuchercode an Amplitude übergeben, damit jedes Ereignis einem Besucher zugeordnet werden kann.

So fügt sich die Integration in Ihren Workflow ein

  • Amplitude mit Kameleoon verbinden: Erzeugen Sie einen REST-API-Schlüssel, ermitteln Sie Ihren Sitecode und erstellen Sie in Amplitude einen Sync, der Ihre Ereignisse an Kameleoon sendet.
  • Amplitude-Nutzer mit Kameleoon-Besuchern abgleichen: Übergeben Sie den Kameleoon-Besuchercode mit jedem Ereignis an Amplitude.
  • Von Amplitude-Ereignissen erstellte Ziele verwalten: Suchen und benennen Sie die Ziele um, die Kameleoon aus Amplitude-Ereignissen erstellt.

Bevor Sie beginnen

  • Bezahlter Tarif: ein kostenpflichtiger Kameleoon-Tarif, den die Integration voraussetzt.
  • REST-API-Schlüssel: der Schlüssel, mit dem Amplitude Ereignisse an Ihr Projekt senden kann. Sie erzeugen ihn aus Ihrer Client-ID und Ihrem Client-Secret.
  • Sitecode: die Kennung des Kameleoon-Projekts, das die Ereignisse empfängt. Sie können ihn auf dem Projekt-Dashboard finden.
  • Amplitude-Projekte: Jedes Amplitude-Projekt, das Ereignisse sendet, braucht eine eigene aktivierte Destination.

Amplitude mit Kameleoon verbinden

Amplitude sendet Ereignisse über eine Destination an Kameleoon, die Sie in Amplitude anlegen. Die Destination benötigt Ihren REST-API-Schlüssel und Ihren Sitecode, mit denen Kameleoon Ihr Projekt identifiziert. Amplitude sendet alle Nutzer-, Ereignis- und Gruppeneigenschaften mit jedem Ereignis. Kameleoon akzeptiert Ereignisdaten von bis zu 1 MB pro Ereignis.

REST-API-Schlüssel erzeugen

Erzeugen Sie einen REST-API-Schlüssel aus Ihrer Client-ID und Ihrem Client-Secret.
  1. Kopieren Sie Ihre client_id und Ihr client_secret von der Seite API-Anmeldeinformationen. Falls Sie noch kein Client-Secret haben, klicken Sie auf dieser Seite auf Generate a new Client-Secret key.
  2. Öffnen Sie die folgende URL in einem Browser und ersetzen Sie CLIENT_ID und CLIENT_SECRET durch Ihre Werte.
Bewahren Sie den Schlüssel griffbereit auf, um die Amplitude-Destination einzurichten.

Ihren Sitecode ermitteln

Ermitteln Sie den Sitecode des Kameleoon-Projekts, das die Ereignisse empfängt. Sie finden ihn auf dem Projekt-Dashboard. Wo genau, zeigt Ihren Sitecode finden.

Die Amplitude-Destination einrichten

Sie richten die Destination in Amplitude ein, nicht in der Kameleoon-App. Folgen Sie der Kameleoon-Destination-Anleitung von Amplitude, um den Sync zu erstellen. Wenn Amplitude nach dem Kameleoon-REST-API-Schlüssel und dem Sitecode fragt, verwenden Sie die Werte aus den vorangehenden Schritten. Die Karte Amplitude unter Admin > Integrations ist eine eigene Integration mit dem Tag Destination. Sie sendet Kameleoon-Testergebnisse an Amplitude. Event-Streaming richten Sie dort nicht ein.

Amplitude-Nutzer mit Kameleoon-Besuchern abgleichen

Kameleoon kann ein Amplitude-Ereignis nur dann einem Besucher zuordnen, wenn beide Tools diesen Besucher mit demselben Wert identifizieren. Wenn Ihr Projekt Kameleoon-Experimente oder -Personalisierungen verwendet, setzt Kameleoon für jeden Besucher ein Cookie, das einen anonymen, eindeutigen Bezeichner speichert: den Kameleoon-Besuchercode. Wählen Sie eine der folgenden Optionen, um diesen Code an Amplitude zu übergeben:
  • Option 1: Übergeben Sie den Besuchercode als userId des Amplitude-Ereignisses. Kameleoon ordnet dann alle Ereignisdaten aus Amplitude dem richtigen Besucher zu.
  • Option 2: Setzen Sie die Nutzereigenschaft kameleoon_visitorcode in den Amplitude-Ereignissen. Ihr Wert ist der Besuchercode.
Wenn Ihr Projekt Feature Experimentation verwendet, legen Sie im Kameleoon-SDK Ihre eigene ID fest, statt den generierten Besuchercode zu verwenden. Die Übersicht zu Feature Experimentation zeigt, wie Sie im SDK Ihre eigene ID festlegen.

Den Besuchercode als Amplitude-User-ID verwenden

Setzen Sie die Amplitude-User-ID mit dem Amplitude Browser SDK auf den Kameleoon-Besuchercode.

Den Besuchercode in einer Nutzereigenschaft speichern

Setzen Sie in jedem folgenden Amplitude-Aufruf die Nutzereigenschaft kameleoon_visitorcode auf den Besuchercode.

Ziele verwalten, die aus Amplitude-Ereignissen erstellt wurden

Wenn Kameleoon ein Amplitude-Ereignis empfängt, für das kein passendes Ziel existiert, legt Kameleoon ein benutzerdefiniertes Ziel mit dem Namen Amplitude - <event name> an. Kameleoon versieht jedes Ziel, das es erstellt, mit dem Tag amplitude. Kameleoon erstellt höchstens 50 Ziele in einem Zeitraum von 10 Sekunden und höchstens 1.000 Ziele in einem Zeitraum von 60 Minuten.

Die aus Amplitude-Ereignissen erstellten Ziele finden

Filtern Sie die Ziele nach dem Tag amplitude, um die Ziele anzuzeigen, die Amplitude-Ereignisse angelegt haben.
  1. Öffnen Sie das Dashboard Goals.
  2. Filtern Sie die Ziele im Seitenbereich nach dem Tag amplitude.

Automatisch erstellte Ziele umbenennen

Kameleoon findet das Ziel für ein Amplitude-Ereignis anhand seines Namens. Wenn Sie ein Ziel umbenennen, findet Kameleoon es nicht mehr. Das nächste Ereignis legt dann ein neues Ziel an, das nach dem Amplitude-Ereignis benannt ist. Conversions, die vor der Umbenennung erfasst wurden, bleiben beim bisherigen Ziel. Um Conversions bei einem Ziel zu halten, benennen Sie das Amplitude-Ereignis so um, dass es dem neuen Zielnamen entspricht. Wenn Sie ein Amplitude-Ereignis umbenennen, benennen Sie auch sein Ziel so um, dass es dem neuen Ereignisnamen entspricht.

Ziele automatisch konvertieren

Kameleoon konvertiert ein Ziel, sobald Amplitude das zugehörige Ereignis sendet. Stimmt der Name eines Amplitude-Ereignisses exakt mit dem Namen eines bestehenden Ziels in Ihrem Kameleoon-Konto überein, ordnet Kameleoon jede Conversion diesem Ziel zu, unabhängig davon, ob Kameleoon das Ziel selbst angelegt hat. Sie müssen weder die Activation API noch ein SDK aufrufen, um diese Ziele zu konvertieren, und Sie brauchen keinen Frontend- oder Backend-Code, um sie auszulösen.