Il Clickstream Publisher consente di acquisire eventi comportamentali in tempo reale dal tuo sito web o dalla tua app mobile — visualizzazioni di pagina, tap sui pulsanti, transizioni tra schermate ed eventi personalizzati — e instradarli direttamente in un workflow di SurveyAnalytica. Ogni evento arriva come dato strutturato su cui le condizioni e le azioni del workflow possono agire immediatamente.

Come funziona

Installi un SDK leggero nella tua app o sul tuo sito. L’SDK raccoglie gli eventi, li raggruppa in batch e li invia a un endpoint dedicato collegato a un workflow. Quel workflow può scrivere gli eventi in una tabella dati, aggiornare un record di contatto, attivare un sondaggio o eseguire qualsiasi altra azione tu configuri.

Ogni sorgente (sito web, app iOS, app Android) ottiene il proprio workflow con la propria chiave API e URL dell’endpoint, così puoi controllare l’instradamento e l’accesso ai dati in modo indipendente.

Passo 1 — Crea un workflow Clickstream

1. Vai su Flows e clicca su Create workflow.
2. Assegna un nome al workflow (per esempio, Website Clickstream o iOS App Events).
3. Clicca sul passaggio Trigger e scegli Clickstream dall’elenco dei tipi di trigger.

Passo 2 — Copia la tua chiave API e l’URL dell’endpoint

Dopo aver selezionato il trigger Clickstream, il pannello del trigger mostra:

• KEY — la tua chiave API. L’SDK la invia con ogni richiesta per autenticarsi.
• URL — l’endpoint a cui il tuo SDK invia gli eventi. Ha un formato simile a https://<your-domain>/api/v1/clickstream/<workflow-id>.

Usa le icone di copia accanto a ciascun valore. Ti serviranno entrambi quando inizializzi l’SDK.

Clicca su Generate New sotto la KEY per ruotare la chiave API in qualsiasi momento. Dopo la rotazione, aggiorna la chiave nella configurazione del tuo SDK — la vecchia chiave smette di funzionare immediatamente.

Passo 3 — Installa l’SDK

Scegli la guida per la tua piattaforma:

• Web SDK — per siti web realizzati con Vanilla JS, Next.js o React.
• Mobile SDKs — per React Native, Flutter, iOS (Swift) e Android (Kotlin).

Passo 4 — Configura le azioni del workflow

Con il trigger attivo, aggiungi azioni per gestire gli eventi in arrivo. Un tipico workflow Clickstream include:

• Un blocco Condition che verifica il tipo di evento (per esempio, eventType equals uid_transition) per separare gli eventi di risoluzione dell’identità dagli eventi regolari.
• Un’azione Data per scrivere ogni evento come nuova riga in una tabella dati — usa il template di mappatura dei campi clickstream che appare automaticamente quando crei una nuova tabella all’interno di un workflow Clickstream.
• Un’azione Contact sul ramo uid_transition per aggiornare l’elenco degli ID anonimi del contatto, collegando gli eventi pre-login al contatto conosciuto.

Tipi di evento

Tipo di evento	Quando si attiva
event	Qualsiasi evento denominato che tracci manualmente, incluse le visualizzazioni di pagina automatiche (eventName: page_view).
uid_transition	Quando un utente accede e l’SDK collega la sua sessione anonima al suo ID contatto conosciuto.
consent_rejected	Quando la tua app chiama setConsent(false). Il tracciamento si interrompe e gli ID anonimi precedenti vengono cancellati.

Attivazione del workflow

Clicca su Activate nel workflow builder. L’endpoint diventa attivo immediatamente. Gli eventi inviati dall’SDK prima dell’attivazione del workflow non vengono ricevuti — attiva il workflow prima di distribuire l’SDK ai tuoi utenti.