Produktanalyse: Mixpanel, Amplitude und Segment

Senden Sie Produktereignisse aus dem CRM (z. B. "Deal gewonnen", "Lead erstellt") an Ihr Mixpanel, Amplitude oder Segment und empfangen Sie Ereignisse zurück als Aktivitäten beim Kontakt (BYO-Modell, das Konto gehört also Ihnen).

Die Integration Produktanalyse nutzt IHR Mixpanel-, Amplitude- oder Segment-Konto (BYO-Modell: Sie bringen Ihr eigenes Konto mit). Das CRM SENDET Produktereignisse an Ihre Analyseplattform (z. B. wenn ein Deal gewonnen oder ein Lead erstellt wird) und EMPFÄNGT Ereignisse zurück, die zu Aktivitäten beim entsprechenden Kontakt werden. Auf unserer Seite gibt es keine Kosten, Marge oder Vermittlung: Die Ereignisse gehen direkt an Ihr Konto und kommen von dort zurück.

Die Integration startet inaktiv: Nichts geschieht, bis Sie die Zugangsdaten eintragen und aktivieren. Alle Geheimnisse (Project Token, API-Schlüssel, Write Key) werden verschlüsselt im CRM gespeichert und nie wieder angezeigt. Jede Plattform hat ihre eigene Karte unter Einstellungen → Integrationen; die Webhook-URL ist eindeutig (/api/inbound/analytics/…), und das CRM erkennt anhand des URL-Tokens, um welche Plattform es sich handelt.

Voraussetzungen

• Ein Mixpanel-, Amplitude- oder Segment-Konto mit Zugriff auf die Ingestion-Zugangsdaten.
• Mixpanel: der Project Token (Settings → Project Settings). Amplitude: der Projekt-API-Key (Settings → Projects). Segment: der Write Key einer HTTP-API-Quelle (Connections → Sources).
• Um Ereignisse zurückzuerhalten, die Möglichkeit, einen Provider-Export/Webhook auf eine URL zeigen zu lassen.
• In Sellio Administratorzugriff, um die Zugangsdaten zu speichern und die Integration unter Einstellungen → Integrationen zu aktivieren.

Funktionsweise

• Ausgehend (CRM → Anbieter): Jedes Ereignis wird mit einem Personen-Identifikator (distinct id / user id, standardmäßig die E-Mail des Datensatzes) und Eigenschaften gesendet. Der Versand ist idempotent über den Dedup-Schlüssel des Anbieters: Mixpanel verwendet $insert_id, Amplitude verwendet insert_id und Segment verwendet messageId, sodass ein erneutes Senden desselben Ereignisses keine Duplikate erzeugt.
• Eingehend (Anbieter → CRM): Wenn der Anbieter ein Ereignis per POST an die Webhook-URL sendet, protokolliert das CRM eine Aktivität und verknüpft sie mit dem Kontakt mit der entsprechenden E-Mail. Existiert die E-Mail nicht im CRM, bleibt die Aktivität unverknüpft (nichts geht verloren).
• Der empfohlene Weg, Ereignisse zu senden, ist die Automatisierungsaktion "Ereignis senden (Analytics)" (siehe unten). Der Button "Testereignis senden" auf der Karte validiert die Konfiguration end-to-end.

Die Automatisierungsaktion "Ereignis senden (Analytics)"

Erstellen oder bearbeiten Sie unter Einstellungen → Automatisierungen eine Regel und fügen Sie die Aktion "Ereignis senden (Analytics)" hinzu. Wählen Sie den Anbieter (Mixpanel/Amplitude/Segment), den Ereignisnamen (z. B. "Deal won"; Sie können {{field}} verwenden, um Datensatzdaten einzufügen) und optional den Personen-Identifikator (distinct id, standardmäßig {{email}}). Wenn die Regel ausgelöst wird, wird das Ereignis post-commit, best-effort gesendet. Ist die Integration nicht aktiv, tut die Aktion einfach nichts (gated).

Mixpanel

