El Publicador de Clickstream le permite capturar eventos de comportamiento en tiempo real desde su sitio web o aplicación móvil — vistas de página, toques de botón, transiciones de pantalla y eventos personalizados — y enrutarlos directamente a un workflow de SurveyAnalytica. Cada evento llega como datos estructurados sobre los que las condiciones y acciones del workflow pueden actuar de inmediato.

Cómo funciona

Usted instala un SDK ligero en su aplicación o sitio. El SDK recopila eventos, los agrupa en lotes y los envía a un endpoint dedicado vinculado a un workflow. Ese workflow puede escribir eventos en una tabla de datos, actualizar un registro de contacto, activar una encuesta o ejecutar cualquier otra acción que usted configure.

Cada fuente (sitio web, app iOS, app Android) obtiene su propio workflow con su propia clave API y URL de endpoint, de modo que usted pueda controlar el enrutamiento de datos y el acceso de forma independiente.

Paso 1 — Crear un workflow de Clickstream

1. Vaya a Flows y haga clic en Create workflow.
2. Asigne un nombre al workflow (por ejemplo, Website Clickstream o iOS App Events).
3. Haga clic en el paso Trigger y elija Clickstream en la lista de tipos de disparador.

Paso 2 — Copiar su API Key y URL de Endpoint

Después de seleccionar el disparador Clickstream, el panel del disparador muestra:

• KEY — su clave API. El SDK la envía con cada solicitud para autenticarse.
• URL — el endpoint al que su SDK envía los eventos. Tiene un aspecto similar a https://<your-domain>/api/v1/clickstream/<workflow-id>.

Use los iconos de copiar junto a cada valor. Necesitará ambos al inicializar el SDK.

Haga clic en Generate New debajo de la KEY para rotar la clave API en cualquier momento. Después de rotarla, actualice la clave en la configuración de su SDK — la clave anterior deja de funcionar de inmediato.

Paso 3 — Instalar el SDK

Elija la guía correspondiente a su plataforma:

• Web SDK — para sitios web construidos con Vanilla JS, Next.js o React.
• Mobile SDKs — para React Native, Flutter, iOS (Swift) y Android (Kotlin).

Paso 4 — Configurar las acciones del workflow

Con el disparador activo, agregue acciones para gestionar los eventos entrantes. Un workflow de Clickstream típico incluye:

• Un bloque de Condition que verifica el tipo de evento (por ejemplo, eventType equals uid_transition) para separar los eventos de resolución de identidad de los eventos regulares.
• Una acción de Data para escribir cada evento como una nueva fila en una tabla de datos — use la plantilla de mapeo de campos de clickstream que aparece automáticamente al crear una nueva tabla dentro de un workflow de Clickstream.
• Una acción de Contact en la rama uid_transition para actualizar la lista de IDs anónimos del contacto, vinculando los eventos previos al inicio de sesión con el contacto conocido.

Tipos de evento

Tipo de evento	Cuándo se activa
event	Cualquier evento con nombre que usted rastree manualmente, incluidas las vistas de página automáticas (eventName: page_view).
uid_transition	Cuando un usuario inicia sesión y el SDK vincula su sesión anónima con su ID de contacto conocido.
consent_rejected	Cuando su aplicación llama a setConsent(false). El seguimiento se detiene y los IDs anónimos anteriores se eliminan.

Activar el workflow

Haga clic en Activate en el generador de workflows. El endpoint queda activo de inmediato. Los eventos enviados por el SDK antes de activar el workflow no se reciben — active el workflow antes de implementar el SDK para sus usuarios.