Qualaroo → server-side GA4: настраиваем custom tag template (и не ломаем first-party)

Qualaroo → server-side GA4: настраиваем custom tag template (и не ломаем first-party)

Если вы используете Qualaroo (опросы/виджеты) и хотите получать события в серверной аналитике, ключевой шаг — аккуратно «развернуть» их в единый событийный контракт для Google Analytics 4 (GA4). Ниже чек-лист по тому, как сделать это через custom tag template-подход: один раз определяете маппинг, дальше используете API и передаёте события в нужный endpoint.

— Создайте шаблон-тег под Qualaroo и зафиксируйте структуру события
Определите базовые поля: event_name, event_id (если есть), user_id (если применимо), session_id, timestamp, page_location, variant (если опрос по логике A/B). Шаблон должен быть единым для всех типов триггеров.

— Инициализируйте интеграцию в GA4 через “инициализатор” в шаблоне
Сделайте точку входа, которая формирует корректные настройки для отправки в GA4 (на уровне client-side или прокси-сервера — в зависимости от вашей архитектуры). Важно, чтобы события имели предсказуемые параметры, а не «полупустые» payload’ы.

— Подключите нужные JavaScript API Qualaroo и маппьте ответы в параметры
Используйте доступные API Qualaroo не «в лоб», а как источник фактов: показ опроса, отправка ответа, отмена, тайм-аут, метаданные виджета. Каждому факту — свой параметр в событии (например, survey_id, question_id, answer_value).

— Разведите события на жизненный цикл (не смешивайте показ и конверсию)
Отдельно заведите: qualaroo_view (опрос показан), qualaroo_start (пользователь начал), qualaroo_submit (ответ отправлен), qualaroo_dismiss (закрыт без ответа). Это позволит считать качество трафика и эффективность креативов без ложной атрибуции.

— Добавьте контроль уникальности и дедупликацию на сервере
Если Qualaroo может повторно триггерить события (перерисовки, навигация, повторный показ), сгенерируйте event_id и/или используйте составной ключ (survey_id + action + timestamp window). На серверной стороне — дедупликация перед отправкой в GA4/событийное хранилище.

— Привяжите события к first-party идентификаторам и храните согласия
Убедитесь, что user_id/anonymous_id формируются в вашей системе так, чтобы Qualaroo-события соблюдали consent-режим. Если consent нет — отправляйте только обезличенные метрики или пропускайте персональные параметры.

— Завершите валидацией: проверьте, что параметры читаются одинаково во всех потоках
Сделайте контрольный прогон: один и тот же опрос → одинаковые event_name и набор параметров в каждом сценарии (view/start/submit/dismiss). Это экономит часы, когда в отчетах “что-то есть”, но сегменты не собираются.

когда это пригодится — при переносе Qualaroo-опросов в server-side аналитику и приведении событий к единому contract для GA4.

— @ServerSideTrackingRuPro