Personyze Wiki Personyze Wiki docs
Deutsch
Open Personyze
Docs/ Analytics und Datenplattformen/ Amplitude-Integration: Kampagnen-Ereignisse hin, Kohorten zurück
Analytics und Datenplattformen

Amplitude-Integration: Kampagnen-Ereignisse hin, Kohorten zurück

Kampagnen-Ereignisse serverseitig an Amplitude senden und Amplitude-Kohorten als Zielgruppenlisten in Personyze nutzen.

3 min read Updated 20 Stunden ago

Personyze und Amplitude arbeiten in beide Richtungen: Personyze meldet Kampagnen-Ereignisse an Amplitude, und Ihre Amplitude-Kohorten kommen als Zielgruppenlisten zu Personyze zurück, auf die Sie abzielen können.

Teil 1: Personyze-Ereignisse an Amplitude senden

Personyze kann ein Ereignis an Amplitude melden, sobald ein Besucher zu einer Kampagne passt — gesendet von den Servern von Personyze über die HTTP-V2-API von Amplitude.

Dies ist ein reines Automation-Ziel. Es ruft die API mit einem Schlüssel von den eigenen Servern von Personyze auf, daher gibt es keine Entsprechung auf der Seite, und das Skript des Tools muss nicht auf Ihrer Seite sein. Aktivieren Sie es in einer Send Event to Analytics-Aktion.

Amplitude hat durchaus ein Browser-SDK, daher ist die Frage berechtigt, warum dies serverseitig läuft. Das Senden von unseren Servern bedeutet, dass das Ereignis ankommt, ob das Amplitude-Skript auf dieser Seite geladen wurde oder nicht — der Unterschied zwischen einem Ziel, das funktioniert, und einem, das nur dort funktioniert, wo zufällig ein Skript geladen wurde.

Was Sie brauchen

Feld Wo Sie sie finden
Project API key Amplitude → Settings → Projects → Ihr Projekt → API Key
EU project-Kontrollkästchen Aktivieren, wenn Ihr Amplitude-Projekt in der EU liegt
Wenn Ihr Projekt nicht in den USA liegt, stellen Sie die Region ein — nichts wird Sie darauf hinweisen. Ein Schlüssel eines Nicht-US-Projekts, der an den US-Endpunkt gesendet wird, wird angenommen, und die Daten werden verworfen. Es gibt nirgends einen Fehler. Wenn keine Ereignisse ankommen, prüfen Sie zuerst das.

Wie die Person identifiziert wird

Amplitude-Ereignisse sind an die Personyze-Besucher-ID gebunden, nicht an eine E-Mail-Adresse — daher funktioniert dieses Ziel auch für anonyme Besucher. Wenn Sie im Kampagnenprotokoll „the recipient has no identifier“ sehen, hatte der passende Besucher keine ID, die gesendet werden konnte — das ist selten.

Was ankommt

Der Ereignisname, den Sie eingegeben haben, die Besucher-ID, ein Zeitstempel und jede Eigenschaft, die Sie in der Aktion hinzugefügt haben — diese können auf das Personyze-Profil des Besuchers und auf Live-Kampagnenkennzahlen zugreifen.

Teil 2: Amplitude-Kohorten in Personyze nutzen

Synchronisieren Sie eine Amplitude-Kohorte mit Personyze, und sie wird zu einer Zielgruppenliste namens „Amplitude: <Kohortenname>“. Nutzen Sie sie in jeder Kampagne — Website, E-Mail oder offline. Wenn Personen der Kohorte in Amplitude beitreten oder sie verlassen, kommen sie automatisch auf die Liste oder fallen heraus, und die Website sieht die Änderung bei der nächsten Seite des Besuchers.

Was Sie brauchen

  • Einen Amplitude-Tarif, der Kohorten-Webhook-Ziele enthält (ein kostenpflichtiger Tarif).
  • Einen Personyze-API-Schlüssel: Einstellungen → Integrationen → Amplitude → Neuen Schlüssel erzeugen (dieselben Schlüssel wie auf der Karte der Vollwertigen API).

Einrichtung

  1. Öffnen Sie in Personyze Einstellungen → Integrationen → Amplitude und kopieren Sie die Webhook-URL (https://personyze.com/api/audiences/amplitude).
  2. Fügen Sie in Amplitude ein Cohort Webhook-Ziel hinzu. Geben Sie die URL ein und fügen Sie einen Header namens Authorization hinzu, mit dem Wert Bearer <your API key> (das Wort Bearer, ein Leerzeichen, dann der Schlüssel).
  3. Synchronisieren Sie eine Kohorte mit diesem Ziel.
Amplitude-Kohorten im Integrationsfenster von Personyze
Einstellungen → Integrationen → Amplitude: die Webhook-URL und die API-Schlüssel für eine Kohorten-Synchronisation. Zum Vergrößern klicken.

Wie Personen zugeordnet werden

Über die user_id von Amplitude, verglichen mit der Benutzer-ID, die Ihre Website bei der Anmeldung an Personyze sendet, und mit der E-Mail-Adresse, wenn die user_id eine E-Mail-Adresse ist.

Wo Sie sie finden

Zielgruppen → Zielgruppenlisten. Wählen Sie die Liste im Targeting einer Kampagne mit der Regel Benutzerlisten.

Verwandte Themen

Did this page answer your question?
Thank you — that goes to whoever maintains this page.