Clickstream Publisher позволяет фиксировать поведенческие события в реальном времени с вашего сайта или мобильного приложения — просмотры страниц, нажатия кнопок, переходы между экранами и пользовательские события — и направлять их напрямую в workflow SurveyAnalytica. Каждое событие поступает как структурированные данные, на которые условия и действия workflow могут реагировать немедленно.

Как это работает

Вы устанавливаете лёгкий SDK в своём приложении или на сайте. SDK собирает события, группирует их в пакеты и отправляет на выделенный эндпоинт, привязанный к одному workflow. Этот workflow может записывать события в таблицу данных, обновлять запись контакта, запускать опрос или выполнять любое другое настроенное вами действие.

Каждый источник (веб-сайт, iOS-приложение, Android-приложение) получает собственный workflow с собственным API-ключом и URL эндпоинта, что позволяет независимо управлять маршрутизацией данных и доступом.

Шаг 1 — Создайте workflow Clickstream

1. Перейдите в раздел Flows и нажмите Create workflow.
2. Назовите workflow (например, Website Clickstream или iOS App Events).
3. Нажмите на шаг Trigger и выберите Clickstream в списке типов триггеров.

Шаг 2 — Скопируйте API-ключ и URL эндпоинта

После выбора триггера Clickstream в панели триггера отображаются:

• KEY — ваш API-ключ. SDK отправляет его с каждым запросом для аутентификации.
• URL — эндпоинт, на который ваш SDK отправляет события. Он выглядит так: https://<your-domain>/api/v1/clickstream/<workflow-id>.

Используйте значки копирования рядом с каждым значением. Оба значения понадобятся вам при инициализации SDK.

Нажмите Generate New под KEY, чтобы в любой момент обновить API-ключ. После обновления замените ключ в конфигурации SDK — старый ключ перестаёт работать немедленно.

Шаг 3 — Установите SDK

Выберите руководство для вашей платформы:

• Web SDK — для сайтов, созданных на Vanilla JS, Next.js или React.
• Mobile SDKs — для React Native, Flutter, iOS (Swift) и Android (Kotlin).

Шаг 4 — Настройте действия workflow

После активации триггера добавьте действия для обработки входящих событий. Типичный workflow Clickstream включает:

• Блок Condition, который проверяет тип события (например, eventType equals uid_transition), чтобы отделить события разрешения идентичности от обычных событий.
• Действие Data для записи каждого события в виде новой строки в таблице данных — используйте шаблон сопоставления полей clickstream, который автоматически появляется при создании новой таблицы внутри workflow Clickstream.
• Действие Contact в ветке uid_transition для обновления списка анонимных ID контакта, связывающего события до входа в систему с известным контактом.

Типы событий

Тип события	Когда возникает
event	Любое именованное событие, которое вы отслеживаете вручную, включая автоматические просмотры страниц (eventName: page_view).
uid_transition	Когда пользователь входит в систему и SDK связывает его анонимную сессию с известным ID контакта.
consent_rejected	Когда ваше приложение вызывает setConsent(false). Отслеживание останавливается, а прежние анонимные ID удаляются.

Активация workflow

Нажмите Activate в конструкторе workflow. Эндпоинт становится активным немедленно. События, отправленные SDK до активации workflow, не принимаются — активируйте workflow перед развёртыванием SDK у ваших пользователей.