Wie integriere ich Stripe für Umsatztracking?

Wenn Sie Stripe verbinden, kann Zenovay Umsätze neben Ihren Traffic-Daten anzeigen — welche Marketing-Quelle den zahlenden Kunden gebracht hat, auf welcher Seite er konvertiert hat, welche Kampagne das Geschäft abgeschlossen hat.

Das Setup erfolgt pro Website innerhalb des Dashboards dieser Website. Es gibt eine Anmeldedaten zum Einfügen — einen eingeschränkten Stripe-API-Schlüssel — und Zenovay verwaltet die Webhook-Einrichtung für Sie.

Stripe verbinden

1. 1

   Öffnen Sie die Revenue-Einstellungen der Website

   Gehen Sie in app.zenovay.com zu der Website, die Sie verbinden möchten, wählen Sie Einstellungen und öffnen Sie die Registerkarte Revenue. Jede Stripe-Verbindung ist einer Zenovay-Website zugeordnet.

2. 2

   Wählen Sie Stripe

   Klicken Sie auf die Stripe-Karte. Sie sehen ein kurzes Setup-Formular.

3. 3

   Erstellen und fügen Sie einen eingeschränkten API-Schlüssel ein

   Zenovay verlinkt direkt zur Seite „Eingeschränkten Schlüssel erstellen" von Stripe mit den Leseberechtigung, die es benötigt (Guthaben, Zahlungen, Abos, Kunden, Zahlungsabsichten, Checkout-Sitzungen, Rechnungen) sowie Webhook-Schreibzugriff. Erstellen Sie den Schlüssel in Stripe, kopieren Sie ihn (er beginnt mit rk_live_… oder rk_test_…), fügen Sie ihn in das Feld ein und klicken Sie auf Verbinden.

4. 4

   Lassen Sie Zenovay die Einrichtung abschließen

   Wenn Sie den Schlüssel speichern, validiert Zenovay ihn gegen Stripe und erstellt automatisch den Webhook-Endpunkt in Ihrem Stripe-Konto, sodass Zahlungen ohne Ihr Zutun fließen. Die Karte zeigt Verbunden mit einem grünen Badge „Anmeldedaten überprüft" an.

Nach der Verbindung zeigt die Registerkarte Revenue auf Ihrem Dashboard MRR-, ARR-, Revenue-pro-Besucher- und Revenue-nach-Quelle-Diagramme. Der Umsatz wird ab dem Verbindungszeitpunkt erfasst — Zenovay erfasst Zahlungen, wenn Stripe die Webhook-Ereignisse sendet. Es wird keine älteren Stripe-Daten zurückimportiert.

Webhook manuell konfigurieren (optional)

Zenovay erstellt den Stripe-Webhook für Sie, daher benötigt dies die meisten Menschen nie. Wenn Sie den Webhook selbst einrichten möchten — zum Beispiel, weil Ihr Stripe-Schlüssel keine Webhook-Schreibberechtigung enthält — können Sie Stripe auf den Zenovay-Empfänger verweisen und das Signaturesgeheimnis zurückfügen.

1. Gehen Sie im Stripe Dashboard zu Developers → Webhooks → Add endpoint.
2. Endpunkt-URL: https://api.zenovay.com/api/webhooks/stripe/YOUR_WEBSITE_ID (Ihre Website-ID befindet sich in der Seiten-URL des Dashboards der Website).
3. Wählen Sie diese Ereignisse:
   • checkout.session.completed
   • payment_intent.succeeded
   • invoice.paid
   • customer.subscription.created
   • customer.subscription.updated
   • customer.subscription.deleted
4. Speichern Sie, dann kopieren Sie das Signaturesgeheimnis des Endpunkts (beginnt mit whsec_…).
5. Zurück in Zenovays Stripe-Formular (Registerkarte Revenue-Einstellungen) fügen Sie das Signaturesgeheimnis ein, damit Zenovay eingehende Ereignisse überprüfen kann.

Eine Zahlung einem Besucher zuordnen

Damit die Zuordnung Zahlung-zu-Traffic-Quelle funktioniert, muss die anonyme Zenovay-ID des Besuchers auf den Stripe-Datensatz gelangen. Am einfachsten ist es, sie als Checkout-Sitzung client_reference_id oder als Metadaten beim Checkout festzulegen:

// Auf Ihrem Checkout-Server
const visitorId = req.cookies['zv_visitor_id'] // oder wie Ihr Client sie übergibt
stripe.checkout.sessions.create({
  // ...
  client_reference_id: visitorId,
  metadata: { zenovay_visitor_id: visitorId }
})

Wenn die Zahlung abgeschlossen ist, liest der Webhook-Handler von Zenovay die client_reference_id (oder metadata.zenovay_visitor_id / metadata.visitor_id) und verknüpft die Zahlung mit der Sitzung des Besuchers — einschließlich der Quelle, der Kampagne und der Seiten, die er vor der Zahlung besucht hat. Zahlungen ohne eine Besucher-ID werden weiterhin als Umsatz erfasst, nur ohne Quellenattribution.

Welche Attributionsmodelle sind verfügbar

Zenovay berechnet mehrere Attributionsmodelle, damit Sie sehen können, wie sich die Gutschrift je nach den gewichteten Touchpoints verschiebt:

• Last Touch — Die Gutschrift geht an die Quelle in der Sitzung, in der die Zahlung stattgefunden hat.
• First Touch — Die Gutschrift geht an die Quelle, von der der Besucher ursprünglich kam.
• Linear — Gutschrift gleichmäßig über jeden Touchpoint auf dem Pfad verteilt.
• Position-Based — Gewichtet den ersten und letzten Touchpoint am stärksten.
• Time-Decay — Touchpoints näher an der Konvertierung erhalten mehr Gutschrift.

Wechseln Sie zwischen ihnen in der Revenue-Registerkarte, um zu vergleichen, wie jedes Modell die Gutschrift zuweist.

Trennen

Öffnen Sie in der Registerkarte Revenue-Einstellungen der Website die Stripe-Karte und klicken Sie auf Entfernen. Standardmäßig wird nur die Anmeldedaten getrennt — Ihre vorhandenen Zahlungsdatensätze bleiben für die Dauer Ihres Datenspeicherungsfensters im Dashboard. Wenn Sie auch die historischen Umsatzdaten löschen möchten, aktivieren Sie die Option für die kaskadierende Löschung im Bestätigungsdialog (es zeigt Ihnen genau, wie viele Datensätze gelöscht werden).

Das Entfernen der Integration in Zenovay löscht nicht den Webhook auf Stripe-Seite, daher möchten Sie möglicherweise auch den Endpunkt in Ihrem Stripe Dashboard entfernen.

Weiterführende Lektüre

• Webhooks-Übersicht
• E-Commerce-Umsatztracking
• API-Übersicht
• Tracking-Skript installieren