1. Öffnen Sie Einstellungen → Integrationen und suchen Sie die Karte "Produktanalyse (Mixpanel)".
2. Fügen Sie den Project Token ein (Mixpanel → Settings → Project Settings → Project Token) und wählen Sie die Region (nur EU, falls Ihr Projekt europäische Datenresidenz verwendet). Klicken Sie auf "Analytics speichern".
3. Klicken Sie auf "Aktivieren". Verwenden Sie "Testereignis senden" mit einer beliebigen distinct id zur Bestätigung.
4. Um Ereignisse zu empfangen, lassen Sie einen Mixpanel-Webhook/Export auf die "Webhook-URL" zeigen. Mixpanel signiert Export-Webhooks nicht: Die Sicherheit liegt im unvorhersehbaren URL-Token, behandeln Sie ihn also als geheim.

Amplitude

1. Suchen Sie im CRM die Karte "Produktanalyse (Amplitude)".
2. Fügen Sie den API-Key ein (Amplitude → Settings → Projects → API Key) und wählen Sie die Region. Klicken Sie auf "Analytics speichern" und dann auf "Aktivieren".
3. Ausgehende Ereignisse gehen an /2/httpapi. Um Ereignisse zu empfangen, lassen Sie einen Amplitude-Export/Webhook auf die "Webhook-URL" zeigen (Amplitude signiert nicht: Der URL-Token ist die Absicherung).

Segment

1. Suchen Sie im CRM die Karte "Produktanalyse (Segment)".
2. Erstellen Sie eine HTTP-API-Quelle in Segment (Connections → Sources) und fügen Sie den Write Key ein. Optional legen Sie ein Webhook-Secret fest (um die Signatur bei eingehenden Ereignissen zu verlangen). Klicken Sie auf "Analytics speichern" und "Aktivieren".
3. Ausgehend: Ereignisse gehen an /v1/track, authentifiziert per Basic Auth des Write Key. Eingehend: Erstellen Sie in Segment ein Webhook-Ziel (oder eine Funktion), die auf die "Webhook-URL" zeigt. Standardmäßig signiert Segment nicht; wenn Sie ein Secret festlegen, prüft das CRM den Header x-signature (HMAC-SHA1); andernfalls ist der URL-Token die Absicherung.

Behandeln Sie die Webhook-URLs und die Zugangsdaten als geheim. Wenn Sie versuchen zu aktivieren, ohne die nötigen Zugangsdaten zu haben, bleibt die Integration inaktiv, und es wird nichts gesendet oder empfangen, bis alles vorhanden ist.

So testen Sie

1. Ausgehend: Klicken Sie auf der Karte auf "Testereignis senden" mit einer beliebigen distinct id und bestätigen Sie in Ihrem Mixpanel/Amplitude/Segment, dass das Ereignis angekommen ist (Live View / Debugger).
2. Automatisierung: Erstellen Sie eine Regel mit der Aktion "Ereignis senden (Analytics)" und lösen Sie sie aus; prüfen Sie das Ereignis beim Anbieter.
3. Eingehend: Lassen Sie den Anbieter ein Ereignis an die "Webhook-URL" für eine E-Mail senden, die als Kontakt existiert, und prüfen Sie die Aktivität beim Kontakt.

Fehlerbehebung

• Fehler 401/Ereignis erscheint nicht: falsche Zugangsdaten. Mixpanel → Project Token; Amplitude → API Key; Segment → Write Key (authentifiziert per Basic Auth). Fügen Sie die korrekten Zugangsdaten erneut ein.
• Falsche Region: Wenn Ihr Projekt EU-Datenresidenz verwendet, markieren Sie die Region EU. Andernfalls gehen die Ereignisse an den falschen Endpunkt und erscheinen nicht.
• Die Automatisierung sendet nicht: Die Aktion "Ereignis senden (Analytics)" ist gated: Ist die Integration nicht aktiv, passiert nichts. Aktivieren Sie die Integration und prüfen Sie den in der Aktion ausgewählten Anbieter.
• Eingehend wird nicht zur Aktivität: Existiert die E-Mail des Ereignisses nicht im CRM, bleibt die Aktivität unverknüpft (nichts geht verloren). Segment: Wenn Sie ein Secret festgelegt haben, validieren Sie den Header x-signature (HMAC-SHA1).
• 404 bei der Webhook-URL: Integration deaktiviert oder Token geändert. Reaktivieren Sie und kopieren Sie die URL erneut.

Open this article inside the system →