Mit dem Clickstream Publisher können Sie Echtzeit-Verhaltensereignisse von Ihrer Website oder mobilen App erfassen — Seitenaufrufe, Button-Klicks, Bildschirmübergänge und benutzerdefinierte Ereignisse — und direkt in einen SurveyAnalytica-Workflow leiten. Jedes Ereignis kommt als strukturierte Daten an, auf die Workflow-Bedingungen und -Aktionen sofort reagieren können.

So funktioniert es

Sie installieren ein schlankes SDK in Ihrer App oder Website. Das SDK sammelt Ereignisse, fasst sie zu Batches zusammen und sendet sie an einen dedizierten Endpunkt, der mit einem Workflow verknüpft ist. Dieser Workflow kann Ereignisse in eine Datentabelle schreiben, einen Kontaktdatensatz aktualisieren, eine Umfrage auslösen oder jede andere von Ihnen konfigurierte Aktion ausführen.

Jede Quelle (Website, iOS-App, Android-App) erhält ihren eigenen Workflow mit eigenem API-Schlüssel und eigener Endpunkt-URL, sodass Sie Datenrouting und Zugriff unabhängig voneinander steuern können.

Schritt 1 — Einen Clickstream-Workflow erstellen

1. Gehen Sie zu Flows und klicken Sie auf Workflow erstellen.
2. Benennen Sie den Workflow (zum Beispiel Website Clickstream oder iOS App Events).
3. Klicken Sie auf den Schritt Trigger und wählen Sie Clickstream aus der Liste der Trigger-Typen.

Schritt 2 — API-Schlüssel und Endpunkt-URL kopieren

Nach der Auswahl des Clickstream-Triggers zeigt die Trigger-Leiste Folgendes an:

• KEY — Ihr API-Schlüssel. Das SDK sendet ihn mit jeder Anfrage zur Authentifizierung.
• URL — der Endpunkt, an den Ihr SDK Ereignisse sendet. Er sieht folgendermaßen aus: https://<your-domain>/api/v1/clickstream/<workflow-id>.

Verwenden Sie die Kopiersymbole neben jedem Wert. Sie benötigen beides bei der Initialisierung des SDK.

Klicken Sie jederzeit auf Neu generieren unter KEY, um den API-Schlüssel zu rotieren. Aktualisieren Sie nach der Rotation den Schlüssel in Ihrer SDK-Konfiguration — der alte Schlüssel funktioniert sofort nicht mehr.

Schritt 3 — Das SDK installieren

Wählen Sie die Anleitung für Ihre Plattform:

• Web SDK — für Websites mit Vanilla JS, Next.js oder React.
• Mobile SDKs — für React Native, Flutter, iOS (Swift) und Android (Kotlin).

Schritt 4 — Workflow-Aktionen konfigurieren

Fügen Sie bei aktivem Trigger Aktionen hinzu, um die eingehenden Ereignisse zu verarbeiten. Ein typischer Clickstream-Workflow umfasst:

• Einen Condition-Block, der den Ereignistyp prüft (zum Beispiel eventType equals uid_transition), um Identitätsauflösungs-Ereignisse von regulären Ereignissen zu trennen.
• Eine Data-Aktion, um jedes Ereignis als neue Zeile in eine Datentabelle zu schreiben — verwenden Sie die Clickstream-Feldzuordnungsvorlage, die automatisch erscheint, wenn Sie innerhalb eines Clickstream-Workflows eine neue Tabelle erstellen.
• Eine Contact-Aktion im uid_transition-Zweig, um die Liste der anonymen IDs des Kontakts zu aktualisieren und so Ereignisse vor dem Login mit dem bekannten Kontakt zu verknüpfen.

Ereignistypen

Ereignistyp	Wann es ausgelöst wird
event	Jedes manuell erfasste benannte Ereignis, einschließlich automatischer Seitenaufrufe (eventName: page_view).
uid_transition	Wenn sich ein Nutzer anmeldet und das SDK seine anonyme Sitzung mit seiner bekannten Kontakt-ID verknüpft.
consent_rejected	Wenn Ihre App setConsent(false) aufruft. Das Tracking wird gestoppt und vorherige anonyme IDs werden gelöscht.

Den Workflow aktivieren

Klicken Sie im Workflow-Builder auf Aktivieren. Der Endpunkt ist sofort live. Ereignisse, die vom SDK vor der Aktivierung des Workflows gesendet werden, werden nicht empfangen — aktivieren Sie den Workflow, bevor Sie das SDK für Ihre Nutzer bereitstellen.