Le Clickstream Publisher vous permet de capturer en temps réel les événements comportementaux de votre site web ou application mobile — vues de page, clics sur bouton, transitions d’écran et événements personnalisés — et de les acheminer directement vers un workflow SurveyAnalytica. Chaque événement arrive sous forme de données structurées sur lesquelles les conditions et actions du workflow peuvent agir immédiatement.

Fonctionnement

Vous installez un SDK léger dans votre application ou votre site. Le SDK collecte les événements, les regroupe en lots, puis les envoie à un endpoint dédié rattaché à un workflow. Ce workflow peut écrire les événements dans une table de données, mettre à jour une fiche contact, déclencher une enquête, ou exécuter toute autre action que vous configurez.

Chaque source (site web, application iOS, application Android) dispose de son propre workflow avec sa propre clé API et son propre endpoint, ce qui vous permet de contrôler indépendamment le routage et l’accès aux données.

Étape 1 — Créer un workflow Clickstream

1. Accédez à Flows et cliquez sur Create workflow.
2. Nommez le workflow (par exemple, Website Clickstream ou iOS App Events).
3. Cliquez sur l’étape Trigger et choisissez Clickstream dans la liste des types de déclencheur.

Étape 2 — Copier votre clé API et l’URL de l’endpoint

Après avoir sélectionné le déclencheur Clickstream, le panneau du déclencheur affiche :

• KEY — votre clé API. Le SDK l’envoie avec chaque requête pour s’authentifier.
• URL — l’endpoint auquel votre SDK envoie les événements. Elle ressemble à https://<your-domain>/api/v1/clickstream/<workflow-id>.

Utilisez les icônes de copie situées à côté de chaque valeur. Vous aurez besoin des deux lors de l’initialisation du SDK.

Cliquez sur Generate New sous la KEY pour faire tourner la clé API à tout moment. Après la rotation, mettez à jour la clé dans la configuration de votre SDK — l’ancienne clé cesse de fonctionner immédiatement.

Étape 3 — Installer le SDK

Choisissez le guide correspondant à votre plateforme :

• Web SDK — pour les sites web développés avec Vanilla JS, Next.js ou React.
• Mobile SDKs — pour React Native, Flutter, iOS (Swift) et Android (Kotlin).

Étape 4 — Configurer les actions du workflow

Une fois le déclencheur activé, ajoutez des actions pour traiter les événements entrants. Un workflow Clickstream typique comprend :

• Un bloc Condition qui vérifie le type d’événement (par exemple, eventType equals uid_transition) afin de séparer les événements de résolution d’identité des événements standards.
• Une action Data pour écrire chaque événement sous forme de nouvelle ligne dans une table de données — utilisez le modèle de mappage de champs clickstream qui apparaît automatiquement lorsque vous créez une nouvelle table au sein d’un workflow Clickstream.
• Une action Contact sur la branche uid_transition pour mettre à jour la liste des identifiants anonymes du contact, reliant ainsi les événements pré-connexion au contact connu.

Types d’événements

Type d’événement	Quand il se déclenche
event	Tout événement nommé que vous suivez manuellement, y compris les vues de page automatiques (eventName: page_view).
uid_transition	Lorsqu’un utilisateur se connecte et que le SDK relie sa session anonyme à son identifiant de contact connu.
consent_rejected	Lorsque votre application appelle setConsent(false). Le suivi s’arrête et les identifiants anonymes précédents sont effacés.

Activer le workflow

Cliquez sur Activate dans le générateur de workflow. L’endpoint devient actif immédiatement. Les événements envoyés par le SDK avant l’activation du workflow ne sont pas reçus — activez le workflow avant de déployer le SDK auprès de vos utilisateurs.